如果您是第一次使用 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
的自動設定轉場功能。