本頁面由 Cloud Translation API 翻譯而成。

安裝並設定 NDK 和 CMake

如要編譯及偵錯應用程式的原生程式碼，您需要下列元件：

Android Native Development Kit (NDK)：這套工具可讓您搭配 Android 使用 C 和 C++ 程式碼。
CMake：與 Gradle 搭配使用的外部建構工具，可建構原生應用程式資源庫。如果您只打算使用 ndk-build，則不需要這個元件。
LLDB：偵錯工具 Android Studio 用來偵錯原生程式碼。根據預設，LLDB 系統會和 Android Studio 一起安裝

本頁說明如何自動安裝這些元件，或使用請使用 Android Studio 或 sdkmanager 工具手動下載並安裝這些項目。

自動安裝 NDK 和 CMake

Android Gradle 外掛程式 4.2.0 以上版本可自動安裝必要的 NDK 和 CMake 您初次建立專案時，如果已事先接受他們的授權即可。如果您已詳閱並同意授權條款，即可預先接受輸入下列指令：

   yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses

安裝 NDK 和 CMake

安裝 NDK 時，Android Studio 會選取最新的可用 NDK。適用對象大多數專案，只要安裝這個預設 NDK 版本即可。不過，如果您的專案需要一或多個指定 NDK 版本，您可以下載並設定特定版本。這麼做很有幫助確保各項專案的可重現版本，且每項專案都依賴特定的 NDK 版本Android Studio 會在 android-sdk/ndk/ 目錄內。

如要在 Android Studio 中安裝 CMake 和預設的 NDK，請按照下列步驟操作：

開啟專案，然後依序點選「Tools」>「SDK Manager」。
按一下「SDK Tools」分頁標籤。
勾選「NDK (並排)」和「CMake」核取方塊。

圖 1.「SDK Tools」視窗顯示「NDK (Side by side)」選項

注意：如果您在 ndk-bundle 資料夾中安裝了 NDK，清單內就會顯示「NDK」標籤。如果您使用 Android Gradle 外掛程式 3.5.0 版或之後勾選或取消勾選這個核取方塊。取消勾選核取方塊解除安裝 NDK 並釋出磁碟空間，而且會導致核取方塊即可從清單中消失如果要解除安裝舊版 NDK，請將 ndk.dir 值，目前已淘汰 local.properties 檔案。
按一下「OK」。

對話方塊會指出 NDK 套件在磁碟上的空間用量。
按一下「OK」。
安裝完成後，按一下「Finish」。
您的專案會自動同步處理建構檔案並執行建構作業。解決所有發生的錯誤。

設定特定版本的 CMake

SDK Manager 包含 3.6.0 分支 CMake 和版本 3.10.2。未設定專案指定的 CMake 版本是使用 CMake 3.10.2 建構而成。目的地：設定 CMake 版本，請將下列內容新增至模組的 build.gradle 檔案：

Groovy

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version "cmake-version"
        }
    }
}

Kotlin

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version = "cmake-version"
        }
    }
}

如果您想使用的 CMake 版本未包含 SDK Manager，請按照下列步驟操作：

下載並安裝 CMake 。
指定您要 Gradle 在模組中使用的 CMake 版本 build.gradle 檔案。
請將 CMake 安裝路徑新增到您的 PATH 環境變數或加入專案的 local.properties 檔案中，如。如果 Gradle 找不到您在您的 build.gradle 檔案會收到建構錯誤。
```
# If you set this property, Gradle no longer uses PATH to find CMake.
cmake.dir = "path-to-cmake"</pre>
```
如果您尚未在請造訪官方 Ninja 網站，，然後下載並安裝適用於您作業系統的最新版 Ninja。請務必新增 Ninja 安裝路徑至您的 PATH 環境變數。

安裝特定版本的 NDK

如要安裝特定版本的 NDK，請按照下列步驟操作：

開啟專案，然後依序點選「Tools」>「SDK Manager」。
按一下「SDK Tools」分頁標籤。
勾選「Show Package Details」(顯示套件詳細資料) 核取方塊。
勾選「NDK (並排)」核取方塊，然後勾選下方核取方塊會對應至要安裝的 NDK 版本。安裝 Android Studio android-sdk/ndk/ 中的所有 NDK 版本目錄。

注意： NDK 的預覽版本 (例如初期測試版本和 Beta 版) 不會顯示在這份清單中，除非您變更更新管道 Android Studio 專屬功能您可以同時安裝 Android Studio 預先發布版和穩定版。
圖 2.「SDK Tools」視窗顯示「NDK (Side by side)」選項

注意：如果您在 ndk-bundle 資料夾中安裝了 NDK，清單內就會顯示「NDK」標籤。如果使用 Gradle 3.5 版或您之後可以勾選或取消勾選這個核取方塊。清除應用程式後，系統將解除安裝已安裝 NDK，藉此釋出磁碟空間並讓這個核取方塊消失確定要繼續嗎？如果要解除安裝舊版 NDK，請移除 ndk.dir 值。現已淘汰，請在您的專案中local.properties 檔案。
按一下「OK」。

對話方塊會指出 NDK 套件會使用多少空間。
按一下「OK」。
安裝完成後，按一下「Finish」。
您的專案會自動同步處理建構檔案並執行建構作業。解決所有發生的錯誤。
使用 NDK 版本設定每個模組您要使用的架構使用 Android Studio 3.6 以上版本時，如果您尚未這麼做指定版本後，Android Gradle 外掛程式會選擇其版本已知的相容性

在專案中設定 NDK 的特定版本

如果使用以下為 true：

您的專案會沿用，且必須使用特定 NDK 版本和 Android Gradle 外掛程式 (AGP)。若需更多資訊，請參閲為 Android Gradle 外掛程式設定 NDK。
您安裝了多個版本的 NDK，而想要使用特定的第一項。在此情況下，請使用 android.ndkVersion 指定版本屬性，如以下程式碼所示build.gradle 樣本。
Groovy
```
android {
    ndkVersion "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
}
```
Kotlin
```
android {
    ndkVersion = "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
}
```

各 AGP 版本的預設 NDK 版本

在發布前，每個 AGP 版本都會使用最新的穩定 NDK 進行全面測試推出新版本。這個 NDK 版本會用於建構您的專案 (如果您) 請勿在 build.gradle 檔案中指定 NDK 版本。預設 NDK 版本如需不同 AGP 版本的操作說明，請參閱 AGP 版本資訊和 AGP 過往版本資訊。