Skip to content

Latest commit

 

History

History
46 lines (29 loc) · 2.4 KB

RunningOnDeviceIOS.md

File metadata and controls

46 lines (29 loc) · 2.4 KB
Raw
id title layout category permalink next previous
running-on-device-ios
Running On Device
docs
Guides (iOS)
docs/running-on-device-ios.html
running-on-simulator-ios
linking-libraries-ios

Running an iOS app on a device requires an Apple Developer account and provisioning your iPhone. This guide covers only React Native specific topics.

Accessing the development server from device

You can iterate quickly on device using the development server. First, ensure that you are on the same Wi-Fi network as your computer.

In Xcode, select your phone as build target and press "Build and run"

Hint

Shake the device to open the developer menu.

Building your app for production

You have built a great app using React Native, and you are now itching to release it in the App Store. The process is the same as any other native iOS app, with some additional considerations to take into account.

Disabling the developer menu

Building an app for distribution in the App Store requires using the Release scheme in Xcode. Apps built for Release will automatically disable the in-app developer menu. This will prevent your users from inadvertently accessing the menu in production.

Using the offline bundle

Set up your app to load your JavaScript, images, and other static assets from its resource bundle rather than the development server. This way you can test the app independently of the development server, and will allow you to distribute the app to beta testers and submit the app to the App Store.

  1. Open ios/YourApp/AppDelegate.m
  2. Uncomment the line, jsCodeLocation = [[NSBundle mainBundle] ...

App Transport Security

App Transport Security is a security feature, added in iOS 9, that rejects all HTTP requests that are not sent over HTTPS. This can result in HTTP traffic being blocked, including the developer React Native server.

ATS is disabled by default in projects generated using the React Native CLI in order to make development easier. You should re-enable ATS prior to building your app for production by removing the NSAllowsArbitraryLoads entry from your Info.plist file in the ios/ folder.

To learn more about how to configure ATS on your own Xcode projects, see this post on ATS.