Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@config-plugins/detox

Package Overview
Dependencies
Maintainers
1
Versions
17
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@config-plugins/detox

Config plugin to auto configure detox on prebuild

  • 9.0.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
0
Maintainers
1
Weekly downloads
 
Created
Source

config-plugins/detox

Config plugin to auto-configure Detox when the native code is generated (npx expo prebuild).

Versioning

Ensure you use versions that work together!

expodetox@config-plugins/detox
52.0.020.28.0^9.0.0
51.0.020.20.3^8.0.0
50.0.020.17.0^7.0.0
49.0.020.11.0^6.0.0
48.0.020.5.0^5.0.0
47.0.019.13.0^4.0.0
46.0.019.9.0^3.0.0
45.0.019.6.9^2.0.0
44.0.019.1.0^1.1.0
43.0.019.1.0~1.0.0
40.0.018.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'..

Add the package to your npm dependencies

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.

🚀 How to use

  • Install with yarn or npm install
    • Install iOS packages: npx pod-install
  • Run yarn e2e:ios to build and test the iOS app on a simulator (macOS only).
    • This combines yarn build:ios and yarn test:ios.
    • You can run yarn test:ios --watch after building to keep the tests in watch mode.
  • Run yarn e2e:android to build and test the Android app on a Google emulator (Genymotion requires extra config).
    • This combines yarn build:android and yarn test:android.
    • You can run yarn test:android --watch after building to keep the tests in watch mode.
  • Run yarn e2e:android-release to build and test the Android app in release mode.

Recreate this example

  • 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

API

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 the app/build.gradle. Defaults to false.
  • 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"],
      },
    ],
  ],
};

FAQ

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.

yarn e2e:android failed

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"],
      },
    ],
  ],
};

📝 Notes

Keywords

FAQs

Package last updated on 03 Dec 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc