stigi / react-native-launch-arguments

Get launch arguments for testing with Detox and Appium

react-native-launch-arguments

React Native module to get launch arguments. Make passing parameters from testing tool to react native super easy.

Mostly it's made for using

• launchArgs parameter of device.launchApp method of Detox
• optionalIntentArguments (Android) and processArguments (iOS) parameters with Appium

  capabilities: {
    optionalIntentArguments: `--ez myBool true --es myStr 'string text'`, // Android
    processArguments: {args : ['-myBool', 'true','-myStr', 'string text']}, // iOS
  }

iOS: it takes data from [[NSProcessInfo processInfo] arguments]

Android: it takes data from currentActivity.getIntent().getBundleExtra("launchArgs") for detox and intent.getExtras() for ADB params

Getting started

npm i react-native-launch-arguments
cd ios && pod install && cd ..

Usage

In JS:

import { LaunchArguments } from "react-native-launch-arguments";
LaunchArguments.value();

In TS:

import { LaunchArguments } from "react-native-launch-arguments";
interface MyExpectedArgs {
  authToken?: string;
  skipAuth?: boolean;
}
LaunchArguments.value<MyExpectedArgs>();

Verifying install

To launch the app with arguments, verifying your install, you can:

iPhone simulator

You can use xcrun to boot your app on the simulator.

The following command-line will load your app on the booted iOS simulator. Just replace com.MyAppBundleId with your Bundle Identifier, and the params with your params.

xcrun simctl launch booted com.MyAppBundleId -noParams -param "hello"