Lichee(三) Android4.0的目标产品目录与Lichee的纽带---extract-bsp

时间:2022-02-27 04:37:50
通过《Lichee(二) 在sun4i_crane平台下的编译》介绍了编译lichee的基本情况,我们最终得到了编译后的结果如下:
out/ ├── android │   ├── bImage │   ├── lib │   ├── toolchain │   ├── uImage │   └── zImage └── u-boot.bin
小贴士:
    几种linux内核文件的区别:

1vmlinux  编译出来的最原始的内核文件,未压缩。

2zImage   vmlinux经过gzip压缩后的文件。

3bzImage bz表示“big zImage”,不是用bzip2压缩的。两者的不同之处在于,zImage解压缩内核到低端内存(第一个640K)bzImage解压缩内核到高端内存(1M以上)。如果内核比较小,那么采用zImagebzImage都行,如果比较大应该用bzImage

4uImage   U-boot专用的映像文件,它是在zImage之前加上一个长度为0x40tag

5vmlinuz  bzImage/zImage文件的拷贝或指向bzImage/zImage的链接。

6initrd   是“initial ramdisk”的简写。一般被用来临时的引导硬件到实际内核vmlinuz能够接管并继续引导的状态



我们可以清晰的看到,我们已经有了u-boot.bin uImage 已经lib目录下的modules,我们现在唯一缺少的就是根文件系统rootfs了,我们知道主流的cubieboard一开始可以使用主流的Linux操作系统各种发行版本,比如Ubuntu、Debian、Fedora、OpenSUSE、ArchLinux等等,详情请看《cubieboard开发板简介》一文,所以说,Lichee自动化编译的过程其实也包含了rootfs的编译,只是我们是基于Android的sun4i_crane平台的讨论,在《Lichee(二) 在sun4i_crane平台下的编译》一文中故意没有展开,首先本文还是沿着Lichee这条主线去探讨与Lichee相关的Android编译的过程,详细的Android编译的原理将在以后讨论!
让我们先看一下只有4句话的编译命令
source build/envsetup.sh
lunch 9
extract-bsp
make -j8


  • 一、 创建目标产品目录
   通常情况下,我们将自己的产品目录创建在device目录下,在较早的Android版本中,有时候将自己的目标产品放在vendor目录下,因为Android有一套完备的方法和脚本让我们仅仅修改目标产品目录的文件,就可以对系统进行配置,这里的内容非常多,后面的文章我们将详细地一一分析,这里仅仅提到与编译相关的地方
device/ ├── common ├── generic ├── google ├── sample ├── samsung ├── softwinner └── ti device目录下有各种平台的子目录,softwinner即代表全志的系列 common顾名思义即代表通用地 这里假定我们的产品名叫做mt7332,我们可以在device/softwinner中创建一个名为crane-mt7332的目录
device/softwinner/ ├── common ├── crane-3g ├── crane-common ├── crane-m1003h6 ├── crane-MID9742-sc3052 └── crane-mt7332 这就是我们自己创建的 首先,我们必须要创建一个名为 vendorsetup.sh的脚本文件,因为每个目标产品目录都有这个文件,这个脚本中只有一句话
add_lunch_combo crane_mt7332-eng


add_lunch_combo 是build/envsetup.sh中的一个脚本函数,可以理解为把你自己创建的目标产品注册到Android系统中去,否则将无法编译到目标产品 crane_mt7332-eng 就是对自己的目标产品的命名,eng是VARIANT其中的一种,代表编译的是工程机的类型,为了让Android系统指导你的目标机是eng、user、userdebug,这个名字必须是xxx-eng xxx-user xxx-userdebug等这种格式来命名,crane代表的是全志A10中的Android的项目

小贴士:
    VARIANT的官方解释eng This is the default flavor. A plain make is the same as make eng.
*       Installs modules tagged with: eng, debug, user, and/or development.
*       Installs non-APK modules that have no tags specified.
*       Installs APKs according to the product definition files, in addition to tagged APKs.
*       ro.secure=0
*       ro.debuggable=1
*       ro.kernel.android.checkjni=1
*       adb is enabled by default.
*       Setupwizard is optional

user make user
This is the flavor intended to be the final release bits.
*       Installs modules tagged with user.
*       Installs non-APK modules that have no tags specified.
*       Installs APKs according to the product definition files; tags are ignored for APK modules.
*       ro.secure=1
*       ro.debuggable=0
*       adb is disabled by default.
*       Enable dex pre-optimization for all TARGET projects in default to speed up device first boot-up

userdebug make userdebug
The same as user, except:
*       Also installs modules tagged with debug.
*       ro.debuggable=1
*       adb is enabled by default.


  • 二、指定目标产品(target product)
source build/envsetup.sh
lunch




小贴士:
source的含义
source在当前bash环境下执行命令,而scripts是启动一个子shell来执行命令。这样如果把设置环境变量(或alias等等)的命令写进scripts中,就只会影响子shell,无法改变当前的BASH,所以通过文件(命令列)设置环境变量时,要用source 命令。build/envsetup.sh脚本的工作最主要就是要设置环境变量,所以必须带source



编译Android之前,我们往往要执行这2条命令,让我们选择目标产品。这2条命令看似简单,其实蕴含着极大的智慧。它可以让Android独立于不同的架构、不同的处理器、不同的屏幕尺寸和朝向、不同的外设驱动等等,始终就是一套代码,所以编译Android之前必须要选择究竟编译的是哪一款目标产品。 build/envsetup.sh与编译有关的大致有以下function
function add_lunch_combo()            # 添加lunch项目
function print_lunch_menu()              # 打印lunch列表
function lunch()                    # 配置lunch,选择目标产品
function m()                   # Android根目录编译, 必须在lunch之后才能使用,用的较少,因为在根目录下编译一般使用make
function findmakefile()              # 查找makefile
function mm()                  # 编译当前目录下的Android.mk, 必须在lunch之后才能使用,用法示例 cd packages/apps/Music && mm
function mmm()                 # 编译指定目录下Android.mk, 必须在lunch之后才能使用 mmm packages/apps/Music 等用于 cd packages/apps/Music && mm

我们着重探讨一下lunch()
function lunch()
{
local answer
#如果你明确地知道lunch后的结果可以直接lunch $1 $1代表目标产品的编号 比如我通常就是使用lunch 9
if [ "$1" ] ; then
answer=$1
else
# 如果不知道是第几个,就调用print_lunch_menu,打印出所有的目标产品,然后read你的输入
print_lunch_menu
echo -n "Which would you like? [full-eng] "
read answer
fi

local selection=

if [ -z "$answer" ]
then
selection=full-eng
#如果lunch后有输入,只接受前2个字符的数字,忽略后面的字符
elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
then
if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
then
selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
fi
# 正则表达式 ^[^\-][^\-]*-[^\-][^\-]*$ 表示 字符串中间只能有一个字符'-' 例如 a-b符合条件, 而-a-b , a-b- a--b这些都不符合条件
elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
then
selection=$answer
fi

#选择是无效字符
if [ -z "$selection" ]
then
echo
echo "Invalid lunch combo: $answer"
return 1
fi

export TARGET_BUILD_APPS=
# sed -e "s/-.*$//") 是将字符'-'后面的都去掉,剩下前面的内容, 示例:crane_mt7332-eng 通过 sed -e "s/-.*$//"后,变成了crane_mt7332
local product=$(echo -n $selection | sed -e "s/-.*$//")
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
# sed -e "s/^[^\-]*-// 表示将字符 '-'之前的内容都去掉,只剩下后面的编译版本,示例:crane_mt7332-eng 通过 sed -e "s/-.*$//"后,变成了eng
local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
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
# 将获取的目标产品,VARIANT和类型写入到环境变量
export TARGET_PRODUCT=$product
export TARGET_BUILD_VARIANT=$variant
export TARGET_BUILD_TYPE=release

echo

set_stuff_for_environment
printconfig
}

目标产品的选择就此完成
实际过程如下:

$ source build/envsetup.sh
including device/samsung/maguro/vendorsetup.sh including device/samsung/tuna/vendorsetup.sh including device/softwinner/common/vendorsetup.sh including device/softwinner/crane-3g/vendorsetup.sh including device/softwinner/crane-m1003h6/vendorsetup.sh including device/softwinner/crane-MID9742-sc3052/vendorsetup.sh including device/softwinner/crane-mt7332/vendorsetup.sh including device/ti/panda/vendorsetup.sh including sdk/bash_completion/adb.bash
$ lunch You're building on Linux Lunch menu... pick a combo:      1. full-eng      2. full_x86-eng      3. vbox_x86-eng      4. full_maguro-userdebug      5. full_tuna-userdebug      6. crane_3g-eng      7. crane_m1003h6-eng      8. crane_MID9742_sc3052-userdebug      9. crane_mt7332-eng      10. full_panda-eng Which would you like? [full-eng] 9 ============================================ PLATFORM_VERSION_CODENAME=REL PLATFORM_VERSION=4.0.4 TARGET_PRODUCT=crane_mt7332 TARGET_BUILD_VARIANT=eng TARGET_BUILD_TYPE=release TARGET_BUILD_APPS= TARGET_ARCH=arm TARGET_ARCH_VARIANT=armv7-a-neon HOST_ARCH=x86 HOST_OS=linux HOST_BUILD_TYPE=release BUILD_ID=IMM76D ============================================

  • 三、 extract-bsp

extract-bsp是一个脚本函数,在device/softwinner/common/vendorsetup.sh 他也是在lunch的时候被执行的,也就是说如果先不执行lunch extract-bsp是无效的


让我们来看看extract-bsp

function lunch()
{
local answer
#如果你明确地知道lunch后的结果可以直接lunch $1 $1代表目标产品的编号 比如我通常就是使用lunch 9
if [ "$1" ] ; then
answer=$1
else
# 如果不知道是第几个,就调用print_lunch_menu,打印出所有的目标产品,然后read你的输入
print_lunch_menu
echo -n "Which would you like? [full-eng] "
read answer
fi

local selection=

if [ -z "$answer" ]
then
selection=full-eng
#如果lunch后有输入,只接受前2个字符的数字,忽略后面的字符
elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
then
if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
then
selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
fi
# 正则表达式 ^[^\-][^\-]*-[^\-][^\-]*$ 表示 字符串中间只能有一个字符'-' 例如 a-b符合条件, 而-a-b , a-b- a--b这些都不符合条件
elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
then
selection=$answer
fi

#选择是无效字符
if [ -z "$selection" ]
then
echo
echo "Invalid lunch combo: $answer"
return 1
fi

export TARGET_BUILD_APPS=
# sed -e "s/-.*$//") 是将字符'-'后面的都去掉,剩下前面的内容, 示例:crane_mt7332-eng 通过 sed -e "s/-.*$//"后,变成了crane_mt7332
local product=$(echo -n $selection | sed -e "s/-.*$//")
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
# sed -e "s/^[^\-]*-// 表示将字符 '-'之前的内容都去掉,只剩下后面的编译版本,示例:crane_mt7332-eng 通过 sed -e "s/-.*$//"后,变成了eng
local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
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
# 将获取的目标产品,VARIANT和类型写入到环境变量
export TARGET_PRODUCT=$product
export TARGET_BUILD_VARIANT=$variant
export TARGET_BUILD_TYPE=release

echo

set_stuff_for_environment
printconfig
}


总的来说,经行分析extract-bsp脚本发现,其实就是将lichee编译的结果输出到device/softwinner/vendor目录下,其实这个过程是为了android的编译在做准备。而Android的编译过程非常复杂,因为我们是要沿着Lichee这条主线继续走下去,但是不对Android的编译过程以及目标产品的概念进行简单地分析,又不能充分了解到function extract-bsp()这个函数的用处,实际上本文的真正用意就是要了解extract-bsp的过程和背景,这个函数也是联系Lichee和Android之间的纽带。本文在这个系列中第一次提到了Android BSP相关的知识,可能理解起来就有点困难了,Android的BSP是后面的重中之重,到时候可能还会花大力气分析本文已经提到的一些内容(比如目标目录的创建),这里也就简单带过了。