配置适用于 Android Gradle 插件的 NDK

本页面介绍了如何根据项目使用的 Android Gradle 插件 (AGP) 版本配置项目中的 NDK。

步骤因项目使用的 AGP 版本而异。您可以通过以下任一位置找到 Android Gradle 插件版本：

  • Android Studio 中的“File > Project Structure > Project”菜单
  • 项目中的顶级 build.gradle 文件

选择以下版本

AGP 4.1+ 版本

您可以通过以下选项配置 NDK

  • （推荐）使用 ndkVersion 属性设置 NDK 版本。
  • 请勿设置任何属性。Android Studio 将自动下载 适用于该特定 AGP 版本的默认 NDK 版本（在本例中为 NDK 21.0.6113669 版），或者您可以从命令行安装 NDK。Android Studio 会将所有版本的 NDK 安装到 android-sdk/ndk/ 目录中。每个版本都位于一个子目录中，子目录的名称即为版本号。

  • 对于特殊用例，请使用 ndkPath 属性

    Groovy

    android {
  ndkPath "/Users/ndkPath/ndk21"  // Point to your own NDK
}

    Kotlin

    android {
  ndkPath = "/Users/ndkPath/ndk21"  // Point to your own NDK
}

从命令行安装 NDK

要从命令行安装 NDK，请执行以下操作

  1. 使用 sdkmanager 工具查看可用的 CMake 和 NDK 软件包版本。与其他 SDK 组件类似，NDK 通过不同的渠道发布

    sdkmanager --list [--channel=channel_id]  // NDK channels: 0 (stable),
                                            // 1 (beta), or 3 (canary)

  2. 将要安装的软件包字符串传递给 sdkmanager。例如，要安装 CMake 或 NDK，请使用以下语法

    sdkmanager --install
          ["ndk;major.minor.build[suffix]" | "cmake;major.minor.micro.build"]
          [--channel=channel_id]

    使用 --channel 选项仅安装已在 小于或等于 channel_id 的渠道中发布的软件包。

如需了解更多信息，请参阅 sdkmanager。