萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 系統構建:將 APK 編譯進模擬器與真機系統映像 (PRODUCT_PACKAGES 配置指南)

核心機制

Android 構建系統 (Soong/Make) 通過 PRODUCT_PACKAGES 變量決定哪些模組 (APK、可執行檔、庫、內核模組) 被打包進最終系統映像 (system.img)。每個模組的 Android.bp / Android.mk 中定義 name / LOCAL_PACKAGE_NAME,將其加入對應產品的 PRODUCT_PACKAGES 即可編入。

關鍵產品定義文件 (build/target/product/)

文件用途包含關係
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.mkSDK 開發工具包 (ADB、測試工具)模擬器專用
build/target/product/$PROJECT.mk**具體產品定義** (如 aosp_arm64.mk, pixel.mk)繼承 full_base.mk 或 core.mk

如何讓 APK 同時進入模擬器與真機映像?

**修改 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.bp - Soong)

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"],
    },
}

進階:模組定義範例 (Android.mk - Make, 舊專案)

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)

驗證是否編入

  1. 構建完成後:out/target/product/<product>/system/app/ 或 priv-app/ 下出現 APK。
  2. 刷寫/啟動模擬器/真機:adb shell pm list packages | grep MyCustomApp。
  3. 檢查權限:adb shell dumpsys package com.example.mycustomapp | grep -A5 "requested permissions"。

常見坑點

  1. 忘記 LOCAL_CERTIFICATE := platform:導致簽名不匹配,無法獲得系統權限。
  2. 模組名與 APK 包名不一致:LOCAL_PACKAGE_NAME 決定構建產出名稱,需與 Manifest package 一致。
  3. 依賴缺失:required / LOCAL_REQUIRED_MODULES 未聲明共享庫/服務,導致運行時 ClassNotFoundException。
  4. 構建緩存未清:修改 core.mk 後需 m clean 或 m installclean 重建。

現代構建系統 (Soong) 提示

Android 7.0+ 全面遷移至 Soong (.bp 文件),PRODUCT_PACKAGES 仍在 .mk 中定義,但模組定義改用 .bp。兩者共存期可混用,新專案請優先編寫 Android.bp。

copyright © 萬盛學電腦網 all rights reserved