如需穩定版說明文件，請使用「版本化文件」下拉式選單。預設檢視會反映位於 HEAD 的最新版本。

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

搭配 Bazel 使用 Android 原生開發套件

如果您是第一次使用 Bazel，請先瀏覽使用 Bazel 建構 Android 教學課程。

總覽

Bazel 可以在許多不同的建構設定中執行，包括使用 Android Native Development Kit (NDK) 工具鍊的數種建構設定。這表示可以直接在 Bazel 中針對 Android 編譯一般的 cc_library 和 cc_binary 規則。Bazel 會使用 android_ndk_repository 存放區規則來完成這項作業。

必要條件

請確認您已安裝 Android SDK 和 NDK。

如要設定 SDK 和 NDK，請將下列程式碼片段加入 WORKSPACE：

android_sdk_repository(
    name = "androidsdk", # Required. Name *must* be "androidsdk".
    path = "/path/to/sdk", # Optional. Can be omitted if `ANDROID_HOME` environment variable is set.
)

android_ndk_repository(
    name = "androidndk", # Required. Name *must* be "androidndk".
    path = "/path/to/ndk", # Optional. Can be omitted if `ANDROID_NDK_HOME` environment variable is set.
)

如要進一步瞭解 android_ndk_repository 規則，請參閱「建構百科全書項目」。

如果您使用的是最新版本的 Android NDK (r22 以上版本)，請使用 android_ndk_repository 的 Starlark 實作。按照 SREADME 中的指示操作。

快速入門

如要建構 Android 適用的 C++，只要在 android_binary 或 android_library 規則中加入 cc_library 依附元件即可。

舉例來說，假設 Android 應用程式有下列 BUILD 檔案：

# In <project>/app/src/main/BUILD.bazel

cc_library(
    name = "jni_lib",
    srcs = ["cpp/native-lib.cpp"],
)

android_library(
    name = "lib",
    srcs = ["java/com/example/android/bazel/MainActivity.java"],
    resource_files = glob(["res/**/*"]),
    custom_package = "com.example.android.bazel",
    manifest = "LibraryManifest.xml",
    deps = [":jni_lib"],
)

android_binary(
    name = "app",
    deps = [":lib"],
    manifest = "AndroidManifest.xml",
)

這個 BUILD 檔案會產生以下目標圖表：

搜尋結果範例

圖 1 含有 cc_library 依附元件的 Android 專案建構圖。

如要建構應用程式，只要執行以下程式碼即可：

bazel build //app/src/main:app

bazel build 指令會編譯 Java 檔案、Android 資源檔案和 cc_library 規則，然後將所有內容封裝到 APK：

$ zipinfo -1 bazel-bin/app/src/main/app.apk
nativedeps
lib/armeabi-v7a/libapp.so
classes.dex
AndroidManifest.xml
...
res/...
...
META-INF/CERT.SF
META-INF/CERT.RSA
META-INF/MANIFEST.MF

Bazel 將所有 cc_Library 編譯為單一共用物件 (.so) 檔案，並預設以 armeabi-v7a ABI 為目標。如要同時變更此設定或為多個 ABI 進行建構，請參閱「設定目標 ABI」一節。

設定範例

您可以在 Bazel 範例存放區中找到這個範例。

在 BUILD.bazel 檔案中，使用 android_binary、android_library 和 cc_library 規則定義三個目標。

android_binary 頂層目標會建構 APK。

cc_library 目標包含一個 C++ 來源檔案及實作 JNI 函式：

#include <jni.h>
#include <string>

extern "C"
JNIEXPORT jstring

JNICALL
Java_com_example_android_bazel_MainActivity_stringFromJNI(
        JNIEnv *env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}

android_library 目標會指定 Java 來源、資源檔案和 cc_library 目標的依附元件。在這個範例中，MainActivity.java 會載入共用物件檔案 libapp.so，並定義 JNI 函式的方法簽章：

public class MainActivity extends AppCompatActivity {

    static {
        System.loadLibrary("app");
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
       // ...
    }

    public native String stringFromJNI();

}

設定目標 ABI

如要設定目標 ABI，請使用 --android_platforms 標記，如下所示：

bazel build //:app --android_platforms=comma-separated list of platforms

與 --platforms 旗標類似，傳送至 --android_platforms 的值是 platform 目標的標籤，並使用標準限制值描述裝置。

舉例來說，如果是搭載 64 位元 ARM 處理器的 Android 裝置，您必須將平台定義如下：

platform(
    name = "android_arm64",
    constraint_values = [
        "@platforms//os:android",
        "@platforms//cpu:arm64",
    ],
)

所有 Android platform 都應使用 @platforms//os:android OS 限制。如要遷移 CPU 限制，請檢查這個圖表：

CPU 值	平台
`armeabi-v7a`	`@platforms//cpu:arm`
`arm64-v8a`	`@platforms//cpu:arm64`
`x86`	`@platforms//cpu:x86_32`
`x86_64`	`@platforms//cpu:x86_64`

當然，對於多架構 APK 而言，您會傳送多個標籤，例如：--android_platforms=//:arm64,//:x86_64 (假設您已在頂層 BUILD.bazel 檔案中定義這些標籤)。

Bazel 無法選取預設的 Android 平台，因此必須使用 --android_platforms 定義及指定預設平台。

視 NDK 修訂版本和 Android API 級別而定，您可以使用下列 ABI：

NDK 修訂版本	ABI
16 以下版本	armeabi、 armeabi-v7a、arm64-v8a、mips、mips64、x86、x86_64
17 歲以上	armeabi-v7a、arm64-v8a、x86、x86_64

如要進一步瞭解這些 ABI，請參閱 NDK 說明文件。

我們不建議在發布子版本中使用 Multi-ABI Fat APK，因為 APK 會增加 APK 的大小，但對於開發和品質確保版本非常實用。

選取 C++ 標準

請使用以下旗標，根據 C++ 標準進行建構：

C++ 標準	旗幟
C++98	預設，不需旗標
C++11	`--cxxopt=-std=c++11`
C++14	`--cxxopt=-std=c++14`
C++17	`--cxxopt=-std=c++17`

例如：

bazel build //:app --cxxopt=-std=c++11

如要進一步瞭解如何透過 --cxxopt、--copt 和 --linkopt 傳遞編譯器和連結器標記，請參閱使用手冊。

您也可以使用 copts 和 linkopts，將編譯器和連結器旗標指定為 cc_library 中的屬性。例如：

cc_library(
    name = "jni_lib",
    srcs = ["cpp/native-lib.cpp"],
    copts = ["-std=c++11"],
    linkopts = ["-ldl"], # link against libdl
)

在不使用 `android_binary` 的情況下建構 Android 適用的 `cc_library`

如要在不使用 android_binary 的情況下建構 Android 適用的獨立 cc_binary 或 cc_library，請使用 --platforms 標記。

舉例來說，假設您已在 my/platforms/BUILD 中定義 Android 平台：

bazel build //my/cc/jni:target \
      --platforms=//my/platforms:x86_64

使用這個方法時，整個建構樹狀結構都會受到影響。

這些標記可以放入 project/.bazelrc 中的 bazelrc 設定 (每個 ABI 各一個)：

common:android_x86 --platforms=//my/platforms:x86

common:android_armeabi-v7a --platforms=//my/platforms:armeabi-v7a

# In general
common:android_<abi> --platforms=//my/platforms:<abi>

接著，如要為 x86 建構 cc_library，請執行：

bazel build //my/cc/jni:target --config=android_x86

一般來說，對於低階目標 (例如 cc_library) 或確切建構目標時，請使用這個方法；對於預期建構許多不可控管的高階目標，依賴 android_binary 的自動設定轉場功能。