Android lunch分析以及产品分支构建

一、背景

随着Android应用范围越来越广泛，用户对Android的需求也越来越趋于复杂，在开发Android应用以及底层产品驱动时，往往两套产品所需要的硬件平台就大不相同，而软件功能却相差不大。在这种纷繁的情况下，是否每种产品就需要一套源代码来维护。如果真这么做的话，那工作量就太大了。所以提出了产品分支的概念。在Android源码中提供了这么一种强大的功能。

公司正在Android上针对硬件平台做调整和开发，手上现有多种方案，有的需要无线wifi，有的底层芯片不一致。在这种情况下，公司使用Android lunch的方式使用一套源代码维护多种方案。

二、文档目的

当前网络上没有成体系的对Android lunch调用关系的研究，所以将Android lunch分析以及产品分支构建这份文档共享出来以帮助对此过程不了解的开发者。如有疑问和建议，请留言。

三、Android lunch调用关系

1.调用流程图：

Android lunch分析以及产品分支构建_第1张图片

2.调用关系分析

在编译Android产品的时候我们首先会导入. build/envsetup.sh ，然后lunch，这时候我们可以看到几个基本的产品版本。

从现象回推，首先查看envsetup.sh文件中的lunch函数：

具体分析见：lunch函数分析

在envsetup.sh中，有几个比较重要的函数。Lunch（），check_product()，print_lunch_menu()，get_build_var（），gettop，add_lunch_combo（），set_stuff_for_environment（），set_java_home（），findmakefile（）。

1）lunch

[plain] view plain copy

functionlunch()
{
localanswer
if["$1"];then
#lunch后面直接带参数
answer=$1
else
#lunch后面不带参数，则打印处所有的targetproduct和variant菜单提供用户选择
print_lunch_menu
echo-n"Whichwouldyoulike?[generic-eng]"
readanswer
fi
localselection=
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]*{1}quot;)
then
#如果answer是选择菜单的数字，则获取该数字对应的字符串
if[$answer-le${#LUNCH_MENU_CHOICES[@]}]
then
selection=${LUNCH_MENU_CHOICES[$(($answer-$_arrayoffset))]}
fi
#如果answer字符串匹配*-*模式(*的开头不能为-)
elif(echo-n$answer|grep-q-e"^[^\-][^\-]*-[^\-][^\-]*{1}quot;)
then
selection=$answer
fi
if[-z"$selection"]
then
echo
echo"Invalidlunchcombo:$answer"
return1
fi
#specialcasethesimulator
if["$selection"="simulator"]
then
#模拟器模式
exportTARGET_PRODUCT=sim
exportTARGET_BUILD_VARIANT=eng
exportTARGET_SIMULATOR=true
exportTARGET_BUILD_TYPE=debug
else
#将product-variant模式种的product分离出来
localproduct=$(echo-n$selection|sed-e"s/-.*$//")
#检查product，调用关系check_product()->get_build_var()->build/core/config.mk
check_product$product
if[$?-ne0]
then
echo
echo"**Don'thaveaproductspecfor:'$product'"
echo"**Doyouhavetherightrepomanifest?"
product=
fi
#将product-variant模式种的variant分离出来
localvariant=$(echo-n$selection|sed-e"s/^[^\-]*-//")
#检查之，看看是否在(useruserdebugeng)范围内
check_variant$variant
if[$?-ne0]
then
echo
echo"**Invalidvariant:'$variant'"
echo"**Mustbeoneof${VARIANT_CHOICES[@]}"
variant=
fi
if[-z"$product"-o-z"$variant"]
then
echo
return1
fi
exportTARGET_PRODUCT=$product
exportTARGET_BUILD_VARIANT=$variant
exportTARGET_SIMULATOR=false
exportTARGET_BUILD_TYPE=release
fi#!simulator

2）Check_product：

[plain] view plain copy

functioncheck_product()
{
T=$(gettop)
if[!"$T"];then
echo"Couldn'tlocatethetopofthetree.TrysettingTOP.">&2
return
fi
CALLED_FROM_SETUP=trueBUILD_SYSTEM=build/core\
TARGET_PRODUCT=$1TARGET_BUILD_VARIANT=\
TARGET_SIMULATOR=TARGET_BUILD_TYPE=\
TARGET_BUILD_APPS=\
get_build_varTARGET_DEVICE>/dev/null
#hidesuccessfulanswers,butallowtheerrorstoshow
}

检查指定的TARGET_PRODUCT是否允许，默认的有sim和generic。如果不允许，则输出错误信息，允许则不显示

3）Print_lunch_menu()

[plain] view plain copy

functionprint_lunch_menu()
{
localuname=$(uname)
echo
echo"You'rebuildingon"$uname
echo
echo"Lunchmenu...pickacombo:"
locali=1
localchoice
#循环查找LUNCH_MENU_CHOICES中的版本
forchoicein${LUNCH_MENU_CHOICES[@]}
do
echo"$i.$choice"
i=$(($i+1))
done
echo
}

该函数负责打印已经定义的版本

4）Get_build_var()

[plain] view plain copy

functionget_build_var()
{
T=$(gettop)
if[!"$T"];then
echo"Couldn'tlocatethetopofthetree.TrysettingTOP.">&2
return
fi
CALLED_FROM_SETUP=trueBUILD_SYSTEM=build/core\
make--no-print-directory-C"$T"-fbuild/core/config.mkdumpvar-$1
}

列出make脚本中某变量的值，当前为build/core/config.mk

5）Gettop()

[plain] view plain copy

functiongettop
{
localTOPFILE=build/core/envsetup.mk
if[-n"$TOP"-a-f"$TOP/$TOPFILE"];then
echo$TOP
#如果TOP不为空，并且envsetup.mk存在，函数直接返回TOP对应路径
else
#否则(指找不到envsetup.mk)如下处理
if[-f$TOPFILE];then
#Thefollowingcircumlocution(repeatedbelowaswell)ensures
#thatwerecordthetruedirectorynameandnotonethatis
#fakedupwithsymlinknames.
PWD=/bin/pwd
else
#Weredirectcdto/dev/nullincaseit'saliasedto
#acommandthatprintssomethingasaside-effect
#(likepushd)
localHERE=$PWD
T=
while[$!\(-f$TOPFILE$\)-a$$PWD!="/"$];do
cd..>/dev/null
T=`PWD=/bin/pwd`
done
cd$HERE>/dev/null
if[-f"$T/$TOPFILE"];then
echo$T
fi
fi
fi
}

返回当前android代码树的顶层路径。前提是当前路径位于android代码树中

6）Add_lunch_combo()

[plain] view plain copy

functionadd_lunch_combo()
{
localnew_combo=$1
localc
forcin${LUNCH_MENU_CHOICES[@]};do
if["$new_combo"="$c"];then
return
fi
done
LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]}$new_combo)
}

向环境变量LUNCH_MENU_CHOICES标识的列表中添加项

7）Set_stuff_for_environment()

[plain] view plain copy

functionset_stuff_for_environment()
{
settitle
set_java_home
setpaths
set_sequence_number
exportANDROID_BUILD_TOP=$(gettop)
}

设置android编译需要的环境变量

8）Set_java_home

[plain] view plain copy

functionset_java_home(){
if[!"$JAVA_HOME"];then
case`uname-s`in
Darwin)
exportJAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
;;
*)
exportJAVA_HOME=/usr/lib/jvm/java-6-sun
;;
esac
fi
}

设置java运行环境

9）findmakefile

[plain] view plain copy

functionfindmakefile()
{
TOPFILE=build/core/envsetup.mk
#Weredirectcdto/dev/nullincaseit'saliasedto
#acommandthatprintssomethingasaside-effect
#(likepushd)
localHERE=$PWD
T=
while[$!\(-f$TOPFILE$\)-a$$PWD!="/"$];do
T=$PWD
if[-f"$T/Android.mk"];then
echo$T/Android.mk
#如果找到Android.mk，echo出来的全路径将作为函数的返回值赋给某个变量
cd$HERE>/dev/null
return
fi
cd..>/dev/null
done
cd$HERE>/dev/null
}

此外还有一段比较重要的代码 [plain] view plain copy

#Executethecontentsofanyvendorsetup.shfileswecanfind.
forfin`/bin/lsvendor/*/vendorsetup.shvendor/*/build/vendorsetup.shdevice/*/*/vendorsetup.sh2>/dev/null`
do
echo"including$f"
.$f
done
unsetf

这段代码寻找vendor，build，device指定目录下的vendorsetup.sh。在vendorsetup.sh中定义了各版本的产品。

注：/dev/null 是 Unix/Linux 里的【无底洞】，任何的 output 送去了【无底洞】就再也没了，一般情况下，要是你不想看到 output 或者output 太多太大了，有可能把硬碟给挤爆了的时候，程序的设计就会考虑把 output 送到 /dev/null 了

四、Android lunch产品分支构建

背景：南京广义软件有限公司英文名generalizesoft，所以此处使用generalize来命名总的产品目录。其中generalizex和genx则是对公司产品共性的描述。每套产品将差异性的部分定义在自己产品当中。再调用共性的部分，形成一个完整的产品。这样做日后需要维护所有产品的时候只需要维护一套代码，而不是每套产品有一套代码，修改的内容页不方便管理。

1. 目录结构：

Android lunch分析以及产品分支构建_第2张图片

2. 搭建步骤

1）在device目录下创建一个名为generalize的文件夹

Android lunch分析以及产品分支构建_第3张图片

Android lunch分析以及产品分支构建_第4张图片

Android lunch分析以及产品分支构建_第5张图片

2）对其中的文件分别进行编辑。generalize.mk 对应我们第一套产品的mk文件，这是差异性文件。不同的产品需要不同的mk文件。而generalizex.mk是无差异文件，意为产品的共性。所以在generalize.mk中定义如下，它需要引用generalizex.mk中定义的部分。这样做方便以后的产品差异性对比。同样的，BoardConfigCommon.mk定义了generalize一系列产品板文件的共性。在调用关系中可以看出它们之间的关系

Android lunch分析以及产品分支构建_第6张图片

3） Vendorsetup文件是定义lunch内容的文件。在其中加上我们产品。

Android lunch分析以及产品分支构建_第7张图片

4）上述步骤处理完之后。运行envsetup.sh：

. build/envsetup.sh

之后再使用lunch，就可以看到基础效果图：

Android lunch分析以及产品分支构建_第8张图片

Android lunch分析以及产品分支构建_第9张图片

5）编译android

更多相关文章

随机推荐