首页 > 代码库 > Android集成一个新产品时,lunch的product name和device name注意事项

Android集成一个新产品时,lunch的product name和device name注意事项


Android系统lunch一个当前的Product大概流程包括下面几个部分:

1. lunch确定TARGET_PRODUCT。一般位于vendor/device/build/target/product中的vendorsetup.sh脚本来定义分别有user/eng/userdebug。

2. 开发check product的合理性。

通过载入vendor/device/build/target/product中的AndroidProduct.mk文件,记录其包括的各个.mk文件以及其所在的路径,作为当前的all_product_makefile.

通过选择的TARGET_PRODUCT filter到current_prodcut_makefile.

197 current_product_makefile :=
198 all_product_makefiles :=
199 $(foreach f, $(all_product_configs),200     $(eval _cpm_words := $(subst :,$(space),$(f)))201     $(eval _cpm_word1 := $(word 1,$(_cpm_words)))202     $(eval _cpm_word2 := $(word 2,$(_cpm_words)))203     $(if $(_cpm_word2),204         $(eval all_product_makefiles += $(_cpm_word2))205         $(if $(filter $(TARGET_PRODUCT),$(_cpm_word1)),206             $(eval current_product_makefile += $(_cpm_word2)),),207         $(eval all_product_makefiles += $(f))208         $(if $(filter $(TARGET_PRODUCT),$(basename $(notdir $(f)))),209             $(eval current_product_makefile += $(f)),)))
210 _cpm_words :=
211 _cpm_word1 :=
212 _cpm_word2 :=
213 current_product_makefile := $(strip $(current_product_makefile))
214 all_product_makefiles := $(strip $(all_product_makefiles))
取xxx.mk所在的路径notdir后的basename。

3 通过import-product当前的makefile文件,有可能是all,通常是current。这个import过程,基本是解析这个mk文件,并依据_product_var_list来生成一个全新的list变量。

 66 
 67 _product_var_list :=  68     PRODUCT_NAME  69     PRODUCT_MODEL  70     PRODUCT_LOCALES  71     PRODUCT_AAPT_CONFIG  72     PRODUCT_AAPT_PREF_CONFIG  73     PRODUCT_PACKAGES  74     PRODUCT_PACKAGES_DEBUG  75     PRODUCT_PACKAGES_ENG  76     PRODUCT_PACKAGES_TESTS \
这些变量须要在我们Product文件夹下进行定义并赋值,当中相关赋值决定了这个Product是否能通过lunch的Product check。

4. 当对相关的mk文件进行var list的生成后组成全新的变量名:

PRODUCT.device/"vendor"/*/"device_name"/xxx.mk.PRODUCT_NAME = 我们自定义的产品名字.

当中*号可代表存在多级文件夹下的xxx.mk.即/*/会自己主动跨越多级文件夹找到须要的目标文件。

5. resolve-short-product-name

resolve-short-product-name函数定义在build/core/product.mk文件里。

该函数的本质是依据TARGET_PRODUCT来与我们之前已经依据xxx.mk生成这个var list中的带PRODUCT_NAME字段的变量值做match匹配。终于假设匹配的话。就把这个变量中属于这个xxx.mk文件的路径作为返回值返回。

这个过程假设出现no matches ,则说明尽管我们创建的文件结构尽管正常,但当Product相关的xxx.mk文件里指定的PRODUCT_NAME与我们lunch申明的值时是不相互匹配的。则说明这个lunch选择的product的不合理的,须要又一次选择。或者说这个product name须要改动。。

lunch选择的TARGET_PRODUCT作用首先是定位xxx,mk文件结构是正常的。如lunch fish。则一般须要定义fish,mk文件。

但终于TARGET_PRODUCT进一步的作用在于须要和详细fish,mk中的PRODUCT_NAME的值相互match,才会通过match过程。


6. 上述过程终于目的是通过PRODUCT来确定TARGET_DEVICE,从而找到这个device

device最直接的体现是这个xxx,mk中定义的PRODUCT_DEVICE值是须要作为一个文件夹名的,由于兴许在envsetup.mk中查找device相关的boardconfig.mk时,须要在device和vendor的文件夹下查找-maxdepath 4 -path */$(TARGET_DEVICE)/BoradConfig,mk(TARGET_DEVICE,值是由xxx,mk中定义的PRODUCT_DEVICE来决定)。


总结:

上述描写叙述大致能够说明在定义一个vendor下须要公布的Product时,我们应该先定义一个device_name作为当前Product的一个大文件夹,在这个文件夹下定义一个xxx,mk文件,这个xxx.mk中须要指定PRODUCT_DEVICE和文件夹名一致,然后定义PRODUCT_NAME。再去lunch 中定义同样的一个name,能够有user/eng等类型可选。在处理好这些后须要将xxx命名为这个PRODUCT_NAME即TARGET_PRODUCT相应的数值。

之所以须要这样做的目的是为了顺利在all Product makefile文件里提取和TARGET_Product相一致的mk文件作为当前文件。

/device/gzz/fish/下基本文件:

1.先定义一个xxx.mk。xxx须要由PRODUCT_NAME决定。即两者一致:

PRODUCT_NAME := my_fish
PRODUCT_DEVICE := fish

device name两者一致

2.切换文件名称为my_fish.mk,确保Product name一致

3. AndroidProduct.mk:

PRODUCT_MAKEFILES := $(LOCAL_DIR)/my_fish.mk

4. vendorsetup,sh

add_lunch_combo my_fish-eng,确保Product name一致

5. 其它相关如boardconfig.mk等.


须要说明的是定义的Product和device name两者是能够不一致的,后者作为在out/target/product/fish/编译的输出。


lunch在处理时从下到上開始处理,TARGET_PRODCUTmy_fish假设无法从全部的Product makefile匹配my_fish.mk文件的话,lunch失败。

假设my_fish.mk文件被解析并生成var list后。再与my_fish匹配,假设PRODUCT_NAME与my_fish不一致,则match失败。

match成功并找到device name后确定TAEGET_DEVICE来自于PRODUCT_DEVICE如这里的fish。假设所在的文件夹名不是fish。则报no device config失败。

 故各方面都须要保持一致。才干够通过一次lunch的查找,Android非常好的确保了系统进行编译时,整个编译环境是ok的,且是你所须要的Product。











Android集成一个新产品时,lunch的product name和device name注意事项