Configuration and System Requirements

By following these steps, you should have a consistent and well-configured development environment for your
Android application on Windows 10/11. Remember to restart your system after making changes related to CMake
in Android Studio and after updating Environment Variables.

Operating System

Ensure that your development machine is running Windows 10/11. This guide has been refined to work on Windows 10/11. Other Operating Systems might work, but are not supported.

Android Studio

For this guide, Android Studio Narwhal 4 Feature Drop | 2025.1.4 have been tested and confirmed to work. Android Studio can be downloaded from the official Android Studio archive: https://developer.android.com/studio/archive.

Android Studio Emulator

When using the Android Studio Emulator for testing, ensure that the Android version and ABI match those of the Android application. Additionally, make sure that, for the emulator, the OpenGL ES API level (requires a restart) is set to "Renderer maximum (up to OpenGL ES 3.1)." This OpenGL ES API level can be configured in the Android Studio Emulator's Extended Controls.

drawing-7-1706169271.png
drawing-7-1706169286.png

Android Software Development Kit (SDK)

After installing and setting up Android Studio, the SDK path has to be added to the System Environment Variables under the User Variables. After saving make sure to restart the system to apply the changes correctly.

drawing-7-1784069923.png

Android Native Development Kit (NDK)

  1. In Android Studio, open [Tools | SDK Manager | SDK Tools | enable NDK (Side by side) | then click Show Package Details and select version 28.0.13004108].
  2. Click Apply / OK to install.
  3. NDK will be automatically installed at:

    C:\Users\<your-username>\AppData\Local\Android\Sdk\ndk\28.0.13004108

drawing-7-1784070047.png

Java Development Kit (JDK)

The JDK can be downloaded and used within Android Studio directly. For Android Applications we make use of the Eclipse Temurin 17. When the Android Demo Application has been opened with Android Studio, the Android JDK should be set. On the specific Android Application wiki page the used JDK version is written down.

  1. In Android Studio, open [File | Settings | Build, Execution, Deployment | Build Tools | Gradle].
  2. Choose Gradle JDK: Temurin-17 Eclipse Temurin Version 17.0.18.
drawing-7-1784070745.png

If this version is not available in the dropdown, download it by clicking on “Download JDK…” in the dropdown of Gradle JDK.

drawing-7-1784070917.png
drawing-7-1784070967.png

Ninja

The "ninja" version used is 1.10.2 and can be downloaded from https://github.com/ninja-build/ninja/releases/download/v1.10.2/ninja-win.zip. Copy "ninja.exe" to "C:\Programs\" and add this path "C:\Programs\" to the Environment Variables -> System Variables -> Path.

CMake

For the current Android demo applications that use the NativeView approach (e.g., NativeViewLibrary and AndroidCgiPlayerLauncher), we rely on specific CMake versions.

These CMake versions can be installed directly through the Android Studio SDK Manager.

  1. In Android Studio, open [File | Settings | Languages & Frameworks | Android SDK] and navigate to the SDK Tools tab.
  2. Click on Show Package Details on the bottom right of the page.
  3. In the list, make sure only CMake 3.10.2 is selected and installed.
  4. After installing and closing the settings page, make sure to restart the system to apply the changes correctly.
drawing-7-1716879030.png

Other Dependencies

Depending on your project, additional dependencies might be required (e.g., specific libraries, tools).
Document and install these as needed.

Troubleshooting

Environment tested with Android Applications


Revision #17
Created 2023-12-05 08:36:48 UTC by Mokhtar Shahin
Updated 2026-07-14 23:43:06 UTC by Kanai Tomoaki