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)