JSPM

  • Created
  • Published
  • Downloads 1580
  • Score
    100M100P100Q117343F
  • License MIT

Helps to manage React Native XCode projects that use multiple schemes to manage things like environment variables.

Package Exports

  • react-native-schemes-manager

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-native-schemes-manager) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

React Native Schemes Manager

XCode environments without the stress. Use XCode schemes with React Native without pulling your hair out.

Supported by Thinkmill

If your app has multiple environments, you'd probably like to be able to manage these the way native developers have been doing for years, XCode schemes and build configurations.

By default, React Native doesn't handle these particularly well, and the ability to launch dev tools or run in debug mode is impacted. This package fixes these problems.

Made by Kevin Brown, supported by Thinkmill. Thank you for making this project possible!

Installation

yarn add --dev react-native-schemes-manager

or

npm install --save-dev react-native-schemes-manager

Once the package is installed in your project, you just need to configure it by adding a schemes section to your package.json:

{
  "name": "your-awesome-app",
  "version": "1.0.0",
  "schemes": {
      "Debug": ["Staging", "Preflight"]
  }
}

This configuration will copy the "Debug" build configuration to "Staging" and "Preflight" build configurations in all your dependent library projects.

What Then?

The package will automatically run this script to do two things on postinstall:

  • Swap its own version of react-native-xcode.sh in instead of the stock on that assumes all debug schemes are named 'Debug'.
  • Add your build configurations to all library xcode projects.

This means you shouldn't need to do anything further to make this work than the above.

When you want to fix up your xcode projects or script, yarn or npm i after removing your node_modules directory should re-run both scripts automatically.

It's not working!

A good starting point for troubleshooting is:

  • Completely quit XCode.
  • rm -rf node_modules
  • yarn or npm i
  • Re open XCode
  • Product -> Clean
  • Run

If you're still having trouble, post an issue so we can look into it.

Running Manually

You can run the two parts of this package on demand by running either:

  • react-native-schemes-manager fix-libraries: Adds your build configurations to all library xcode projects.
  • react-native-schemes-manager fix-script: Swaps a schemes aware build script in instead of the stock react native one.

The best way to do this is add to your package.json scripts section like so:

{
  "name": "your-awesome-app",
  "version": "1.0.0",
  "scripts": {
      "fix-libraries": "react-native-schemes-manager fix-libraries",
      "fix-script": "react-native-schemes-manager fix-script"
  }
}

You can then yarn run fix-libraries or npm run fix-libraries which will run the script.

Further Reading

These are some great articles about related topics in case you're hungry for more:

License

Licensed under the MIT License, Copyright © 2017 Kevin Brown.

See LICENSE for more information.

Acknowledgements

This project builds on a lot of earlier work by clever folks all around the world. We'd like to thank Alek Hurst and Craig Edwards who contributed ideas and inspiration, without which this project woudln't have been possible.