Config plugin to auto-configure Detox when the native code is generated (npx expo prebuild
).
Ensure you use versions that work together!
expo |
detox |
@config-plugins/detox |
---|---|---|
51.0.0 | 20.20.3 | ^8.0.0 |
50.0.0 | 20.17.0 | ^7.0.0 |
49.0.0 | 20.11.0 | ^6.0.0 |
48.0.0 | 20.5.0 | ^5.0.0 |
47.0.0 | 19.13.0 | ^4.0.0 |
46.0.0 | 19.9.0 | ^3.0.0 |
45.0.0 | 19.6.9 | ^2.0.0 |
44.0.0 | 19.1.0 | ^1.1.0 |
43.0.0 | 19.1.0 | ~1.0.0 |
40.0.0 | 18.6.2 | ~0.0.0 |
Most notably, the minimum required Kotlin version changed from 1.3.50
in SDK 40 to 1.4.21
in SDK 43. Failure to use the correct versioning could result in Android build errors like Execution failed for task ':react-native-screens:compileDebugKotlin'.
or Execution failed for task ':expo:compileDebugKotlin'.
.
First install the package with yarn, npm, or npx expo install
.
npx expo install detox @config-plugins/detox
Detox is an end-to-end (e2e) testing library for iOS and Android. You can use it to automate usage of your native project. This example demonstrates how to use Detox and Jest in a native project that you build locally.
- Install with
yarn
ornpm install
- Install iOS packages:
npx pod-install
- Install iOS packages:
- Run
yarn e2e:ios
to build and test the iOS app on a simulator (macOS only).- This combines
yarn build:ios
andyarn test:ios
. - You can run
yarn test:ios --watch
after building to keep the tests in watch mode.
- This combines
- Run
yarn e2e:android
to build and test the Android app on a Google emulator (Genymotion requires extra config).- This combines
yarn build:android
andyarn test:android
. - You can run
yarn test:android --watch
after building to keep the tests in watch mode.
- This combines
- Run
yarn e2e:android-release
to build and test the Android app in release mode.
-
npx create-react-native-app -t blank
-
cd
into the project
-
- Install packages:
yarn add -D detox @config-plugins/detox @babel/core @babel/runtime @types/jest babel-jest jest jest-circus ts-jest
- touch
tsconfig.json
- Run
expo start
to ensure TS is setup correctly.
- Add the following plugin to your
app.json
plugins array (before prebuilding). This'll automatically configure the Android native code to support Detox:{ "plugins": ["@config-plugins/detox"] }
- Generate the native code
npx expo prebuild
- Run
yarn detox init -r jest
The plugin provides props for extra customization. Every time you change the props or plugins, you'll need to rebuild (and prebuild
) the native app. If no extra properties are added, defaults will be used.
-
skipProguard
(boolean): Disable adding proguard minification to theapp/build.gradle
. Defaults tofalse
. -
subdomains
(string[] | '*'): Hostnames to add to the network security config. Pass'*'
to allow all domains. Defaults to['10.0.2.2', 'localhost']
.
app.config.js
export default {
plugins: [
[
"@config-plugins/detox",
{
skipProguard: false,
subdomains: ["10.0.2.2", "localhost"],
},
],
],
};
If the following commands fail, you can get better debug info by running a subset command:
-
yarn e2e:ios
:yarn ios
(builds the iOS app). xcodebuild compile errors may show in a more helpful format (using xcpretty). -
yarn e2e:android
:yarn android
(builds the Android app). Android compile errors may show in a more helpful format.
If you get the error:
detox[98696] ERROR: DetoxRuntimeError: Cannot boot Android Emulator with the name: 'Pixel_API_28'
HINT: Make sure you choose one of the available emulators: Pixel_3_API_30,Pixel_6_Pro_API_33,Pixel_C_API_30
Be sure to change the first emulator name (in my case "Pixel_API_28") with one of the suggested emulators (in my case Pixel_3_API_30, Pixel_6_Pro_API_33, Pixel_C_API_30), in the detox.config.js
file under devices.emulator.device.avdName
. More emulators can be created in Android Studio.
If you get the error:
Error: app binary not found at '/Users/.../with-detox/android/app/build/outputs/apk/debug/app-debug.apk', did you build it
It means the build step failed, ensure running yarn android
, and yarn build:android
works before trying yarn e2e:android
again.
If you get the error:
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
Be sure to disable any proxies running on your computer that may be blocking requests (i.e. Charles Proxy). You may need to run yarn clean:android
before attempting to build again.
If you get the error:
CLEARTEXT communication to [some host] not permitted by network security policy
This means you're attempting to connecting over plain HTTP (not HTTPS) to a host that isn't in your subdomains
settings (defaults to ['10.0.2.2', 'localhost']
). Set your subdomain settings appropriately. For example, if you're building Detox into a dev-client, you'll want to make sure you can connect to your Metro server:
module.exports = {
plugins: [
[
"@config-plugins/detox",
{
subdomains:
process.env.EAS_BUILD_PROFILE === "development"
? "*"
: ["10.0.2.2", "localhost"],
},
],
],
};