android 学习笔记（八）building system8.5 shell脚本的学习

虽然接触她很久了，但只能说认识，。说道很熟，熟到称兄道弟，这是我的目标。想要混熟总得经历些事情，那么现在开始吧。最近在学习android，还是从android开始吧！

android源码中的build/envsetup.sh

顾名思义，这个脚本的主要作用是初始化编译环境，如环境变量。提供一些需要用到的函数，可作为指令调用。

我们看一下build/envsetup.sh 都干了什么事情。

1. 下面是剥离脚本中的函数部分：（写该脚本的老大，不明白为什么把执行的脚本和函数混在一块些？）

转自：

http://www.lupaworld.com/home.php?mod=space&uid=131820&do=blog&id=149463

?
2. envsetup.sh 提供的命令

function help()

function get_abs_build_var()

function get_build_var()

function check_product()

function check_variant()

function setpaths()

function printconfig()

function set_stuff_for_environment()

function set_sequence_number()

function settitle()

function addcompletions()

function choosetype()

function chooseproduct()

function choosevariant()

function choosecombo()

function add_lunch_combo()

function print_lunch_menu()

function lunch()

function _lunch()

function tapas()

function m()

function findmakefile()

function mm()

function mmm()

function croot()

function cproj()

function pid()

function systemstack()

function gdbclient()

function jgrep()

function cgrep()

function resgrep()

function tracedmdump()

function runhat()

function getbugreports()

function startviewserver()

function stopviewserver()

function isviewserverstarted()

function key_home()

function key_back()

function key_menu()

function smoketest()

function runtest()

function godir () {

function set_java_home()

3. 命令详解

help

显示帮助，列出提供的命令

get_abs_build_var

列出make脚本中某变量值作为绝对路径。

使用方法：

get_abs_build_var VAR_NAME

VAR_NAME是需要显示的make脚本中的变量。

例如:

get_abs_build_var TARGET_PRODUCT

返回

<Your Android Root>\<VAR_NAME Value>

get_build_var

列出make脚本中某变量的值。

Usage：

get_build_var VAR_NAME

VAR_NAME是需要显示的make脚本中的变量。

Return：

<VAR_NAME Value>

Example:

get_abs_build_var TARGET_PRODUCT

check_product

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

Usage:

check_product <YourTargetProduct>

Example：

check_product generic

check_variant

检查variant是否支持，支持则返回0，不支持则返回1。允许的variant列表定义在envsetup.sh中的VARIANT_CHOICES中，默认是user，userdebug，eng。定制android时，可以在VARIANT_CHOICES中添加vairant。

Usage：

check_variant <YourVariant>

Example：

check_variant eng

setpaths

奇次执行时，将ANDROID_BUILD_PATHS路径加到PATH中。偶次执行时，将ANDROID_BUILD_PATHS路径从PATH中去除。ANDROID_BUILD_PATHS包括android编译中要使用到的路径，例如ANDROID_EABI_TOOLCHAIN，ANDROID_TOOLCHAIN，ANDROID_QTOOLS，ANDROID_JAVA_TOOLCHAIN，ANDROID_PRODUCT_OUT等等。

Usage：

setpaths

printconfig

输出类似如下形势的配置信息。

============================================

PLATFORM_VERSION_CODENAME=AOSP

PLATFORM_VERSION=AOSP

TARGET_PRODUCT=generic

TARGET_BUILD_VARIANT=eng

TARGET_SIMULATOR=

TARGET_BUILD_TYPE=release

TARGET_BUILD_APPS=

TARGET_ARCH=arm

HOST_ARCH=x86

HOST_OS=linux

HOST_BUILD_TYPE=release

BUILD_ID=OPENMASTER

============================================

set_stuff_for_environment

依次调用settitle， set_java_home，setpaths，set_sequence_number。设置android编译需要的环境变量。

set_sequence_number

设置环境变量BUILD_ENV_SEQUENCE_NUMBER。

settitle

设置shell的prompt提示，PROMPT_COMMAND中加入TARGET_PRODUCT，TARGET_BUILD_VARIANT，和TARGET_BUILD_APPS等信息提示。

choosesim

配置环境变量TARGET_SIMULATOR。linux下会提示用户选择device或simulator。然后调用set_stuff_for_environment设置。

choosetype

配置环境变量TARGET_BUILD_TYPE_SIMULATOR。会提示用户选择release或debug。然后调用set_stuff_for_environment设置。

chooseproduct

配置环境变量TARGET_PRODUCT。会提示用户选择release或debug。然后调用set_stuff_for_environment设置。

choosevariant

配置环境变量TARGET_BUILD_VARIANT。会提示用户选择release或debug。

choosecombo

依次调用choosesim，choosetype，chooseproduct，choosevariant，set_stuff_for_environment配置，然后调用printconfig输出。

add_lunch_combo

向环境变量LUNCH_MENU_CHOICES标识的列表中添加项。envsetup.sh中默认添加了full-eng，full_x86-eng，和simulator。

print_lunch_menu

列出LUNCH_MENU_CHOICES中的所有选项。

lunch

点菜，用户选择/指定product，variant后，lunch命令设置环境变量TARGET_PRODUCT，TARGET_BUILD_VARIANT，TARGET_SIMULATOR，TARGET_BUILD_TYPE，随后调用set_stuff_for_environment设置，并printconfig显示。

Usage：

lunch [<YourProduct>-<YourBuildVariant>]

不给参数时，将提示用户选择。

Example：

lunch

lunch generic-eng

tapas

用户给定variant和一个或多个app name，就是LOCAL_PACKAGE_NAME的名字。tapas设定

export TARGET_PRODUCT=generic

export TARGET_BUILD_VARIANT=$variant

export TARGET_SIMULATOR=false

export TARGET_BUILD_TYPE=release

export TARGET_BUILD_APPS=$apps

Usage：

tapas <YourVariant>? <YourAppName>*

?代表可选，*代表0个，1个或多个。YourVariant 和YourAppName的次序可颠倒。

Example：

tapas user Calculator Calender

gettop

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

m

等价于在当前android代码树的顶层路径下执行make命令。

findmakefile

查找当前或最接近自己的祖辈路径上的Android.mk，返回Android.mk的路径，假设当前路径处于android代码树中。

mm

如果当前路径是代码树顶层，则mm相当于make。如果是深层，测mm相当于

ONE_SHOT_MAKEFILE=$M make -C $T files $@

$M是findmakefile发现的Android.mk，$T是代码树顶层路径，files是main.mk中定义的phony goal，就是完成$M对应目录范围内，所有android需编译的modules以及辅助说明txt文件。

mmm

给定package的路径，则mm会make相应的package。

例如，

mmm package/apps/Calculator

croot

改变当前路径到代码树顶层。

cproj

改变当前路径到最近的还有Android.mk文件的祖父辈路径。

pid

使用adb shell ps命令列出手机上指定名字的进程的pid。

Usage:

pid <YourName>

systemstack

使用kill -3system_server将系统进程中的线程信息写入/data/anr/traces.txt。

gdbclient

建立gdb调试环境，包括两步，手机上运行gdbserver，本机上运行arm-eabi-gdb。

Usage：

gdbclient <EXE> <PORT> <AppName>

EXE: AppName的执行名。

PORT：gdbserver的端口，例如, 192.168.2.102:5039

AppName：手机中ps列出的app名字，据此查pid。

sgrep

查找当前目录及子目录中所有.c，.h，.cpp，.S，.java，.mk，.xml，.sh文件，即源码文件中包含特定单词的行，并颜色显示输出。

Usage：

sgrep <YourWord>

Example:

sgrep Calendar

jgrep

同sgrep，但只查.java文件。

cgrep

同sgrep，但只查c相关的文件，即.c，.cc，.cpp，.h文件。

resgrep

同sgrep，但只查res相关的.xml文件。

mgrep

同sgrep，但只查make相关的脚本文件，包括Makefile文件，Makefile目录下的所有文件，.make文件，.mak文件和.mk文件。

treegrep

查找当前目录及子目录中所有.c，.h，.cpp，.S，.java，.xml文件，即源码文件中包含特定单词的行，并颜色显示输出。

getprebuilt

输出prebuilt的路径。

tracedmdump

生成dexlist文件qtrace.dexlit，dmtrace数据文件dmtrace，和调用dmtracedump工具生成的dmtrace解析文件dmtrace.html，将生成文件放到指定路径。

Usage：

tracedmdump <YourDirName>

如果YourDirName中不含’\’，则将放置的路径是$ANDROID_PRODUCT_OUT/traces/YourDirName。

runhat

貌似使用kill -10的方法得到heap dump并取到本地。使用hat以http方式展现出来。hat可能是个lightweight http server，不曾用过。

getbugreports

将手机/sdcard/bugreports目录下的文件下载到本地并压缩打包。

startviewserver

用指定端口启动viewserver。

Usage：

startviewserver <Port>

不指定端口，则默认4939。

stopviewserver

关闭viewserver。

isviewserverstarted

检查viewserver是否可用。

smoketest

编译smoketest并安装手机运行。

runtest

运行development/testrunner/runtest.py $@

godir

给出一个词，godir会输出一个路径列表供用户选择要进入的路径。路径列表包含的路径满足，路径名中包含这个词，或这路径下的文件有文件名含这个词。out/路径下不考虑。

Usage：

godir <YourKey>

Usage：

godir Calculator

set_java_home

设置JAVA_HOME环境变量为/usr/lib/jvm/java-6-sun