1. 程式人生 > >android 編譯原理詳解

android 編譯原理詳解

  Android編譯過程詳解(一):http://www.cnblogs.com/mr-raptor/archive/2012/06/07/2540359.html

Android的優勢就在於其開源,手機和平板生產商可以根據自己的硬體進行個性定製自己的手機產品,如小米,LePhone,M9等,因此,在我們在對Android的原始碼進行定製的時候,很有必要了解下,Android的編譯過程。

但是,這兒只是告訴你瞭如何去編譯一個通用的系統,並沒有詳細告訴你細節,我們跟著編譯過程來了解下。

+--------------------------------------------------------------------------------------------------------------------+

 本文使用Android版本為2.1,採用開發板為華清遠見研發的FS_S5PC100 A8開發板。

+--------------------------------------------------------------------------------------------------------------------+

按照google給出的編譯步驟如下:

   1> source build/envsetup.sh:載入命令

   2> lunch:選擇平臺編譯選項

   3> make:執行編譯

我們按照編譯步驟來分析編譯過程的細節,最終新增自己的平臺編譯選項。

1. source build/envsetup.sh

這個命令是用來將envsetup.sh裡的所有用到的命令載入到環境變數裡去,我們來分析下它。

envsetup.sh裡的主要命令如下:

function help()                  # 顯示幫助資訊
function get_abs_build_var()           # 獲取絕對變數
function get_build_var()             # 獲取絕對變數
function check_product()             # 檢查product
function check_variant()             # 檢查變數
function setpaths()                # 設定檔案路徑
function printconfig()              # 列印配置
function set_stuff_for_environment()        # 設定環境變數
function set_sequence_number()            # 設定序號
function settitle()                # 設定標題
function choosetype()               # 設定type
function chooseproduct()              # 設定product
function choosevariant()              # 設定variant
function tapas()                  # 功能同choosecombo
function choosecombo()               # 設定編譯引數
function add_lunch

_combo()             # 新增lunch專案
function print_lunch_menu()            # 列印lunch列表
function lunch()                 # 配置lunch
function m()                   # make from top
function findmakefile()              # 查詢makefile
function mm()                   # make from current directory
function mmm()                   # make the supplied directories
function croot()                 # 回到根目錄
function cproj()
function pid()
function systemstack()
function gdbclient()
function jgrep()                 # 查詢java檔案
function cgrep()                  # 查詢c/cpp檔案
function resgrep()
function tracedmdump()
function runhat()
function getbugreports()
function startviewserver()
function stopviewserver()
function isviewserverstarted()
function smoketest()
function runtest()
function godir ()                 # 跳到指定目錄 405

 # add_lunch_combo函式被多次呼叫,就是它來新增Android編譯選項
 # Clear this variable.  It will be built up again when the vendorsetup.sh
 406 # files are included at the end of this file.
 # 清空LUNCH_MENU_CHOICES變數,用來存在編譯選項
 407 unset LUNCH_MENU_CHOICES
 408 function add_lunch_combo()  
 409 {
 410     local new_combo=$1         # 獲得add_lunch_combo被呼叫時的引數
 411     local c
     # 依次遍歷LUNCH_MENU_CHOICES裡的值,其實該函式第一次呼叫時,該值為空
 412     for c in ${LUNCH_MENU_CHOICES[@]} ; do
 413         if [ "$new_combo" = "$c" ] ; then    # 如果引數裡的值已經存在於LUNCH_MENU_CHOICES變數裡,則返回
 414             return
 415         fi
 416     done
     # 如果引數的值不存在,則新增到LUNCH_MENU_CHOICES變數裡
 417     LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
 418 }


# 這是系統自動增加了一個預設的編譯項 generic-eng
 420 # add the default one here
 421 add_lunch_combo generic-eng    # 呼叫上面的add_lunch_combo函式,將generic-eng作為引數傳遞過去
 422
 423 # if we're on linux, add the simulator.  There is a special case
 424 # in lunch to deal with the simulator
 425 if [ "$(uname)" = "Linux" ] ; then
 426     add_lunch_combo simulator
 427 fi

# 下面的程式碼很重要,它要從vendor目錄下查詢vendorsetup.sh檔案,如果查到了,就載入它
1037 # Execute the contents of any vendorsetup.sh files we can find.
1038 for f in `/bin/ls vendor/*/vendorsetup.sh vendor/*/build/vendorsetup.sh 2> /dev/null`
1039 do
1040     echo "including $f"
1041    . $f       # 執行找到的指令碼,其實裡面就是廠商自己定義的編譯選項
1042 done
1043 unset f

envsetup.sh其主要作用如下:

  1. 載入了編譯時使用到的函式命令,如:help,lunch,m,mm,mmm等
  2. 添加了兩個編譯選項:generic-eng和simulator,這兩個選項是系統預設選項
  3. 查詢vendor/<-廠商目錄>/和vendor/<廠商目錄>/build/目錄下的vendorsetup.sh,如果存在的話,載入執行它,新增廠商自己定義產品的編譯選項
 其實,上述第3條是向編譯系統添加了廠商自己定義產品的編譯選項,裡面的程式碼就是:add_lunch_combo xxx-xxx。

根據上面的內容,可以推測出,如果要想定義自己的產品編譯項,簡單的辦法是直接在envsetup.sh最後,新增上add_lunch_combo myProduct-eng,當然這麼做,不太符合上面程式碼最後的本意,我們還是老實的在vendor目錄下建立自己公司名字,然後在公司目錄下建立一個新的vendorsetup.sh,在裡面新增上自己的產品編譯項

#mkdir vendor/farsight/
#touch vendor/farsight/vendorsetup.sh
#echo "add_lunch_combo fs100-eng" > vendor/farsight/vendorsetup.sh

這樣,當我們在執行source build/envsetup.sh命令的時候,可以在shell上看到下面的資訊:

including vendor/farsight/vendorsetup.sh

 
2. 按照android官網的步驟,開始執行lunch full-eng

當然如果你按上述命令執行,它編譯的還是通用的eng版本系統,不是我們個性系統,我們可以執行lunch命令,它會打印出一個選擇選單,列出可用的編譯選項

如果你按照第一步中添加了vendorsetup.sh那麼,你的選項中會出現:

You're building on Linux

generic-eng simulator fs100-eng
Lunch menu... pick a combo:
     1. generic-eng
     2. simulator
     3. fs100-eng

其中第3項是我們自己新增的編譯項。

lunch命令是envsetup.sh裡定義的一個命令,用來讓使用者選擇編譯項,來定義Product和編譯過程中用到的全域性變數。

我們一直沒有說明前面的fs100-eng是什麼意思,現在來說明下,fs100是我定義的產品的名字,eng是產品的編譯型別,除了eng外,還有user, userdebug,分別表示:

eng: 工程機,

user:終端使用者機

userdebug:除錯測試機

tests:測試機 

由此可見,除了eng和user外,另外兩個一般不能交給終端使用者的,記得m8出來的時候,先放出了一部分eng工程機,然後出來了user機之後,可以用工程機換。

那麼這四個型別是幹什麼用的呢?其實,在main.mk裡有說明,在Android的原始碼裡,每一個目標(也可以看成工程)目錄都有一個Android.mk的makefile,每個目標的Android.mk中有一個型別宣告:LOCAL_MODULE_TAGS,這個TAGS就是用來指定,當前的目標編譯完了屬於哪個分類裡。

    PS:Android.mk和Linux裡的makefile不太一樣,它是Android編譯系統自己定義的一個makefile來方便編譯成:c,c++的動態、靜態庫或可執行程式,或java庫或android的程式,

好了,我們來分析下lunch命令幹了什麼?

function lunch()
{
    local answer

    if [ "$1" ] ; then
       # lunch後面直接帶引數
        answer=$1
    else
       # lunch後面不帶引數,則列印處所有的target product和variant選單提供使用者選擇
        print_lunch_menu  
        echo -n "Which would you like? [generic-eng] "
        read answer
    fi

    local selection=

    if [ -z "$answer" ]
    then
           # 如果使用者在選單中沒有選擇,直接回車,則為系統預設的generic-eng
        selection=generic-eng
    elif [ "$answer" = "simulator" ]
    then
        # 如果是模擬器
        selection=simulator
    elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
    then
        # 如果answer是選擇選單的數字,則獲取該數字對應的字串
        if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
        then
            selection=${LUNCH_MENU_CHOICES[$(($answer-$_arrayoffset))]}
        fi
        # 如果 answer字串匹配 *-*模式(*的開頭不能為-)
    elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
    then
        selection=$answer
    fi

    if [ -z "$selection" ]
    then
        echo
        echo "Invalid lunch combo: $answer"
        return 1
    fi

    # special case the simulator
    if [ "$selection" = "simulator" ]
    then
        # 模擬器模式
        export TARGET_PRODUCT=sim
        export TARGET_BUILD_VARIANT=eng
        export TARGET_SIMULATOR=true
        export TARGET_BUILD_TYPE=debug
    else

        # 將 product-variant模式中的product分離出來
        local product=$(echo -n $selection | sed -e "s/-.*$//")

        # 檢查之,呼叫關係 check_product()->get_build_var()->build/core/config.mk比較羅嗦,不展開了
        check_product $product
        if [ $? -ne 0 ]
        then
            echo
            echo "** Don't have a product spec for: '$product'"
            echo "** Do you have the right repo manifest?"
            product=
        fi

        # 將 product-variant模式中的variant分離出來
        local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")

        # 檢查之,看看是否在 (user userdebug eng) 範圍內
        check_variant $variant
        if [ $? -ne 0 ]
        then
            echo
            echo "** Invalid variant: '$variant'"
            echo "** Must be one of ${VARIANT_CHOICES[@]}"
            variant=
        fi

        if [ -z "$product" -o -z "$variant" ]
        then
            echo
            return 1
        fi
 #  匯出環境變數,這裡很重要,因為後面的編譯系統都是依賴於這裡定義的幾個變數的
        export TARGET_PRODUCT=$product
        export TARGET_BUILD_VARIANT=$variant
        export TARGET_SIMULATOR=false
        export TARGET_BUILD_TYPE=release
    fi # !simulator

    echo

    # 設定到環境變數,比較多,不再一一列出,最簡單的方法 set >env.txt 可獲得
    set_stuff_for_environment
    # 列印一些主要的變數, 呼叫關係 printconfig()->get_build_var()->build/core/config.mk->build/core/envsetup.mk 比較羅嗦,不展開了
    printconfig
}

由上面分析可知,lunch命令可以帶引數和不帶引數,最終匯出一些重要的環境變數,從而影響編譯系統的編譯結果。匯出的變數如下(以實際執行情況為例)

        TARGET_PRODUCT=fs100
        TARGET_BUILD_VARIANT=eng
        TARGET_SIMULATOR=false
        TARGET_BUILD_TYPE=release
 

執行完上述兩個步驟,就該執行:make命令了,下篇來分析。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

通過上篇文章,我們分析了編譯android時source build/envsetup.sh和lunch命令,在執行完上述兩個命令後, 我們就可以進行編譯android了。

1. make 

執行make命令的結果就是去執行當前目錄下的Makefile檔案,我們來看下它的內容:

?
### DO NOT EDIT THIS FILE ### include build/core/main.mk ### DO NOT EDIT THIS FILE ###


呵呵,看到上面 的內容,我們都會笑,這是我見過最簡單的Makefile了,我們再看下build/core/main.mk

main.mk檔案裡雖然指令碼不多,但是卻定義了整個Android的編譯關係,它主要引入了下列幾個重要的mk檔案:

49 include $(BUILD_SYSTEM)/config.mk

55 include $(BUILD_SYSTEM)/cleanbuild.mk

142 include $(BUILD_SYSTEM)/definitions.mk

當然每個mk檔案都有自己獨特的意義,我們一併將主線流程相關mk檔案都列出來,大概來介紹下,先有個整體的概念,然後再細化了解。

所有的Makefile都通過build/core/main.mk這個檔案組織在一起,它定義了一個預設goals:droid,當我們在TOP目錄下,敲Make實際上就等同於我們執行make droid。

當Make include所有的檔案,完成對所有make我檔案的解析以後就會尋找生成droid的規則,依次生成它的依賴,直到所有滿足的模組被編譯好,然後使用相應的工具打包成相應的img。其中,config.mk,envsetup.mk,product_config.mk檔案是編譯使用者指定平臺系統的關鍵檔案。上圖中紅色部分是使用者指定平臺產品的編譯主線,我們先來看下config.mk的主要作用。

2. build/core/config.mk

該檔案被main.mk包含。

定義了以下環境變數:

?
16 SRC_HEADERS := \ 17     $(TOPDIR)system/core/include \ 18     $(TOPDIR)hardware/libhardware/include \ 19     $(TOPDIR)hardware/libhardware_legacy/include \ 20     $(TOPDIR)hardware/ril/include \ 21     $(TOPDIR)dalvik/libnativehelper/include \ 22     $(TOPDIR)frameworks/base/include \ 23     $(TOPDIR)frameworks/base/opengl/include \ 24     $(TOPDIR)external/skia/include 25 SRC_HOST_HEADERS:=$(TOPDIR)tools/include 26 SRC_LIBRARIES:= $(TOPDIR)libs 27 SRC_SERVERS:= $(TOPDIR)servers 28 SRC_TARGET_DIR := $(TOPDIR)build/target 29 SRC_API_DIR := $(TOPDIR)frameworks/base/api .....然後定義了下面幾個重要的編譯命令 43 CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk 44 BUILD_HOST_STATIC_LIBRARY:= $(BUILD_SYSTEM)/host_static_library.mk 45 BUILD_HOST_SHARED_LIBRARY:= $(BUILD_SYSTEM)/host_shared_library.mk 46 BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk 47 BUILD_RAW_STATIC_LIBRARY := $(BUILD_SYSTEM)/raw_static_library.mk 48 BUILD_SHARED_LIBRARY:= $(BUILD_SYSTEM)/shared_library.mk 49 BUILD_EXECUTABLE:= $(BUILD_SYSTEM)/executable.mk 50 BUILD_RAW_EXECUTABLE:= $(BUILD_SYSTEM)/raw_executable.mk 51 BUILD_HOST_EXECUTABLE:= $(BUILD_SYSTEM)/host_executable.mk 52 BUILD_PACKAGE:= $(BUILD_SYSTEM)/package.mk 53 BUILD_HOST_PREBUILT:= $(BUILD_SYSTEM)/host_prebuilt.mk 54 BUILD_PREBUILT:= $(BUILD_SYSTEM)/prebuilt.mk 55 BUILD_MULTI_PREBUILT:= $(BUILD_SYSTEM)/multi_prebuilt.mk 56 BUILD_JAVA_LIBRARY:= $(BUILD_SYSTEM)/java_library.mk 57 BUILD_STATIC_JAVA_LIBRARY:= $(BUILD_SYSTEM)/static_java_library.mk 58 BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk 59 BUILD_DROIDDOC:= $(BUILD_SYSTEM)/droiddoc.mk 60 BUILD_COPY_HEADERS := $(BUILD_SYSTEM)/copy_headers.mk 61 BUILD_KEY_CHAR_MAP := $(BUILD_SYSTEM)/key_char_map.mk
 上述命令變數其實是對應的mk檔名,所有的Android.mk檔案裡基本上都包含上述命令變數,如:

CLEAR_VARS:用來清除之前定義的環境變數

BUILD_SHARED_LIBRARY:用來指定編譯動態庫過程

?
109 # --------------------------------------------------------------- 110 # Define most of the global variables.  These are the ones that 111 # are specific to the user's build configuration. 112 include $(BUILD_SYSTEM)/envsetup.mk 113 114 # Boards may be defined under $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE) 115 # or under vendor/*/$(TARGET_DEVICE).  Search in both places, but 116 # make sure only one exists. 117 # Real boards should always be associated with an OEM vendor. 118 board_config_mk := \ 119     $(strip $(wildcard \ 120         $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/BoardConfig.mk \ 121         vendor/*/$(TARGET_DEVICE)/BoardConfig.mk \ 122     )) 123 ifeq ($(board_config_mk),) 124   $(error No config file found for TARGET_DEVICE $(TARGET_DEVICE)) 125 endif 126 ifneq ($(words $(board_config_mk)),1) 127   $(error Multiple board config files for TARGET_DEVICE $(TARGET_DEVICE): $(board_config_mk)) 128 endif 129 include $(board_config_mk) 130 TARGET_DEVICE_DIR := $(patsubst %/,%,$(dir $(board_config_mk))) 131 board_config_mk :=

112行又包含了另外一個重要的mk檔案envsetup.mk,我們來看一下。

3. envsetup.mk

複製程式碼
 25 ifeq ($(TARGET_PRODUCT),)    #判斷TARGET_PRODUCT是否為空,
 26 ifeq ($(TARGET_SIMULATOR),true)
 27 TARGET_PRODUCT := sim
 28 else
 29 TARGET_PRODUCT := generic
 30 endif
 31 endif
複製程式碼

第25行,判斷TARGET_PRODUCT是否為空,根據上一節分析可知,TARGET_PRODUCT=fs100 

複製程式碼
 34 # the variant -- the set of files that are included for a build
 35 ifeq ($(strip $(TARGET_BUILD_VARIANT)),)
 36 TARGET_BUILD_VARIANT := eng
 37 endif
 38 
 39 # Read the product specs so we an get TARGET_DEVICE and other
 40 # variables that we need in order to locate the output files.
 41 include $(BUILD_SYSTEM)/product_config.mk
複製程式碼

在41行又包含了product_config.mk檔案,等會我們再分析它,先看下面的

複製程式碼
148 # ---------------------------------------------------------------
149 # figure out the output directories
150 
151 ifeq (,$(strip $(OUT_DIR)))
152 OUT_DIR := $(TOPDIR)out
153 endif
154 
155 DEBUG_OUT_DIR := $(OUT_DIR)/debug
156 
157 # Move the host or target under the debug/ directory
158 # if necessary.
159 TARGET_OUT_ROOT_release := $(OUT_DIR)/target
160 TARGET_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/target
161 TARGET_OUT_ROOT := $(TARGET_OUT_ROOT_$(TARGET_BUILD_TYPE))
162 
...
184 PRODUCT_OUT := $(TARGET_PRODUCT_OUT_ROOT)/$(TARGET_DEVICE)
187 
188 HOST_OUT_EXECUTABLES:= $(HOST_OUT)/bin
189 HOST_OUT_SHARED_LIBRARIES:= $(HOST_OUT)/lib
190 HOST_OUT_JAVA_LIBRARIES:= $(HOST_OUT)/framework
191 HOST_OUT_SDK_ADDON := $(HOST_OUT)/sdk_addon
...
200 TARGET_OUT_INTERMEDIATES := $(PRODUCT_OUT)/obj
201 TARGET_OUT_HEADERS:= $(TARGET_OUT_INTERMEDIATES)/include
202 TARGET_OUT_INTERMEDIATE_LIBRARIES := $(TARGET_OUT_INTERMEDIATES)/lib
203 TARGET_OUT_COMMON_INTERMEDIATES := $(TARGET_COMMON_OUT_ROOT)/obj
204 
205 TARGET_OUT := $(PRODUCT_OUT)/system
206 TARGET_OUT_EXECUTABLES:= $(TARGET_OUT)/bin
207 TARGET_OUT_OPTIONAL_EXECUTABLES:= $(TARGET_OUT)/xbin
208 TARGET_OUT_SHARED_LIBRARIES:= $(TARGET_OUT)/lib
209 TARGET_OUT_JAVA_LIBRARIES:= $(TARGET_OUT)/framework
210 TARGET_OUT_APPS:= $(TARGET_OUT)/app
211 TARGET_OUT_KEYLAYOUT := $(TARGET_OUT)/usr/keylayout
212 TARGET_OUT_KEYCHARS := $(TARGET_OUT)/usr/keychars
213 TARGET_OUT_ETC := $(TARGET_OUT)/etc
214 TARGET_OUT_STATIC_LIBRARIES:= $(TARGET_OUT_INTERMEDIATES)/lib
215 TARGET_OUT_NOTICE_FILES:=$(TARGET_OUT_INTERMEDIATES)/NOTICE_FILES
216 
217 TARGET_OUT_DATA := $(PRODUCT_OUT)/data
218 TARGET_OUT_DATA_EXECUTABLES:= $(TARGET_OUT_EXECUTABLES)
219 TARGET_OUT_DATA_SHARED_LIBRARIES:= $(TARGET_OUT_SHARED_LIBRARIES)
220 TARGET_OUT_DATA_JAVA_LIBRARIES:= $(TARGET_OUT_JAVA_LIBRARIES)
221 TARGET_OUT_DATA_APPS:= $(TARGET_OUT_DATA)/app
222 TARGET_OUT_DATA_KEYLAYOUT := $(TARGET_OUT_KEYLAYOUT)
223 TARGET_OUT_DATA_KEYCHARS := $(TARGET_OUT_KEYCHARS)
224 TARGET_OUT_DATA_ETC := $(TARGET_OUT_ETC)
225 TARGET_OUT_DATA_STATIC_LIBRARIES:= $(TARGET_OUT_STATIC_LIBRARIES)
226 
227 TARGET_OUT_UNSTRIPPED := $(PRODUCT_OUT)/symbols
228 TARGET_OUT_EXECUTABLES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/bin
229 TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/lib
230 TARGET_ROOT_OUT_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)
231 TARGET_ROOT_OUT_SBIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/sbin
232 TARGET_ROOT_OUT_BIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/bin
233 
234 TARGET_ROOT_OUT := $(PRODUCT_OUT)/root
235 TARGET_ROOT_OUT_BIN := $(TARGET_ROOT_OUT)/bin
236 TARGET_ROOT_OUT_SBIN := $(TARGET_ROOT_OUT)/sbin
237 TARGET_ROOT_OUT_ETC := $(TARGET_ROOT_OUT)/etc
238 TARGET_ROOT_OUT_USR := $(TARGET_ROOT_OUT)/usr
239 
240 TARGET_RECOVERY_OUT := $(PRODUCT_OUT)/recovery
241 TARGET_RECOVERY_ROOT_OUT := $(TARGET_RECOVERY_OUT)/root
242 
243 TARGET_SYSLOADER_OUT := $(PRODUCT_OUT)/sysloader
244 TARGET_SYSLOADER_ROOT_OUT := $(TARGET_SYSLOADER_OUT)/root
245 TARGET_SYSLOADER_SYSTEM_OUT := $(TARGET_SYSLOADER_OUT)/root/system
246 
247 TARGET_INSTALLER_OUT := $(PRODUCT_OUT)/installer
248 TARGET_INSTALLER_DATA_OUT := $(TARGET_INSTALLER_OUT)/data
249 TARGET_INSTALLER_ROOT_OUT := $(TARGET_INSTALLER_OUT)/root
250 TARGET_INSTALLER_SYSTEM_OUT := $(TARGET_INSTALLER_OUT)/root/system
複製程式碼

上面的程式碼是指定了目標輸出程式碼的位置和主機輸出程式碼的位置,重要的幾個如下:

複製程式碼
PRODUCT_OUT = 這個的結果要根據product_config.mk檔案內容來決定,其實是out/target/product/fs100/
TARGET_OUT = $(PRODUCT_OUT)/system
TARGET_OUT_EXECUTABLES =  $(PRODUCT_OUT)/system/bin
TARGET_OUT_SHARED_LIBRARIES =  $(PRODUCT_OUT)/system/lib
TARGET_OUT_JAVA_LIBRARIES = $(PRODUCT_OUT)/system/framework
TARGET_OUT_APPS = $(PRODUCT_OUT)/system/app
TARGET_OUT_ETC = $(PRODUCT_OUT)/system/etc
TARGET_OUT_STATIC_LIBRARIES  = $(PRODUCT_OUT)/obj/lib
TARGET_OUT_DATA = $(PRODUCT_OUT)/data
TARGET_OUT_DATA_APPS = $(PRODUCT_OUT)/data/app
TARGET_ROOT_OUT = $(PRODUCT_OUT)/root
TARGET_ROOT_OUT_BIN = $(PRODUCT_OUT)/bin
TARGET_ROOT_OUT_SBIN  = $(PRODUCT_OUT)/system/sbin
TARGET_ROOT_OUT_ETC = $(PRODUCT_OUT)/system/etc
TARGET_ROOT_OUT_USR = $(PRODUCT_OUT)/system/usr
複製程式碼

總結下:

envsetup.mk檔案主要包含了product_config.mk檔案,然後指定了編譯時要輸出的所有檔案的OUT目錄。


4. build/core/product_config.mk

複製程式碼
157 include $(BUILD_SYSTEM)/product.mk
...
160 # Read in all of the product definitions specified by the AndroidProducts.mk
161 # files in the tree.
162 #
163 #TODO: when we start allowing direct pointers to product files,
164 #    guarantee that they're in this list.
165 $(call import-products, $(get-all-product-makefiles))
166 $(check-all-products)
...
170 # Convert a short name like "sooner" into the path to the product
171 # file defining that product.
172 #
173 INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
...
176 # Find the device that this product maps to.
177 TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
複製程式碼

157行,我靠,又包含了product.mk檔案

165行,呼叫函式import-products, $(get-all-product-makefiles),這兒我們看上面的註釋:

    Read in all of the product definitions specified by the AndroidProducts.mk files in the tree.
    TODO: when we start allowing direct pointers to product files, guarantee that they're in this list.

意思是說:讀取指定的目錄下所有的AndrodProducts.mk檔案中定義的產品資訊

其實get-all-product-makefiles返回所有的產品檔案xxx.mk

import-products函式去驗證這些產品配置檔案是否都包含有必須的配置資訊,細節後面分析。

173行呼叫了resolve-short-product-name函式,它將返回TARGET_PRODUCT產品的配置檔案目錄,並賦給INTERNAL_PRODUCT

也就是說:

    INTERNAL_PRODUCT = vendor/farsight/products/fs100.mk
    TARGET_DEVICE = fs100

       如果除錯看其結果,可以在167行,將#$(dump-product)取消註釋

然後在175行新增: $(info $(INTERNAL_PRODUCT))

       在178行新增: $(info $(TARGET_DEVICE )),檢視除錯結果。

總結一下:

接合前面的圖,product_config.mk主要讀取vendor目錄下不同廠商自己定義的AndrodProducts.mk檔案,從該檔案裡取得所有產品的配置檔案,然後再根據lunch選擇的編譯項TARGET_PRODUCT,找到與之對應的配置檔案,然後設定TARGET_DEVICE變數,用於後續編譯。

5. build/core/product.mk

複製程式碼
17 #
 18 # Functions for including AndroidProducts.mk files
 19 #
 20 
 21 #
 22 # Returns the list of all AndroidProducts.mk files.
 23 # $(call ) isn't necessary.
 24 #
 25 define _find-android-products-files
 26 $(shell test -d vendor && find vendor -maxdepth 6 -name AndroidProducts.mk) \
 27   $(SRC_TARGET_DIR)/product/AndroidProducts.mk
 28 endef
 29 
 30 #
 31 # Returns the sorted concatenation of all PRODUCT_MAKEFILES
 32 # variables set in all AndroidProducts.mk files.
 33 # $(call ) isn't necessary.
 34 #
 35 define get-all-product-makefiles
 36 $(sort \
 37   $(foreach f,$(_find-android-products-files), \
 38     $(eval PRODUCT_MAKEFILES :=) \
 39     $(eval LOCAL_DIR := $(patsubst %/,%,$(dir $(f)))) \
 40     $(eval include $(f)) \
 41     $(PRODUCT_MAKEFILES) \
 42    ) \
 43   $(eval PRODUCT_MAKEFILES :=) \
 44   $(eval LOCAL_DIR :=) \
 45  )
 46 endef
複製程式碼
 通過註釋可知,本檔案中主要是一些用來處理AndroidProduct.mk的函式
_find-android-products-files:

    用來獲得vendor目錄下,所有名字為AndroidProduct.mk的檔案列表。
get-all-product-makefiles:

    用來獲得所有AndroidProduct.mk檔案裡定義的PRODUCT_MAKEFILES的值(其實是產品檔案路徑名)。


在vendor目錄下,每個公司目錄下都會存在一個AndroidProduct.mk檔案,這個檔案是用來定義這個公司的產品列表,每個產品用<product_name>.mk來表示
如Android給的示例:

vendor/sample/products/AndroidProduct.mk

其內容如下:

複製程式碼
1 #
  2 # This file should set PRODUCT_MAKEFILES to a list of product makefiles
  3 # to expose to the build system.  LOCAL_DIR will already be set to
  4 # the directory containing this file. 
  5 #
  6 # This file may not rely on the value of any variable other than
  7 # LOCAL_DIR; do not use any conditionals, and do not look up the
  8 # value of any variable that isn't set in this file or in a file that
  9 # it includes.
 10 #
 11 
 12 PRODUCT_MAKEFILES := \
 13   $(LOCAL_DIR)/sample_addon.mk
複製程式碼
  裡面只定義了一個產品配置檔案,即當前目錄下的sample_addon.mk:
  1 # List of apps and optional libraries (Java and native) to put in the add-on system image.
  2 PRODUCT_PACKAGES := \
  3     PlatformLibraryClient \
  4     com.example.android.platform_library \
  5     libplatform_library_jni

上述檔案裡定義了產品相關個性化資訊,如,PRODUCT_PACKAGES表示要在當前產品裡新增一些安裝包。
由此可見,get-all-product-makefiles函式,其實就是返回了當前公司裡全部的產品對應的mk檔案列表。


總結:

如果使用者想個性定製自己的產品,應該有以下流程,包含上一節內容:

1. 建立公司目錄

#mkdir vendor/farsight

2. 建立一個vendorsetup.sh檔案,將當前產品編譯項新增到lunch裡,讓lunch能找到使用者個性定製編譯項

#echo "add_lunch_combo fs100-eng" > vendor/farsight/vendorsetup.sh

3. 仿著Android示例程式碼,在公司目錄下建立products目錄

#mkdir -p vendor/farsight/products

4. 仿著Android示例程式碼,在products目錄下建立兩個mk檔案

#touch vendor/farsight/products/AndroidProduct.mk vendor/farsight/products/fs100.mk

在AndroidProduct.mk裡新增如下內容:

PRODUCT_MAKEFILES := $(LOCAL_DIR)/fs100.mk

表示只有一個產品fs100,它對應的配置檔案在當前目錄下的fs100.mk。

5. 在產品配置檔案裡新增最基本資訊

複製程式碼
  1 
  2 PRODUCT_PACKAGES := \
  3     IM \
  4     VoiceDialer
  5 
  6 $(call inherit-product, build/target/product/generic.mk)  ##從某一預設配置開始派生餘下內容參考派生起點
  7 
  8 # Overrides
  9 PRODUCT_MANUFACTURER := farsight
 10 PRODUCT_NAME := fs100
 11 PRODUCT_DEVICE := fs100

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

前面兩節講解了自定義Android編譯項和建立Product產品配置檔案,除了編譯和定義產品相關環境變數外,還需要定義Board相關環境變數。

1. build/core/config.mk

複製程式碼
109 # ---------------------------------------------------------------  
110 # Define most of the global variables.  These are the ones that  
111 # are specific to the user's build configuration.  
112 include $(BUILD_SYSTEM)/envsetup.mk  
113   
114 # Boards may be defined under $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)  
115 # or under vendor/*/$(TARGET_DEVICE).  Search in both places, but  
116 # make sure only one exists.  
117 # Real boards should always be associated with an OEM vendor.  
118 board_config_mk := \  
119     $(strip $(wildcard \  
120         $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/BoardConfig.mk \  
121         vendor/*/$(TARGET_DEVICE)/BoardConfig.mk \  
122     ))  
123 ifeq ($(board_config_mk),)  
124   $(error No config file found for TARGET_DEVICE $(TARGET_DEVICE))  
125 endif  
126 ifneq ($(words $(board_config_mk)),1)  
127   $(error Multiple board config files for TARGET_DEVICE $(TARGET_DEVICE): $(board_config_mk))  
128 endif  
129 include $(board_config_mk)  
130 TARGET_DEVICE_DIR := $(patsubst %/,%,$(dir $(board_config_mk)))  
131 board_config_mk :=  
複製程式碼
上述程式碼在上一節已經見到過,只是分析了112行的envsetup.mk,根據上一節內容可知,envsetup.mk設定了很多OUT變數,最終在build/core/product_config.mk檔案裡,設定了TARGET_DEVICE = fs100。

我們從114行繼續分析。

從114~117行解釋大意可知:

    Board相關配置檔案會存在於$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/或vendor/*/$(TARGET_DEVICE)/目錄中,一個Vendor廠商只能有一個對應的Board配置檔案。

118行定義board_config_mk變數:

    $(wildcard xxx)函式就是找到與xxx的匹配項放到空格列表裡,前面定義TARGET_DEVICE變數 = fs100,所以$(SRC_TARGET_DIR)/board/fs100/BoardConfig.mk不存在,必須要存在vendor/*/fs100/BoardConfig.mk檔案來定義開發板配置資訊。

129行,通過include將vendor/*/fs100/BoardConfig.mk包含進來,

130行,TARGET_DEVICE_DIR為board_config_mk的路徑,即:vendor/*/fs100

總結:

   一個vendor廠商必須要有一個對應的Board配置檔案,即:vendor/*/fs100/BoardConfig.mk

    定義了TARGET_DEVICE_DIR變數,為board_config_mk的路徑,即:vendor/*/fs100

指定board 相關特性,一定要包含:
TARGET_CPU_ABI := armeabi/...
其他屬性參見其他board樣例.(build/target/board/XXX

2.  build/core/main.mk

複製程式碼
141 # Bring in standard build system definitions.
142 include $(BUILD_SYSTEM)/definitions.mk
...
347 ifeq ($(SDK_ONLY),true)
348 
349 # ----- SDK for Windows ------
350 # These configure the build targets that are available for the SDK under Cygwin.
351 # The first section defines all the C/C++ tools that can be compiled under Cygwin,
352 # the second section defines all the Java ones (assuming javac is available.)
353 
354 subdirs := \
355     prebuilt \
356     build/libs/host \
357     build/tools/zipalign \
...

            
           

相關推薦

android 編譯原理

  Android編譯過程詳解(一):http://www.cnblogs.com/mr-raptor/archive/2012/06/07/2540359.html Android的優勢就在於其開源,手機和平板生產商可以根據自己的硬體進行個性定製自己的手機產品,如小米

Android編譯系統(一)——build/envsetup.sh

http://www.cloudchou.com/android/post-134.html 準備好編譯環境後,編譯Rom的第一步是 source build/envsetup.sh,該步驟把envsetup.sh裡的函式宣告為當前會話終端可用的命令。這些命令能讓我們

Android編譯系統(一)

++++++++++++++++++++++++++++++++++++++++++ 本文系本站原創,歡迎轉載! 轉載請註明出處: ++++++++++++++++++++++++++++++++++++++++++ Android的優勢就在於其開源,手機和平板

Android編譯系統(三)

++++++++++++++++++++++++++++++++++++++++++本文系本站原創,歡迎轉載! 轉載請註明出處:++++++++++++++++++++++++++++++++++++++++++前面兩節講解了自定義Android編譯項和建立Product產品

Android矩陣原理(Matrix,ColorMatrix)

在程式設計中有時候需要對圖片做特殊的處理,比如將圖片做出黑白的,或者老照片的效果,有時候還要對圖片進行變換,以拉伸,扭曲等等。 這些效果在android中有很好的支援,通過顏色矩陣(ColorMatrix)和座標變換矩陣(Matrix)可以完美的做出上面的所說的

Android熱修復技術原理(最新最全版本)

總結 核心 桌面圖標 實時 開源 穩定性 安卓 定義 check 本文框架 什麽是熱修復? 熱修復框架分類 技術原理及特點 Tinker框架解析 各框架對比圖 總結 ??通過閱讀本文,你會對熱修復技術有更深的認知,本文會列出各類框架的優缺點以及技術原理,文章末尾簡單描述

android中wifi原理(轉)

二:Wifi模組的初始化:: 在 SystemServer 啟動的時候,會生成一個ConnectivityService的例項, try { Log.i(TAG, "Starting Connectivity Service."); ServiceManager.addService(Con

Android塗鴉畫板原理——從初級到高階(二)

前言 前面寫了《Android塗鴉畫板原理詳解——從初級到高階(一)》,講了塗鴉原理初級和中級的應用,現在講解高階應用。如果沒有看過前面一篇文章的同學,建議先去看看哈。 準備 高階塗鴉涉及到圖片操作,包括對圖片進行縮放移動、塗鴉等,這裡涉及到矩陣的變換。關於矩陣

android中wifi原理

                二:Wifi模組的初始化::在 SystemServer 啟動的時候,會生成一個ConnectivityService的例項,try {Log.i(TAG, "Starting Connectivity Service.");ServiceManager.addService(

Android中Canvas繪圖之PorterDuffXfermode使用及工作原理

概述 類android.graphics.PorterDuffXfermode繼承自android.graphics.Xfermode。在用Android中的Canvas進行繪圖時,可以通過使用PorterDuffXfermode將所繪製的圖形的畫素與Canv

Android視訊直播原理

最近一段時間,視訊直播可謂大火。在視訊直播領域,有不同的商家提供各種的商業解決方案,包括軟硬體裝置,攝像機,編碼器,流媒體伺服器等。本文要講解的是如何使用一系列免費工具,打造一套視訊直播方案。 視訊直播流程 視訊直播的流程可以分為如下幾步:  採集 —&

Android Widget工作原理(一) 最全介紹

      Widget是安卓的一應用程式元件,學名視窗小部件,它是微型應用程式檢視, 可以嵌入到其他應用程式(如主螢幕)和接收資料定期更新。,可以使其他應用程式的外掛被稱為應用程式部件。使用者可以通過新增視窗小部件來新增自己喜歡的APPwidget ,widget主

Android之SharedPreferences原理分析

SharedPreferences作為Android儲存資料方式之一,主要特點是: 1. 只支援Java基本資料型別,不支援自定義資料型別; 2. 應用內資料共享; 3. 使用簡單. 使用方法 1、存資料 SharedPreferenc

Android Framework的啟動方法及原理

安卓系統中執行的第一個Dalvik虛擬機器叫做zygote,意思是“卵”。這“卵”還是挺有用的,因為接下來所有的Dalvik虛擬機器程序都是這個“卵”孵化出來的。 zygote程序中包含兩個主要模組,分別如下: 1、Socket服務端。用於接收啟動新的D

Android命令列手動編譯打包

Android 命令列手動編譯打包過程圖 【詳細步驟】: Step1:使用aapt生成R.java類檔案。 例: F:/explorer/android-sdk-windows2.2/tools>f:/explorer/android-sdk-window

android universal image loader 緩衝原理

1. 功能介紹 1.1 Android Universal Image Loader Android Universal Image Loader 是一個強大的、可高度定製的圖片快取,本文簡稱為UIL。 簡單的說 UIL 就做了一件事——獲取圖片並顯示在相應的控制元件上。 1.2 基本

Android ant 命令列手動編譯打包

Android 命令列手動編譯打包過程圖 1使用aapt生成R.java類檔案: 例: E:\androidDev\android-sdk-windows2.2\tools>E:\androidDev\android-sdk-windows2.2\platf

Android編譯APK

1.反編譯工具:下載 1.1 apktool:反編譯資原始檔 1.2   dex2jar-2.0:反編譯java程式碼 1.3   apk檔案:待反編譯的檔案 2.反編譯流程: 2.1 反編譯資原

磁盤陣列 RAID 技術原理

十分 單獨 很好 不同的 raid1 miss 和數 會同 帶寬 RAID一頁通整理所有RAID技術、原理並配合相應RAID圖解,給所有存儲新人提供一個迅速學習、理解RAID技術的網上資源庫,本文將持續更新,歡迎大家補充及投稿。中國存儲網一如既往為廣大存儲界朋友提供免費、精

解決ajax跨域的方法原理之Cors方法

詳細 不同 htm 渲染 jsonp del 需要 methods href 1、神馬是跨域(Cross Domain) 對於端口和協議的不同,只能通過後臺來解決。 一句話:同一個ip、同一個網絡協議、同一個端口,三者都滿足就是同一個域,否則就是 跨域問題了。而為