安装并配置 NDK 和 CMake

要编译和调试应用的原生代码，您需要以下组件

Android 原生开发套件 (NDK)：一组工具，允许您在 Android 中使用 C 和 C++ 代码。
CMake：一个外部构建工具，与 Gradle 协同工作以构建您的原生库。如果您只计划使用 ndk-build，则不需要此组件。
LLDB：Android Studio 用于调试原生代码的调试器。默认情况下，LLDB 将与 Android Studio 一起安装。

此页面介绍如何自动安装这些组件，或使用 Android Studio 或 sdkmanager 工具手动下载并安装它们。

自动安装 NDK 和 CMake

Android Gradle 插件 4.2.0 及更高版本可以在您第一次构建项目时自动安装所需的 NDK 和 CMake，前提是已事先接受其许可证。如果您已阅读并同意许可证条款，则可以使用以下命令在脚本中预先接受许可证

   yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses

安装 NDK 和 CMake

安装 NDK 时，Android Studio 会选择最新的可用 NDK。对于大多数项目，安装此默认版本的 NDK 就足够了。但是，如果您的项目需要一个或多个特定版本的 NDK，则可以下载并配置特定版本。这样做有助于确保跨项目的可重复构建，每个项目都依赖于特定版本的 NDK。Android Studio 将所有版本的 NDK 安装在 android-sdk/ndk/ 目录中。

要在 Android Studio 中安装 CMake 和默认 NDK，请执行以下操作

在打开项目的情况下，点击工具 > SDK 管理器。
点击SDK 工具选项卡。
选中NDK（并行）和CMake复选框。

图 1. 显示NDK（并行）选项的SDK 工具窗口

注意：如果在 ndk-bundle 文件夹中安装了 NDK，它将以NDK标签显示在列表中。如果您使用的是 Android Gradle 插件 3.5.0 或更高版本，则可以选择或取消选中此复选框。取消选中此复选框将卸载 NDK，释放磁盘空间，并导致复选框从列表中消失。如果卸载了旧版 NDK，请从项目的 local.properties 文件中删除现已弃用的 ndk.dir 值。
点击确定。

一个对话框会告诉您 NDK 包在磁盘上占用了多少空间。
点击确定。
安装完成后，点击完成。
您的项目会自动同步构建文件并执行构建。解决出现的任何错误。

配置特定版本的 CMake

SDK 管理器包含 CMake 的 3.6.0 分支版本和 3.10.2 版本。未设置特定 CMake 版本的项目将使用 CMake 3.10.2 构建。要设置 CMake 版本，请将以下内容添加到模块的 build.gradle 文件中

Groovy

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version "cmake-version"
        }
    }
}

Kotlin

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version = "cmake-version"
        }
    }
}

如果要使用 SDK 管理器未包含的 CMake 版本，请按照以下步骤操作

从 CMake 官方网站下载并安装 CMake。
在模块的 build.gradle 文件中指定您希望 Gradle 使用的 CMake 版本。
将 CMake 安装路径添加到您的 PATH 环境变量中，或者将其包含在项目的 local.properties 文件中，如所示。如果 Gradle 无法找到您在 build.gradle 文件中指定的 CMake 版本，则会收到构建错误。
```
# If you set this property, Gradle no longer uses PATH to find CMake.
cmake.dir = "path-to-cmake"</pre>
```
如果您的工作站上尚未安装 Ninja 构建系统，请访问 Ninja 官方网站，下载并安装适用于您的操作系统的最新版本的 Ninja。确保还将 Ninja 安装路径添加到您的 PATH 环境变量中。

安装特定版本的 NDK

要安装特定版本的 NDK，请执行以下操作

在打开项目的情况下，点击工具 > SDK 管理器。
点击SDK 工具选项卡。
选中显示包详细信息复选框。
选中NDK（并行）复选框，以及下面与您要安装的 NDK 版本相对应的复选框。Android Studio 将所有版本的 NDK 安装在 android-sdk/ndk/ 目录中。

注意：除非您更改 Android Studio 的更新渠道，否则 NDK 的预览版本（例如，canary 和 beta）不会显示在此列表中。您可以并行安装 Android Studio 预览版和稳定版。

图 2. 显示NDK（并行）选项的SDK 工具窗口

注意：如果在 ndk-bundle 文件夹中安装了 NDK，它将以NDK标签显示在列表中。如果您使用的是 Gradle 3.5 或更高版本，则可以选择或取消选中此复选框。取消选中此复选框将卸载已安装的 NDK，释放磁盘空间，并导致复选框从列表中消失。如果卸载了旧版 NDK，请从项目的 local.properties 文件中删除现已弃用的 ndk.dir 值。
点击确定。

一个对话框会告诉您 NDK 包在磁盘上占用了多少空间。
点击确定。
安装完成后，点击完成。
您的项目会自动同步构建文件并执行构建。解决出现的任何错误。
为每个模块配置您希望它使用的 NDK 版本。使用 Android Studio 3.6 或更高版本时，如果您未指定版本，则 Android Gradle 插件会选择已知与其兼容的版本。

在项目中配置特定版本的 NDK

如果以下情况之一成立，您可能需要在项目中配置 NDK 的版本

您的项目是继承的，您需要使用特定版本的 NDK 和 Android Gradle 插件 (AGP)。有关更多信息，请参阅为 Android Gradle 插件配置 NDK。
您安装了多个版本的 NDK，并且想要使用其中一个特定的版本。在这种情况下，请使用模块的 build.gradle 文件中的 android.ndkVersion 属性指定版本，如下面的代码示例所示。
Groovy
android { ndkVersion "major.minor.build" // e.g., ndkVersion "21.3.6528147" }
Kotlin
android { ndkVersion = "major.minor.build" // e.g., ndkVersion "21.3.6528147" }

每个 AGP 版本的默认 NDK 版本

在发布之前，每个 AGP 版本都会与当时最新的稳定版 NDK 版本进行彻底测试。如果您未在 build.gradle 文件中指定 NDK 版本，则此 NDK 版本将用于构建您的项目。不同版本的 AGP 的默认 NDK 版本记录在 AGP 发行说明和 AGP 过去的发行说明中。