⚙️ Config
Configuration File
To configure Sherlo, create a sherlo.config.json
file at the root of your project
sherlo.config.json
{
"token": "PROJECT_TOKEN", // "Qak6POAjBpoNhnS9RKqP_wR4Mt_2lnVLLTDyu0Ha1"
"android": "BUILD_PATH", // "builds/simulator/preview/android.apk"
"ios": "BUILD_PATH", // "builds/simulator/preview/ios.tar.gz"
"devices": [
{
"id": "DEVICE_ID", // "iphone.15.pro"
"osVersion": "OS_VERSION", // "17"
"osTheme": "OPTIONAL_OS_THEME", // "light"
"osLocale": "OPTIONAL_OS_LOCALE" // "en_US"
}
]
}
Properties
CLI Options
note
Properties marked with * can be set via CLI options in Sherlo Command:
token
→--token
android
→--android
ios
→--ios
Token*
The token
is a unique key that authenticates your project with Sherlo
info
To get a token, create a new project or reset your current project's token in the Sherlo web application
sherlo.config.json
{
"token": "PROJECT_TOKEN", // "Qak6POAjBpoNhnS9RKqP_wR4Mt_2lnVLLTDyu0Ha1"
// ...
}
Android*
The android
property specifies the path to the Android build
sherlo.config.json
{
"android": "BUILD_PATH" // "builds/simulator/preview/android.apk"
// ...
}
Accepts
.apk
file formatnote
Skip when using Expo Cloud Builds command - Sherlo will get it automatically
iOS*
The ios
property specifies the path to the iOS build
sherlo.config.json
{
"ios": "BUILD_PATH" // "builds/simulator/preview/ios.tar.gz"
// ...
}
Accepts
.app
, or .tar.gz
/ .tar
file format (as produced by Expo)note
Skip when using Expo Cloud Builds command - Sherlo will get it automatically
Devices
The devices
array specifies the configurations for testing devices
Each device includes:
id
- unique device identifierosVersion
- operating system versionosTheme
(default: light) - operating system theme (light or dark)osLocale
(default: en_US) - operating system locale (language_COUNTRY format)
info
Refer to the Devices page for a list of valid id
and osVersion
values
sherlo.config.json
{
"devices": [
{
"id": "DEVICE_ID", // "iphone.15.pro"
"osVersion": "OS_VERSION", // "17"
"osTheme": "OPTIONAL_OS_THEME", // "light"
"osLocale": "OPTIONAL_OS_LOCALE" // "en_US"
},
// ...
],
// ...
}