- How to run the Android NDK install on Windows? [closed]
- Install and configure the NDK and CMake
- Install NDK and CMake automatically
- Install the NDK and CMake
- Configure a specific version of CMake
- Groovy
- Kotlin
- Install a specific version of the NDK
- Configure specific versions of the NDK in your project
- Groovy
- Kotlin
- Default NDK version per AGP version
How to run the Android NDK install on Windows? [closed]
It’s difficult to tell what is being asked here. This question is ambiguous, vague, incomplete, overly broad, or rhetorical and cannot be reasonably answered in its current form. For help clarifying this question so that it can be reopened, visit the help center.
Below are the only instructions I managed to find from Google on how to install the Android NDK, it is written as if we all run Linux and presumes we all understand what these obscure tools are. My comments and questions appear in italics if someone who knows Unix and Windows would translate, that would be great! Android NDK Installation Introduction: Please read docs/OVERVIEW.TXT to understand what the Android NDK is and is not. This file gives instructions on how to properly setup your NDK. I. Requirements: The Android NDK currently requires a Linux, OS X or Windows host operating system. Windows users will need to install Cygwin (http://www.cygwin.com) to use it. Note that running the NDK under MSys is not supported. You will need to have the Android SDK and its dependencies installed. The NDK cannot generate final application packages (.apk files), only the shared library files that can go into them. IMPORTANT: The Android NDK can only be used to target system images using the Cupcake (1.5) or later releases of the platform. This is due to subtle toolchain and ABI related changed that make it incompatible with 1.0 and 1.1 system images. The NDK requires GNU Make 3.81 or later being available on your development system. Earlier versions of GNU Make might work but have not been tested. You can check this by running ‘make -v’ from the command-line. The output should look like:
GNU Make 3.81 Copyright (C) 2006 Free Software Foundation, Inc. .
Install and configure the NDK and CMake
To compile and debug native code for your app, you need the following components:
- The Android Native Development Kit (NDK): a set of tools that allows you to use C and C++ code with Android.
- CMake: an external build tool that works alongside Gradle to build your native library. You do not need this component if you only plan to use ndk-build.
- LLDB: the debugger Android Studio uses to debug native code. By default, LLDB will be installed alongside Android Studio.
This page describes how to install these components automatically, or by using Android Studio or the sdkmanager tool to download and install them manually.
Install NDK and CMake automatically
Android Gradle Plugin 4.2.0+ can automatically install the required NDK and CMake the first time you build your project if their licenses have been accepted in advance. If you’ve already read and agree to the license terms, then you can pre-accept the licenses in scripts with the following command:
yes | $/cmdline-tools/latest/bin/sdkmanager --licenses
Install the NDK and CMake
When you install the NDK, Android Studio selects the latest available NDK. For most projects, installing this default version of the NDK is sufficient. If your project needs one or more specific versions of the NDK, though, you can download and configure specific versions. Doing so helps you ensure reproducible builds across projects that each depend on a specific version of the NDK. Android Studio installs all versions of the NDK in the android-sdk /ndk/ directory.
To install CMake and the default NDK in Android Studio, do the following:
- With a project open, click Tools > SDK Manager.
- Click the SDK Tools tab.
- Select the NDK (Side by side) and CMake checkboxes. Figure 1. The SDK Tools window showing the NDK (Side by side) option Note: If you have an NDK installed in the ndk-bundle folder, it appears in the list with the label NDK. If you are using Android Gradle plugin 3.5.0 or later, you can select this checkbox or clear it. Clearing the checkbox uninstalls the NDK, freeing up disk space, and causes the checkbox to disappear from the list. If you uninstall the legacy NDK, remove the ndk.dir value, which is now deprecated, from your projects’ local.properties files.
- Click OK. A dialog box tells you how much space the NDK package consumes on disk.
- Click OK.
- When the installation is complete, click Finish.
- Your project automatically syncs the build file and performs a build. Resolve any errors that occur.
Configure a specific version of CMake
The SDK Manager includes the 3.6.0 forked version of CMake and version 3.10.2. Projects that don’t set a specific CMake version are built with CMake 3.10.2. To set the CMake version, add the following to your module’s build.gradle file:
Groovy
Kotlin
If you want to use a CMake version that is not included by the SDK Manager, follow these steps:
- Download and install CMake from the official CMake website.
- Specify the CMake version you want Gradle to use in your module’s build.gradle file.
- Either add the path to the CMake installation to your PATH environment variable or include it in your project’s local.properties file, as shown. If Gradle is unable to find the version of CMake you specified in your build.gradle file, you get a build error.
# If you set this property, Gradle no longer uses PATH to find CMake. cmake.dir = "path-to-cmake"
Install a specific version of the NDK
To install a specific version of the NDK, do the following:
- With a project open, click Tools > SDK Manager.
- Click the SDK Tools tab.
- Select the Show Package Details checkbox.
- Select the NDK (Side by side) checkbox and the checkboxes below it that correspond to the NDK versions you want to install. Android Studio installs all versions of the NDK in the android-sdk /ndk/ directory. Note: Preview releases (for example, canary and beta) of the NDK do not show up in this list unless you change the update channel for Android Studio. You can install an Android Studio preview side-by-side with the stable version. Figure 2. The SDK Tools window showing the NDK (Side by side) options Note: If you have an NDK installed in the ndk-bundle folder, it appears in the list with the label NDK. If you are using Gradle version 3.5 or later, you can select this checkbox or clear it. Clearing it uninstalls the NDK installed, freeing up disk space, and cause the checkbox to disappear from the list. If you uninstall the legacy NDK, remove the ndk.dir value, which is now deprecated, from your projects’ local.properties files.
- Click OK. A dialog box tells you how much space the NDK package(s) consumes.
- Click OK.
- When the installation is complete, click Finish.
- Your project automatically syncs the build file and performs a build. Resolve any errors that occur.
- Configure each module with the version of the NDK you want it to use. When using Android Studio 3.6 or higher, if you do not specify the version, the Android Gradle plugin chooses a version that it is known to be compatible with.
Configure specific versions of the NDK in your project
You may need to configure the version of the NDK in your project if one of the following is true:
- Your project is inherited and you need to use specific versions of the NDK and the Android Gradle plugin (AGP). For more information, see Configure the NDK for the Android Gradle plugin.
- You have multiple versions of the NDK installed and you want to use a specific one. In this case, specify the version using the android.ndkVersion property in the module’s build.gradle file, as shown in the following code sample.
Groovy
android < ndkVersion "major.minor.build" // e.g., ndkVersion "21.3.6528147" >
Kotlin
android < ndkVersion no">major.minor.build" // e.g., ndkVersion "21.3.6528147" >
Default NDK version per AGP version
Before release, each AGP version is thoroughly tested with the latest stable NDK release at that time. For AGP version 3.6 and above, that NDK version will be used to build your projects if you do NOT specify an NDK version in the build.gradle file. The default NDK version is documented inside the AGP release notes. The current default NDK versions are listed in the following table:
Android Studio/Gradle Plugin Version | Default NDK version specified for the version of AGP |
8.0 | 25.1.8937393 |
7.4 | 23.1.7779620 |
7.3 | 23.1.7779620 |
7.0 | 21.4.7075529 |
4.2 | 21.4.7075529 |
4.1 | 21.1.6352462 |
4.0 | 21.0.6113669 |
3.6 | 20.0.5594570 |
3.5 and older | No default specified |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2023-07-05 UTC.