kylefang/react-native
1
0
Fork 0
mirror of https://github.com/zhigang1992/react-native.git synced 2026-02-06 22:44:22 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
42eb5464fd8a65ed84b799de5d4dc225349449be
react-native/docs/GettingStarted.md
Martin Konicek 42eb5464fd Release React Native for Android 
This is an early release and there are several things that are known
not to work if you're porting your iOS app to Android.

See the Known Issues guide on the website.

We will work with the community to reach platform parity with iOS.
2015-09-14 18:13:39 +01:00

3.1 KiB
Raw Blame History

id, title, layout, category, permalink, next
id title layout category permalink next
getting-started Getting Started docs Quick Start docs/getting-started.html android-setup

Requirements

  1. OS X - Only OS X is currently supported
  2. Homebrew is the recommended way to install io.js, watchman, and flow.
  3. Install io.js 1.0 or newer. io.js is the modern version of Node.
  • Install nvm with its setup instructions here. Then run nvm install iojs-v2 && nvm alias default iojs-v2, which installs the latest compatible version of io.js and sets up your terminal so that typing node runs io.js. With nvm you can install multiple versions of Node and io.js and easily switch between them.
  • New to npm?
  1. brew install watchman. We recommend installing watchman, otherwise you might hit a node file watching bug.
  2. brew install flow. If you want to use flow.

We recommend periodically running brew update && brew upgrade to keep your programs up-to-date.

iOS Setup

Xcode 6.3 or higher is required. It can be installed from the App Store.

Android Setup

To write React Native apps for Android, you will need to install the Android SDK (and an Android emulator if you want to work on your app without having to use a physical device). See Android setup guide for instructions on how to set up your Android environment.

Quick start

$ npm install -g react-native-cli
$ react-native init AwesomeProject
$ cd AwesomeProject/

To run the iOS app:

  • Open ios/AwesomeProject.xcodeproj and hit run in Xcode.
  • Open index.ios.js in your text editor of choice and edit some lines.
  • Hit ⌘-R in your iOS simulator to reload the app and see your change!

To run the Android app:

  • $ react-native run-android

  • Open index.android.js in your text editor of choice and edit some lines.

  • Press the menu button (F2 by default, or ⌘-M in Genymotion) and select Reload JS to see your change!

  • Run adb logcat *:S ReactNative:V ReactNativeJS:V in a terminal to see your app's logs

  • $ react-native run-android

  • Open index.android.js in your text editor of choice and edit some lines.

  • Press the menu button (F2 by default, or ⌘-M in Genymotion) and select Reload JS to see your change!

  • Run adb logcat *:S ReactNative:V ReactNativeJS:V in a terminal to see your app's logs

Congratulations! You've successfully run and modified your first React Native app.

If you run into any issues getting started, see the troubleshooting page.

Adding Android to an existing React Native project

If you already have a (iOS-only) React Native project and want to add Android support, you need to execute the following commands in your existing project directory:

  1. Update the react-native dependency in your package.json file to the latest version
  2. $ npm install
  3. $ react-native android