為 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 會在 android-sdk/ndk/ 目錄中安裝所有 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_id. 以下 (含) 的所有管道中已發布的套件，請使用 --channel 選項

詳情請參閱「sdkmanager」。