Android 構建系統 (Soong/Make) 通過 PRODUCT_PACKAGES 變量決定哪些模組 (APK、可執行檔、庫、內核模組) 被打包進最終系統映像 (system.img)。每個模組的 Android.bp / Android.mk 中定義 name / LOCAL_PACKAGE_NAME,將其加入對應產品的 PRODUCT_PACKAGES 即可編入。
| 文件 | 用途 | 包含關係 |
|---|---|---|
core.mk | **基礎核心包** (所有產品繼承) | 被 generic.mk (模擬器)、common.mk (真機基礎) 繼承 |
common.mk | 真機通用包 (電話、網絡、多媒體) | 繼承 core.mk |
telephony.mk | 電話功能包 (RIL、Dialer、SMS) | 繼承 common.mk |
full_base.mk | 完整基礎系統 (含 Launcher、Settings、Browser 等) | 繼承 telephony.mk |
generic.mk / sdk.mk | **模擬器專用產品** (goldfish 內核、無電話、無調製解調器) | 繼承 full_base.mk |
banyan_addon.mk | 模擬器附加包 (舊版本) | |
development/build/product_sdk.mk | SDK 開發工具包 (ADB、測試工具) | 模擬器專用 |
build/target/product/$PROJECT.mk | **具體產品定義** (如 aosp_arm64.mk, pixel.mk) | 繼承 full_base.mk 或 core.mk |
**修改 build/target/product/core.mk** — 它是所有產品 (模擬器 + 真機) 的共同祖先。
# build/target/product/core.mk
# 在 PRODUCT_PACKAGES 列表中添加你的模組名 (LOCAL_PACKAGE_NAME / name)
PRODUCT_PACKAGES += \
MyCustomApp \
MyCustomService \
MyCustomLibrary
執行 m -j$(nproc) 重新構建,system.img 將包含該 APK。
generic.mk 或 sdk.mk。build/target/product/<product_name>.mk (如 aosp_cf_x86_phone.mk)。telephony.mk。android_app {
name: "MyCustomApp",
srcs: ["src/**/*.java", "src/**/*.kt"],
resource_dirs: ["res"],
manifest: "AndroidManifest.xml",
certificate: "platform", // 系統簽名權限
privileged: true, // 安裝到 /system/priv-app 獲得特權
required: ["some_shared_lib"],
optimize: {
enabled: false, // 系統應用通常不混淆
proguard_flags_files: ["proguard.flags"],
},
}
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_PACKAGE_NAME := MyCustomApp
LOCAL_SRC_FILES := $(call all-java-files-under, src)
LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/res
LOCAL_CERTIFICATE := platform
LOCAL_PRIVILEGED_MODULE := true
include $(BUILD_PACKAGE)
out/target/product/<product>/system/app/ 或 priv-app/ 下出現 APK。adb shell pm list packages | grep MyCustomApp。adb shell dumpsys package com.example.mycustomapp | grep -A5 "requested permissions"。LOCAL_PACKAGE_NAME 決定構建產出名稱,需與 Manifest package 一致。required / LOCAL_REQUIRED_MODULES 未聲明共享庫/服務,導致運行時 ClassNotFoundException。core.mk 後需 m clean 或 m installclean 重建。Android 7.0+ 全面遷移至 Soong (.bp 文件),PRODUCT_PACKAGES 仍在 .mk 中定義,但模組定義改用 .bp。兩者共存期可混用,新專案請優先編寫 Android.bp。