npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@config-plugins/detox

v8.0.0

Published

Config plugin to auto configure detox on prebuild

Downloads

133,168

Readme

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!

| 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'..

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