為 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」。