为 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_0 到 channel_id.（含）的所有渠道中已发布的软件包。

如需了解详情，请参阅 sdkmanager。