首页 > 代码库 > 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注意事项