Android 編譯 -- Android.mk語法


android系統源碼編譯步驟
1.source build/envsetup.sh && lunch xxx 或者 . ./build/envsetup.sh && lunch xxx 。執行envsetup.sh腳本之后,envsetup.sh中的變量成了全局變量,而其中的函數也可以直接在當前終端命令行中使用。

常用函數解析

  • lunch :選擇要編譯的目標產品和版本
  • croot:切換到源碼的頂層目錄
  • m: 從頂層目錄build整個系統
  • mm: 構建當前目錄下所有的模塊,但不包括它們的依賴
  • mmm: 構建指定目錄下所有的模塊,但不包括它們的依賴
  • mma: 構建當前目錄下所有的模塊以及它們所依賴的模塊
  • mmma: 構建指定目錄下所有的模塊以及它們所依賴的模塊

android.mk的使用實例和函數解釋

mk 語法允許將 Source 打包成一個模塊,模塊又分為:

動態庫:可以被 install/copy 到應用程序包(apk)
靜態庫:可以被鏈接入動態庫
一個 mk 中能定義一個或者多個模塊,也可以將同一份 Source 加入到多個模塊中。

簡單例子展示

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := hello
LOCAL_SRC_FILES := hello.c
include $(BUILD_SHARED_LIBRARY)

  • LOCAL_PATH := $(call my-dir)
    mk文件須由 LOCAL_PATH 開始,用於在開發系統源碼tree中查找源文件,宏 my-dir 則由 Build System 提供,返回包含 Android.mk 的目錄路徑。

  • include $(CLEAR_VARS)
    CLEAR_VARS變量是編譯系統提供的,並指向一個指定的 GNU Makefile,由它負責清理很多LOCAL_xxx。用於清理變量,重置編譯環境,因為所有的編譯控制文件由同一個GNU Makefile解析和執行,其變量是全局的,所以清理后才能避免相互影響。

  • LOCAL_MODULE := hello
    模塊的名稱,必須定義,名字要唯一不能帶空格。Build System 會自動添加適當的前綴和后綴。

  • LOCAL_SRC_FILES := hello.c
    列出需要編譯的c/c++文件。

  • include $(BUILD_SHARED_LIBRARY)
    BUILD_SHARED_LIBRARY 是 Build System 提供的一個變量,指向一個 GNU Makefile 腳本。

  • BUILD_STATIC_LIBRARY:編譯為靜態庫
  • BUILD_SHARED_LIBRARY:編譯為動態庫
  • BUILD_EXECUTABLE:編譯為Native C可執行程序
  • LOCAL_MODULE_TAGS := optional
    指定在什么類型的版本下編譯,通常有user/debug/eng 或者 optional(在所有版本下都會編譯)

  • LOCAL_PRIVATE_PLATFORM_APIS := true
    使用SDK中隱藏的API參與編譯

  • LOCAL_SDK_VERSION := current
    設置參與編譯SDK版本,(若是在 Android.mk 中添加該選項,則編譯時會忽略源碼隱藏的API,故在使用源碼的 hide api 后會導致編譯失敗)

  • internal api
    翻譯為內部API,理解為供sdk內部使用的API。這類接口最初打算就是不對外公開的
  • hide api
    在源碼中看到使用@hide 標記的方法或類,就是hide的。這類接口本意是要公開,但是當前階段仍然不穩定或未開發完成。所以暫時不推薦開發者調用。但可以使用
  • 普通api
    第三方app也可以使用的api
  • LOCAL_CERTIFICATE := platform
    指定用什么方式簽名

  • LOCAL_USE_AAPT2 := true
    aapt 是Android Asset Packaging Tool的縮寫,是編譯和打包資源的工具。appt2是appt的升級版。

  • LOCAL_JNI_SHARED_LIBRARIES := libbluetooth
    參與編譯的共享庫

  • LOCAL_JAVA_LIBRARIES := javax
    指定依賴的共享java類庫,這個是編譯時依賴,最終不會打包

  • LOCAL_STATIC_JAVA_LIBRARIES

LOCAL_STATIC_JAVA_LIBRARIES :=
com.android.vcard
指定依賴的靜態java類庫,最終會打包到apk里面。

  • LOCAL_STATIC_ANDROID_LIBRARIES

LOCAL_STATIC_ANDROID_LIBRARIES :=
androidx.appcompat_appcompat
androidx.fragment_fragment
聲明要調用 android 的包

  • LOCAL_PROGUARD_FLAG_FILES := proguard.flags
    添加混淆規則配置文件參與編譯。

android.mk的使用實例

  • 編譯有源碼的apk
點擊查看代碼
LOCAL_PATH:= $(call my-dir)

include $(CLEAR_VARS)
# 源文件,可包含java、aidl文件 LOCAL_SRC_FILES += src/com/goodocom/gocsdk/IGocsdkCallback.aidl
LOCAL_SRC_FILES := $(call all-java-files-under, src)

# resource資源文件
LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/res
# AndroidManifest.xml文件 LOCAL_MANIFEST_FILE := $(LOCAL_PATH)/AndroidManifest.xml

# 是否啟用AAPT2 是編譯和打包資源的工具 LOCAL_MODULE_PATH apk存放路徑
LOCAL_USE_AAPT2 := true
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_PATH := $(TARGET_OUT)/app
LOCAL_PROGUARD_FLAG_FILES := proguard.flags
# APK的簽名方式
LOCAL_CERTIFICATE := platform
# 目標APK文件名稱
LOCAL_PACKAGE_NAME := QualBT
# 是否啟用odex優化
LOCAL_DEX_PREOPT := false
# SDK版本
LOCAL_SDK_VERSION := current
# 依賴的靜態庫 so庫是已經存在的,不需要重新編譯 
#LOCAL_PREBUILT_JNI_LIBS :=libs/armeabi/libserial_port.so

# 私有路徑 /system/priv_app  LOCAL_PRIVILEGED_MODULE := true

# 依賴的android靜態庫
LOCAL_STATIC_ANDROID_LIBRARIES := \
	androidx.appcompat_appcompat \
	androidx.fragment_fragment

# 構建APK
include $(BUILD_PACKAGE)
  • 編譯無源碼的apk
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)

LOCAL_MODULE := btTw
LOCAL_MODULE_TAGS := optional
LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
LOCAL_MODULE_CLASS := APPS
LOCAL_CERTIFICATE := platform

#out\target\product\qssi\system\app
LOCAL_MODULE_PATH := $(TARGET_OUT)/app
include $(BUILD_PREBUILT)

預置的android.mk

  • 預置jar
LOCAL_PATH:= $(call my-dir)

# 預置
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := zxing:libs/core.jar \
                                        gson:libs/gson-2.8.0.jar \
                                        android-support-v7:libs/android-support-v7-recyclerview.jar 
include $(BUILD_MULTI_PREBUILT)

# 引用
include $(CLEAR_VARS)
......
LOCAL_STATIC_JAVA_LIBRARIES += zxing
LOCAL_STATIC_JAVA_LIBRARIES += gson
LOCAL_STATIC_JAVA_LIBRARIES += android-support-v7
......
include $(BUILD_PACKAGE)

*預置so

LOCAL_PATH:= $(call my-dir)

# 預置
include $(CLEAR_VARS)
LOCAL_MODULE := mylib2
LOCAL_SRC_FILES_32 := lib/armeabi-v7a/mylib2.so
LOCAL_SRC_FILES_64 := lib/arm64-v8a/mylib2.so
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_MODULE_SUFFIX := .so
LOCAL_PROPRIETARY_MODULE := true
LOCAL_MULTILIB := both
include $(BUILD_PREBUILT)

......
# 引用
include $(CLEAR_VARS)
LOCAL_SHARED_LIBRARIES += mylib2
include $(BUILD_PACKAGE)
......

*預置apk

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

# 模塊名稱
LOCAL_MODULE := NewGallery2
# 要覆蓋掉的模塊名稱
LOCAL_OVERRIDES_PACKAGES := Gallery Gallery3D GalleryNew3D Gallery2 DreamGallery2
# 模塊類型為APPS
LOCAL_MODULE_CLASS := APPS
# 允許使用系統隱藏接口
LOCAL_PRIVATE_PLATFORM_APIS := true
# 簽名,如無需重簽名,則直接設置為PRESIGNED使用已有簽名;需要重簽,則設置為對應簽名的值。
LOCAL_CERTIFICATE := platform
# 目標編譯后的輸出目錄
LOCAL_MODULE_PATH := $(TARGET_OUT)/priv-app
# APK文件
LOCAL_SRC_FILES := apk/NewGallery2.apk
# APK預置的so
ifeq ($(strip $(TARGET_ARCH)), arm64)
    LOCAL_PREBUILT_JNI_LIBS := libs/arm64-v8a/libjni_jpeg.so
else ifeq ($(strip $(TARGET_ARCH)), x86_64)
    LOCAL_PREBUILT_JNI_LIBS := libs/x86_64/libjni_jpeg.so
else ifeq ($(strip $(TARGET_ARCH)),arm)
    LOCAL_PREBUILT_JNI_LIBS := libs/armeabi-v7a/libjni_jpeg.so
else
    LOCAL_PREBUILT_JNI_LIBS := libs/x86/libjni_jpeg.so
endif
include $(BUILD_PREBUILT)

參考文獻

Android.mk例子
Android.mk例子


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM