http://www.cloudchou.com/android/post-134.html
准备好编译环境后,编译Rom的第一步是 source build/envsetup.sh,该步骤把envsetup.sh里的函数声明为当前会话终端可用的命令。这些命令能让我们切换目录,提交代码,编译Rom更方便。如果记不住所有命令,只要你记住hmm就可以了,也可通过hmm命令看到支持的命令列表。
1. 命令分类:
1.1 编译用的命令
命令名称 | 使用方式 | 说明 |
---|---|---|
breakfast 别名bib | breakfast [product] 示例: breakfast i9100 breakfast cm_i9100-userdebug | 选择产品 product格式: device 或者 device-build_variant 先从网上下载cm支持的产品列表 product是用户要编译的目标产品,例如find5或者i9100 如果选择device-build_variant,并且是cm支持的device,一般会以cm_开头,比如cm_i9100 如果未选择编译产品,那么会弹出许多product,让用户选择 这里的product列表仅包含从网上下载的产品,不包含只有本地支持的产品 |
lunch | lunch [product] 示例: lunch cm_i9100-userdebug | 选择产品 product格式: build-build_variant 不再从网上下载产品列表, 如果[product]为空,意味着未选择编译产品,也会弹出许多product,让用户选择, 这里的product列表是用户在执行source build/envsetup.sh时,including了一些shell脚本,从而添加至产品列表的 |
brunch | brunch [product] | 选择产品并编译 product格式: device 或者 device-build_variant 调用breakfast选择编译产品 然后调用mka bacon编译 |
m | m [targetlist] | 编译选中目标 示例:m otatools bacon 并没有调用schedtool 充分利用所有核编译 |
mm | mm [mka] [targetlist] 示例: mm mka | 编译选中目标或者当前目录所在项目 若有mka,会调用mka进行编译 如果当前目录在顶层目录,会编译指定的所有目标 如果不在顶层目录,会编译当前目录所在的工程 |
mmm | mmm [directory:[modulist]] -arglist | 编译指定目录下的模块 directory可以为以下特殊目标: snod dist mka showcommands 若指定了mka,将利用mka进行编译 示例: mmm bootable/recovery: recovery 或者 mmm bootable/recovery |
mka | mka [targetlist] | 编译指定目标列表 将利用SCHED_BATCH编译指定所有目标,这样能充分利用所有CPU |
eat | eat | 刷机 在/cahce/recovery/command文件写上如下命令–sideload,重启设备至recovery,等待设备进入sideload状态,调用adb sideload进行刷机 |
omnom | omnmon [product] | 编译ROM并刷ROM至设备 |
tapas | tapas [<App1> <App2> …] [arm|x86|mips] [eng|userdebug|user] | Configures the build to build unbundled apps |
cmka | cmka [targetlist] | Cleans and builds using mka |
installboot | installboot | 安装boot 利用$OUT/recovery/root/etc/recovery.fstab找到boot所在分区以及分区类型,找到分区后,先将boot.img上传至/cache下,需要将内核需要加载的模块$OUT/system/lib/modules/*上传至/system/lib/modules/,然后如果是mtd分区就利用flash_image刷至相应的分区,否则利用dd刷至相应的分区 |
installrecovery | installrecovery | 安装recovery 与安装boot类似 |
1.2 查看代码时的辅助命令
命令名称 | 使用方式 | 说明 |
---|---|---|
cgrep | cgrep keyword | 在C,C++代码中搜索指定关键字 调用find查找C/C++代码文件(包括头文件),并且排除了不用的文件夹,在找到的文件中用grep搜索关键字 |
jgrep | jgrep keyword | 在java代码中搜索指定关键字 调用find查找java代码文件,并且排除了不用的文件夹,在找到的文件中用grep搜索关键字 |
resgrep | resgrep keyword | 在资源xml文件中搜索指定关键字 调用find在当前文件夹查找下res子目录里找xml文件,并且排除了不用的文件夹,在找到的文件中用grep搜索关键字 |
croot | croot | 切换至Android根目录 |
cout | cout | 切换至prodcut的out目录 |
cproj | cproj | 从某个工程的非常深的子目录,可迅速切换至工程的根目录 |
get_build_var | get_build_var build_var | 获取某个编译变量的值, 一般是路径 |
get_abs_build_var | get_abs_build_var | 获取某个编译变量的值, 是绝对路径 |
findmakefile | 打印当前目录所在工程的Android.mk的文件路径 | |
printconfig | 打印各种编译变量的值 | |
print_lunch_menu | 打印lunch可选择的各种product | |
godir | 切换至用户输入的文件所在的目录 | |
repodiff | 调用git进行diff,查看当前修改的东西 |
1.3 辅助函数
命令名称 | 使用方式 | 说明 |
---|---|---|
add_lunch_combo | 增加调用lunch命令时的选择项 示例: add_lunch_combo full_galaxys2att-eng | |
check_product | 检查产品看CM是否能支持编译 | |
check_variant | 检查TARGET_BUILD_VARIANT,看其值是否有效,可能的值只能为user,userdebug,eng | |
choosecombo | 调用choosetype,chooseproduct,choosevariant等函数,确定TARGET_PRODUCT,TARGET_BUILD_TYPE,TARGET_BUILD_VARIANT | |
chooseproduct | 让用户输入一个product的名字,默认为full,最终确定TARGET_PRODUCT, | |
choosetype | 选择编译类型即TARGET_BUILD_TYPE,可能的值为debug,release | |
choosevariant | 让用户选择编译变量TARGET_BUILD_VARIANT,可能的值为user,userdebug,eng | |
dopush | alias mmp=’dopush mm’ alias mmmp=’dopush mmm’ alias mkap=’dopush mka’ alias cmkap=’dopush cmka’ | |
fixup_common_out_dir | 建立$(OUT_DIR)/target/common目录 | |
getprebuilt | 得到prebuilt的路径 | |
getsdcardpath | 获取Sd卡路径 | |
gettargetarch | 获取TARGET_ARCH的值 | |
gettop | 获取Android源码根目录 | |
set_java_home | 设置java的主目录 | |
setpaths | 将编译要用到的一些路径添加到环境变量PATH里 | |
set_sequence_number | export BUILD_ENV_SEQUENCE_NUMBER=10 | |
set_stuff_for_environment | 设置PROMPT_COMMAND变量,java_home,PATH目录,set_sequence_number | |
settitle | 如果STAY_OFF_MY_LAWN为空,设置PROMPT_COMMAND变量,会改变SecureCrt终端窗口显示的名字 |
1.4 调试相关
命令名称 | 使用方式 | 说明 |
---|---|---|
gdbclient | gdbclient exename (progname|pid) | gdb调试 |
pid | pid exename | 查看某个可执行程序对应的进程id |
getbugreports | 将bug报告从设备上拉到本地,bug报告存放于目录/sdcard/bugreports, | |
getlastscreenshot | 获取最后一张截图 | |
getscreenshotpath | 获取屏幕截图的路径 | |
isviewserverstarted | 判断viewserver是否已启动 adb shell service call window 3 | |
key_back | 模拟按返回键 | |
key_home | 模拟按Home键 | |
key_menu | 模拟按菜单键 | |
runtest | 调用development/testrunner/runtest.py,进行测试 | |
smoketest | 利用SmokeTestApp.apk,SmokeTest.apk对系统进行一个smoke test | |
startviewserver | adb shell service call window 1 i32 $port | |
stopviewserver | adb shell service call window 2 | |
systemstack | dump the current stack trace of all threads in the system process to the usual ANR traces file | |
tracedmdump | 调用q2dm将系统堆栈导出来,并利用dmtracedump将其转为可读的html文件 |
1.5 提交代码相关命令
命令名称 | 使用方式 | 说明 |
---|---|---|
aospremote | Add git remote for matching AOSP repository | |
cmgerrit | 从CM拉源代码,或者将源代码提交到gerrit给比人审核,直接敲这个命令可得到该命令的使用帮助,最终调用Git完成命令功能 | |
cmrebase | 和git的rebase 衍合类似,我们不做代码提交,故此没必要 | |
cmremote | Add git remote for CM Gerrit Review | |
makerecipe | 将本地代码推送至git仓库 | |
repopick | Utility to fetch changes from Gerrit,可选项有–ignore-missing,–start-branch,–abandon-first,–auto-branch | |
reposync | Parallel repo sync using ionice and SCHED_BATCH |
2. source build/envsetup.sh 执行流程
envsetup.sh 定义了很多函数,除此之外还执行了其它操作,代码如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 | VARIANT_CHOICES=(user userdebug eng),# TARGET_BUILD_VARIANT变量的可能值 #LUNCH_MENU_CHOICES是供用户选择的prodcut列表, #每次source build/envsetup.sh时需重置变量LUNCH_MENU_CHOICES #不然后续的include vendor/cm/vendorsetup.sh时会继续添加产品至变量LUNCH_MENU_CHOICES里, #导致出现很多重复产品 unset LUNCH_MENU_CHOICES add_lunch_combo full-eng #默认添加full-eng,full_mips-eng等4个产品 add_lunch_combo full_x86-eng add_lunch_combo vbox_x86-eng add_lunch_combo full_mips-eng alias bib=breakfast#给breakfast起别名 complete -F _lunch lunch #给lunch添加tab提示 case `uname -s` in #定义sgrep函数 在所有工程类型代码里搜索 Darwin) function sgrep() { find -E . -name .repo -prune -o -name .git -prune -o -type f \ -iregex '.*\.(c|h|cpp|S|java|xml|sh|mk)' -print0 \ | xargs -0 grep --color -n "$@" } ;; *) function sgrep() { find . -name .repo -prune -o -name .git -prune -o -type f \ -iregex '.*\.\(c\|h\|cpp\|S\|java\|xml\|sh\|mk\)' -print0 \ | xargs -0 grep --color -n "$@" } ;; esac export -f cmremote export -f aospremote alias mmp='dopush mm' #定义更多编译后push到设备的函数的操作 alias mmmp='dopush mmm' alias mkap='dopush mka' alias cmkap='dopush cmka' if [ "x$SHELL" != "x/bin/bash" ]; then #只支持Bash终端 case `ps -o command -p $$` in *bash*) ;; *) echo "WARNING: Only bash is supported," \ "use of other shell would lead to erroneous results" ;; esac fi #Execute the contents of any vendorsetup.sh files we can find. #source vendor和device下能找到的所有vendorsetup.sh for f in `/bin/ls vendor/*/vendorsetup.sh vendor/*/*/vendorsetup.sh device/*/*/vendorsetup.sh 2> /dev/null` do echo "including $f" . $f done unset f #source目录 sdk/bash_completion vendor/cm/bash_completion下的bash脚本, #能提供tab提示 addcompletions export ANDROID_BUILD_TOP=$(gettop) |
2.1 执行的vendorsetup.sh有:
在envsetup.sh里将执行vendor和device目录及各自子目录下所有的vendorsetup.sh,这些vendorsetup.sh做的事情是调用add_lunch_combo将它们各自的产品添加到 LUNCH_MENU_CHOICES 变量里
#执行cm的vendorsetup.sh将从网上下载cm支持的产品列表,并添加至LUNCH_MENU_CHOICES
vendor/cm/vendorsetup.sh
#将添加mini_armv7a_neon产品 add_lunch_combo mini_armv7a_neon-userdebug
device/generic/armv7-a-neon/vendorsetup.sh
#add_lunch_combo mini_armv7a-userdebug
device/generic/armv7-a/vendorsetup.sh
#add_lunch_combo mini_mips-userdebug
device/generic/mips/vendorsetup.sh
#add_lunch_combo mini_x86-userdebug
device/generic/x86/vendorsetup.sh
#add_lunch_combo cm_jflteatt-eng
device/samsung/jflteatt/vendorsetup.sh
# add_lunch_combo full_panda-userdebug
device/ti/panda/vendorsetup.sh
# add_lunch_combo zte_blade-eng
#add_lunch_combo zte_blade-userdebug
device/zte/blade/vendorsetup.sh
2.2 执行的completion bash有:
在envsetup.sh里将执行sdk/bash_completion和vendor/cm/bash_completion目录下的bash脚本,这些bash脚本主要是为命令提供tab支持,有了这些tab支持,输入命令后如果某个选项忘记了,只需要敲tab键,就能获得提示,使用命令更加方便
including sdk/bash_completion/adb.bash
including vendor/cm/bash_completion/git.bash
including vendor/cm/bash_completion/repo.bash
分别对应adb,git,repo的tab提示