docs/scenes/get-started/set-up-your-environment/instructions/_androidStudioInstructions.mdx
import { Collapsible } from '/ui/components/Collapsible';
import { ContentSpotlight } from '/ui/components/ContentSpotlight';
import { Terminal } from '/ui/components/Snippet';
import { Step } from '/ui/components/Step';
import { Tabs, Tab } from '~/ui/components/Tabs';
Download and install Android Studio.
</Step> <Step label="2">Open the Android Studio app, you will see the SDK Components setup screen. Click Next to continue to install the Android SDK and Android SDK Platform. Click Next again to verify the settings and install.
<ContentSpotlight alt="Android Studio SDK Components setup" src="/static/images/android-studio/sdk-components-setup.png" className="max-w-[540px]" />
</Step> <Step label="3">By default, Android Studio will install the latest version of the Android SDK. However, Android 15 (VanillaIceCream) SDK is required to compile a React Native app.
Open Android Studio, go to Settings > Languages & Frameworks > Android SDK. From the SDK Platforms tab, and under Android 15 (VanillaIceCream), select Android SDK Platform 35 and Sources for Android 35.
<ContentSpotlight alt="Android SDK Platforms" src="/static/images/android-studio/sdk-platforms.png" className="max-w-[640px]" />
</Step> <Step label="4">Then, click on the SDK Tools tab and make sure you have at least one version of the Android SDK Build-Tools and Android Emulator installed.
<ContentSpotlight alt="Android SDK build tools." src="/static/images/android-studio/build-tools.png" className="max-w-[640px]" />
</Step> <Step label="5">Copy or remember the path listed in the box that says Android SDK Location.
<ContentSpotlight alt="Android SDK location" src="/static/images/android-studio/sdk-location.png" className="max-w-[640px]" /> </Step>
<Step label="6">Add the following lines to your /.zprofile or ~/.zshrc (if you are using bash, then ~/.bash_profile or ~/.bashrc) config file:
<Terminal cmd={[ '$ export ANDROID_HOME=$HOME/Library/Android/sdk', '$ export PATH=$PATH:$ANDROID_HOME/emulator', '$ export PATH=$PATH:$ANDROID_HOME/platform-tools', ]} cmdCopy="export ANDROID_HOME=$HOME/Library/Android/sdk && export PATH=$PATH:$ANDROID_HOME/emulator && export PATH=$PATH:$ANDROID_HOME/platform-tools" />
</Step> <Step label="7">Reload the path environment variables in your current shell:
<Terminal cmd={['# for zsh', '$ source $HOME/.zshrc', '', '# for bash', '$ source $HOME/.bashrc']} />
</Step> <Step label="8">Finally, make sure that you can run adb from your terminal.
If Android Studio doesn't recognize your homebrew installed JDK, you can create a Gradle configuration file to explicitly set the Java path:
Create a Gradle properties file in your home directory:
<Terminal cmd={['$ touch ~/.gradle/gradle.properties']} />
Add the following line to the gradle.properties file, replacing the path with your actual Java installation path:
java.home=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home
If you have an existing .gradle folder in your project directory, delete it and reopen your project in Android Studio:
<Terminal cmd={['$ rm -rf .gradle']} />
This should resolve issues with Android Studio not detecting your JDK installation.
</Collapsible> </Step> </Tab> <Tab label="Windows"> <Step label="1">Download Android Studio.
</Step> <Step label="2">Open Android Studio Setup. Under Select components to install, select Android Studio and Android Virtual Device. Then, click Next.
</Step> <Step label="3">In the Android Studio Setup Wizard, under Install Type, select Standard and click Next.
<ContentSpotlight alt="Android Studio Setup Wizard asks for the type of installation." src="/static/images/android-studio/windows-install-type.png" className="max-w-[600px]" />
</Step> <Step label="4">The Android Studio Setup Wizard will ask you to verify the settings, such as the version of Android SDK, platform-tools, and so on. Click Next after you have verified.
</Step> <Step label="5">In the next window, accept licenses for all available components.
<ContentSpotlight alt="Android Studio Setup Wizard asks to accept various licenses to install the tools." src="/static/images/android-studio/windows-licenses.png" className="max-w-[600px]" />
</Step> <Step label="6">By default, Android Studio will install the latest version of the Android SDK. However, Android 15 (VanillaIceCream) SDK is required to compile a React Native app.
Open Android Studio, go to Settings > Languages & Frameworks > Android SDK. From the SDK Platforms tab, and under Android 15 (VanillaIceCream), select Android SDK Platform 35 and Sources for Android 35.
<ContentSpotlight alt="Android SDK Platforms" src="/static/images/android-studio/windows-sdk-platforms.png" className="max-w-[640px]" />
</Step> <Step label="7">Then, click on the SDK Tools tab and make sure you have at least one version of the Android SDK Build-Tools and Android Emulator installed.
<ContentSpotlight alt="Android SDK build tools" src="/static/images/android-studio/windows-build-tools.png" className="max-w-[640px]" />
</Step> <Step label="8">After the tools installation is complete, configure the ANDROID_HOME environment variable. Go to Windows Control Panel > User Accounts > User Accounts (again) > Change my environment variables and click New to create a new ANDROID_HOME user variable. The value of this variable will point to the path to your Android SDK:
<ContentSpotlight alt="Setting up ANDROID_HOME user variable." src="/static/images/android-studio/windows-android-home-variable.png" className="max-w-[480px]" />
<Collapsible summary="How to find installed SDK location?">By default, the Android SDK is installed at the following location:
%LOCALAPPDATA%\Android\Sdk
To find the location of the SDK in Android Studio manually, go to Settings > Languages & Frameworks > Android SDK. See the location next to Android SDK Location.
<ContentSpotlight alt="Android SDK location in Android Studio Settings." src="/static/images/android-studio/windows-android-sdk-location.png" className="max-w-[400px]" />
</Collapsible> </Step> <Step label="9">To verify that the new environment variable is loaded, open PowerShell, and copy and paste the following command:
<Terminal cmd={['$ Get-ChildItem -Path Env: ']} />
The command will output all user environment variables. In this list, see if ANDROID_HOME has been added.
To add platform-tools to the Path, go to Windows Control Panel > User Accounts > User Accounts (again) > Change my environment variables > Path > Edit > New and add the path to the platform-tools to the list as shown below:
<ContentSpotlight alt="Setting up platform-tools user variable." src="/static/images/android-studio/windows-platform-tools-path.png" className="max-w-[480px]" />
<Collapsible summary="How to find installed platform-tools location">By default, the platform-tools are installed at the following location:
%LOCALAPPDATA%\Android\Sdk\platform-tools
Finally, make sure that you can run adb from the PowerShell. For example, run the adb --version to see which version of the adb your system is running.