status-im
/
react-native
mirror of https://github.com/status-im/react-native.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
react-native/docs/DevelopmentSetupAndroid.md

55 lines
2.3 KiB
Markdown
Raw Normal View History

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 14:35:58 +00:00
---
id: android-setup
title: Android Setup
layout: docs
category: Quick Start
permalink: docs/android-setup.html
next: tutorial
---
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
__NOTE__: This guide needs to be extended for Windows. Can you send us a pull request?
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 14:35:58 +00:00
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
This guide describes basic steps of the Android development environment setup that are required to run React Native android apps on an android emulator. We don't discuss developer tool configuration such as IDEs here.
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 14:35:58 +00:00
Update DevelopmentSetupAndroid.md
2015-10-20 10:35:48 +00:00
### If you already have the Android SDK
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 14:35:58 +00:00
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
1. __IMPORTANT__: Make sure the `ANDROID_HOME` environment variable points to your existing Android SDK
2. Make sure to update the required packages to the versions mentioned below (see screenshots)
### If you don't have the Android SDK
1. [Install the latest JDK](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
2. Install the Android SDK with `brew install android-sdk`
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 14:35:58 +00:00
3. Add this to your `~/.bashrc`, `~/.zshrc` or whatever your shell uses:
export ANDROID_HOME=/usr/local/opt/android-sdk
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
### Configure your SDK
1. Start a new shell and run `android`; in the window that appears make sure you check:
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 14:35:58 +00:00
* Android SDK Build-tools version 23.0.1
* Android 6.0 (API 23)
* Android Support Repository
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
2. Click "Install Packages"
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 14:35:58 +00:00
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
![SDK Manager window](/react-native/img/AndroidSDK1.png) ![SDK Manager window](/react-native/img/AndroidSDK2.png)
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 14:35:58 +00:00
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
### Install Genymotion
Update DevelopmentSetupAndroid.md
2015-10-20 10:35:48 +00:00
Genymotion is much easier to set up than stock Google emulators. However, it's only free for personal use. If you want to use the stock Google emulator, see below.
[docs] Simplify Android setup instructions
2015-10-17 19:32:16 +00:00
1. Download and install [Genymotion](https://www.genymotion.com/)
2. Open Genymotion
3. Create a new emulator and start it
Update DevelopmentSetupAndroid.md
2015-10-20 10:35:48 +00:00
### Alternative: Create a stock Google emulator
1. Start a new shell and run `android`; in the window that appears make sure you check:
* Intel x86 Atom System Image (for Android 5.1.1 - API 22)
* Intel x86 Emulator Accelerator (HAXM installer)
2. Click "Install Packages".
3. [Configure hardware acceleration (HAXM)](http://developer.android.com/tools/devices/emulator.html#vm-mac), otherwise the emulator is going to be slow.
4. Create an Android Virtual Device (AVD):
1. Run `android avd` and click on **Create...**
![Create AVD dialog](/react-native/img/CreateAVD.png)
2. With the new AVD selected, click `Start...`