diff --git a/docs/android-setup.html b/docs/android-setup.html index d2021043bf2..e8dfbffc956 100644 --- a/docs/android-setup.html +++ b/docs/android-setup.html @@ -1,4 +1,5 @@ -Android Setup – React Native | A framework for building native apps using React
React Native

Quick Start

Guides

Guides (iOS)

Guides (Android)

components

apis

Polyfills

Android Setup

NOTE: This guide needs to be extended for Windows. Can you send us a pull request?

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.

If already have the Android SDK #

  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
  2. Install the Android SDK with brew install android-sdk
  3. Add this to your ~/.bashrc, ~/.zshrc or whatever your shell uses:
    export ANDROID_HOME=/usr/local/opt/android-sdk

Configure your SDK #

  1. Start a new shell and run android; in the window that appears make sure you check:
    • Android SDK Build-tools version 23.0.1
    • Android 6.0 (API 23)
    • Android Support Repository
  2. Click "Install Packages"

SDK Manager window SDK Manager window

Install Genymotion #

  1. Download and install Genymotion
  2. Open Genymotion
  3. Create a new emulator and start it
Next →
React Native

Quick Start

Guides

Guides (iOS)

Guides (Android)

components

apis

Polyfills

Android Setup

NOTE: This guide needs to be extended for Windows. Can you send us a pull request?

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.

If you already have the Android SDK #

  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
  2. Install the Android SDK with brew install android-sdk
  3. Add this to your ~/.bashrc, ~/.zshrc or whatever your shell uses:
    export ANDROID_HOME=/usr/local/opt/android-sdk

Configure your SDK #

  1. Start a new shell and run android; in the window that appears make sure you check:
    • Android SDK Build-tools version 23.0.1
    • Android 6.0 (API 23)
    • Android Support Repository
  2. Click "Install Packages"

SDK Manager window SDK Manager window

Install Genymotion #

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.

  1. Download and install Genymotion
  2. Open Genymotion
  3. Create a new emulator and start it

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), 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
    2. With the new AVD selected, click Start...
Next →