参考: https://wiki.cyanogenmod.org/w/Envsetup_help
它是一个.sh文件,用source后就生成android编译相关函数,具体如下。
速查
Invoking $ source build/envsetup.sh
from your shell adds several functions to the build environment. These are listed below with short descriptions. Reference build/envsetup.sh
for the most recent list of commands.
函数 | 作用 | 示例 |
function help() | 显示帮助信息 | |
function get_abs_build_var() | 获取绝对变量 | 列出make脚本中某变量的值,前缀上当前路径。ref dumpvar.mk 使用方法: |
function get_build_var() | 获取绝对变量 | 列出make脚本中某变量的值。ref dumpvar.mk Usage: get_build_var VAR_NAME VAR_NAME是需要显示的make脚本中的变量。 Return: <VAR_NAME Value> Example: get_abs_build_var TARGET_PRODUCT |
function check_product() | 检查product | 检查指定的TARGET_PRODUCT是否允许,默认的有sim和generic。如果不允许,则输出错误信息,允许则无回显。 Usage: check_product <YourTargetProduct> Example: check_product generic |
function check_variant() | 检查变量 | 检查variant是否支持,支持则返回0,不支持则返回1。允许的variant列表定义在envsetup.sh中的VARIANT_CHOICES中, 默认是user,userdebug,eng。定制android时,可以在VARIANT_CHOICES中添加vairant。 |
function 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等等。 |
function 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 ============================================ |
function set_stuff_for_environment() | 设置环境变量 | 依次调用settitle, set_java_home,setpaths,set_sequence_number。设置android编译需要的环境变量。 |
function set_sequence_number() | 设置序号 | 输出环境变量BUILD_ENV_SEQUENCE_NUMBER。 |
function settitle() | 设置标题 | 设置shell的prompt提示,PROMPT_COMMAND中加入TARGET_PRODUCT,TARGET_BUILD_VARIANT, 和TARGET_BUILD_APPS等信息提示。 |
function choosesim() | 配置环境变量TARGET_SIMULATOR。linux下会提示用户选择device或simulator。然后调用set_stuff_for_environment设置。 | |
function choosetype() | 设置type | 配置环境变量TARGET_BUILD_TYPE_SIMULATOR。会提示用户选择release或debug。然后调用set_stuff_for_environment设置。 |
function chooseproduct() | 设置product | 配置环境变量TARGET_PRODUCT。会提示用户选择release或debug。然后调用set_stuff_for_environment设置。 |
function choosevariant() | 设置variant | 配置环境变量TARGET_BUILD_VARIANT。会提示用户选择release或debug。 |
function tapas() | 功能同choosecombo | 用户给定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 |
function choosecombo() | 设置编译参数 | 依次调用choosesim,choosetype,chooseproduct,choosevariant,set_stuff_for_environment配置,然后调用printconfig输出。 |
function add_lunch_combo() | 添加lunch项目 | 向环境变量LUNCH_MENU_CHOICES标识的列表中添加项。envsetup.sh中默认添加了full-eng,full_x86-eng,和simulator。 |
function print_lunch_menu() | 打印lunch列表 | 列出LUNCH_MENU_CHOICES中的所有选项。 |
function lunch() | 配置lunch | 点菜,用户选择/指定product,variant后,lunch命令设置环境变量TARGET_PRODUCT,TARGET_BUILD_VARIANT, TARGET_SIMULATOR,TARGET_BUILD_TYPE,随后调用set_stuff_for_environment设置,并printconfig显示。 不给参数时,将提示用户选择。 |
function gettop() | 返回当前android代码树的顶层路径。前提是当前路径位于android代码树中。 | |
function m() | make from top | 等价于在当前android代码树的顶层路径下执行make命令。 |
function mm() | make from current directory | 如果当前路径是代码树顶层,则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文件。 |
function mmm() | make the supplied directories | 给定package的路径,则mm会make相应的package。 例如,mmm package/apps/Calculator |
function findmakefile() | 查找makefile | 查找当前或最接近自己的祖辈路径上的Android.mk,返回Android.mk的路径,假设当前路径处于android代码树中。 |
function croot() | 回到根目录 | 改变当前路径到代码树顶层。 |
function cproj() | 改变当前路径到最近的还有Android.mk文件的祖父辈路径。 | |
function pid() | 使用adb shell ps命令列出手机上指定名字的进程的pid。 Usage: pid <YourName> | |
function systemstack() | 使用kill -3system_server将系统进程中的线程信息写入/data/anr/traces.txt。 | |
function gdbclient() | 建立gdb调试环境,包括两步,手机上运行gdbserver,本机上运行arm-eabi-gdb。 Usage: gdbclient <EXE> <PORT> <AppName> EXE: AppName的执行名。 PORT:gdbserver的端口,例如, 192.168.2.102:5039 | |
function sgrep() | 查找当前目录及子目录中所有.c,.h,.cpp,.S,.java,.mk,.xml,.sh文件,即源码文件中包含特定单词的行, 并颜色显示输出。 | |
function jgrep() | 查找Java文件 | 同sgrep,但只查.java文件。 |
function cgrep() | 查找c/cpp文件 | 同sgrep,但只查c相关的文件,即.c,.cc,.cpp,.h文件。 |
function resgrep() | 同sgrep,但只查res相关的.xml文件。 | |
function mgrep() | 同sgrep,但只查make相关的脚本文件,包括Makefile文件,Makefile目录下的所有文件,.make文件,.mak文件和.mk文件。 | |
function treegrep() | 查找当前目录及子目录中所有.c,.h,.cpp,.S,.java,.xml文件,即源码文件中包含特定单词的行,并颜色显示输出。 | |
function getprebuilt() | 输出prebuilt的路径。 | |
function tracedmdump() | 生成dexlist文件qtrace.dexlit,dmtrace数据文件dmtrace,和调用dmtracedump工具生成的dmtrace解析文件dmtrace.html, 将生成文件放到指定路径。 | |
function runhat() | 貌似使用kill -10的方法得到heap dump并取到本地。使用hat以http方式展现出来。hat可能是个lightweight http server,不曾用过。 | |
function getbugreports() | 将手机/sdcard/bugreports目录下的文件下载到本地并压缩打包。 | |
function startviewserver() | 用指定端口启动viewserver。 Usage: startviewserver <Port> 不指定端口,则默认4939。 | |
function stopviewserver() | 关闭viewserver。 | |
function isviewserverstarted() | 检查viewserver是否可用。 | |
function smoketest() | 编译smoketest并安装手机运行。 | |
function runtest() | 运行development/testrunner/runtest.py $@ | |
function godir() | 跳到指定目录 | 给出一个词,godir会输出一个路径列表供用户选择要进入的路径。路径列表包含的路径满足,路径名中包含这个词, 或这路径下的文件有文件名含这个词。out/路径下不考虑。 |
function set_java_home() | 设置JAVA_HOME环境变量为/usr/lib/jvm/java-6-sun。 |