为 Android Gradle 插件配置 NDK

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

操作步骤因项目中使用的 AGP 版本而异。您可以在以下任一位置找到 Android Gradle 插件版本信息：

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

请从下方选择一个版本：

AGP 版本 3.5

可以通过以下方式配置 NDK：

  • （推荐）使用 ndkVersion 属性设置 NDK 版本。

  • 不设置任何属性。Android Studio 会在以下目录中查找 NDK：

    • android-sdk/ndk/version-number
    • android-sdk/ndk-bundle/

  • 在 Android Studio 项目根目录下的 local.properties 文件中，使用 ndk.dir 属性：

    ndk.dir = /Users/ndkPath/ndk21 // Point to your own NDK

    您也可以使用 Android Studio 界面（File > Project Structure > SDK Location > Android NDK location）进行此设置。

  • 使用 $ANDROID_NDK_HOME 环境变量设置 NDK 的路径。Android Studio 会在启动时读取此设置并将其缓存到界面和 ndk.dir。

从命令行安装 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。