3 Invoke ". build/envsetup.sh" from your shell to add the following functions to your environment:
4 - lunch: lunch <product_name>-<build_variant>
5 - tapas: tapas [<App1> <App2> ...] [arm|x86|mips|armv5|arm64|x86_64|mips64] [eng|userdebug|user]
6 - croot: Changes directory to the top of the tree.
7 - m: Makes from the top of the tree.
8 - mm: Builds all of the modules in the current directory, but not their dependencies.
9 - mmm: Builds all of the modules in the supplied directories, but not their dependencies.
10 To limit the modules being built use the syntax: mmm dir/:target1,target2.
11 - mma: Builds all of the modules in the current directory, and their dependencies.
12 - mmma: Builds all of the modules in the supplied directories, and their dependencies.
13 - cgrep: Greps on all local C/C++ files.
14 - ggrep: Greps on all local Gradle files.
15 - jgrep: Greps on all local Java files.
16 - resgrep: Greps on all local res/*.xml files.
17 - sgrep: Greps on all local source files.
18 - godir: Go to the directory containing a file.
20 Look at the source to view more functions. The complete list is:
25 for i in `cat $T/build/envsetup.sh | sed -n "/^[ \t]*function /s/function \([a-z_]*\).*/\1/p" | sort | uniq`; do
31 # Get the value of a build variable as an absolute path.
32 function get_abs_build_var()
36 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
39 (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
40 command make --no-print-directory -f build/core/config.mk dumpvar-abs-$1)
43 # Get the exact value of a build variable.
44 function get_build_var()
48 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
51 (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
52 command make --no-print-directory -f build/core/config.mk dumpvar-$1)
55 # check to see if the supplied product is one we can build
56 function check_product()
60 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
64 TARGET_BUILD_VARIANT= \
67 get_build_var TARGET_DEVICE > /dev/null
68 # hide successful answers, but allow the errors to show
71 VARIANT_CHOICES=(user userdebug eng)
73 # check to see if the supplied variant is valid
74 function check_variant()
76 for v in ${VARIANT_CHOICES[@]}
90 echo "Couldn't locate the top of the tree. Try setting TOP."
94 ##################################################################
96 # Read me before you modify this code #
98 # This function sets ANDROID_BUILD_PATHS to what it is adding #
99 # to PATH, and the next time it is run, it removes that from #
100 # PATH. This is required so lunch can be run more than once #
101 # and still have working paths. #
103 ##################################################################
105 # Note: on windows/cygwin, ANDROID_BUILD_PATHS will contain spaces
106 # due to "C:\Program Files" being in the path.
109 if [ -n "$ANDROID_BUILD_PATHS" ] ; then
110 export PATH=${PATH/$ANDROID_BUILD_PATHS/}
112 if [ -n "$ANDROID_PRE_BUILD_PATHS" ] ; then
113 export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/}
114 # strip leading ':', if any
115 export PATH=${PATH/:%/}
118 # and in with the new
119 prebuiltdir=$(getprebuilt)
120 gccprebuiltdir=$(get_abs_build_var ANDROID_GCC_PREBUILTS)
122 # defined in core/config.mk
123 targetgccversion=$(get_build_var TARGET_GCC_VERSION)
124 targetgccversion2=$(get_build_var 2ND_TARGET_GCC_VERSION)
125 export TARGET_GCC_VERSION=$targetgccversion
127 # The gcc toolchain does not exists for windows/cygwin. In this case, do not reference it.
128 export ANDROID_TOOLCHAIN=
129 export ANDROID_TOOLCHAIN_2ND_ARCH=
130 local ARCH=$(get_build_var TARGET_ARCH)
132 x86) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
134 x86_64) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
136 arm) toolchaindir=arm/arm-linux-androideabi-$targetgccversion/bin
138 arm64) toolchaindir=aarch64/aarch64-linux-android-$targetgccversion/bin;
139 toolchaindir2=arm/arm-linux-androideabi-$targetgccversion2/bin
141 mips|mips64) toolchaindir=mips/mips64el-linux-android-$targetgccversion/bin
144 echo "Can't find toolchain for unknown architecture: $ARCH"
145 toolchaindir=xxxxxxxxx
148 if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
149 export ANDROID_TOOLCHAIN=$gccprebuiltdir/$toolchaindir
152 if [ -d "$gccprebuiltdir/$toolchaindir2" ]; then
153 export ANDROID_TOOLCHAIN_2ND_ARCH=$gccprebuiltdir/$toolchaindir2
156 unset ANDROID_KERNEL_TOOLCHAIN_PATH
159 # Legacy toolchain configuration used for ARM kernel compilation
160 toolchaindir=arm/arm-eabi-$targetgccversion/bin
161 if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
162 export ARM_EABI_TOOLCHAIN="$gccprebuiltdir/$toolchaindir"
163 ANDROID_KERNEL_TOOLCHAIN_PATH="$ARM_EABI_TOOLCHAIN":
167 # No need to set ARM_EABI_TOOLCHAIN for other ARCHs
171 export ANDROID_DEV_SCRIPTS=$T/development/scripts:$T/prebuilts/devtools/tools
172 export ANDROID_BUILD_PATHS=$(get_build_var ANDROID_BUILD_PATHS):$ANDROID_TOOLCHAIN:$ANDROID_TOOLCHAIN_2ND_ARCH:$ANDROID_KERNEL_TOOLCHAIN_PATH$ANDROID_DEV_SCRIPTS:
174 # If prebuilts/android-emulator/<system>/ exists, prepend it to our PATH
175 # to ensure that the corresponding 'emulator' binaries are used.
178 ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/darwin-x86_64
181 ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/linux-x86_64
184 ANDROID_EMULATOR_PREBUILTS=
187 if [ -n "$ANDROID_EMULATOR_PREBUILTS" -a -d "$ANDROID_EMULATOR_PREBUILTS" ]; then
188 ANDROID_BUILD_PATHS=$ANDROID_BUILD_PATHS$ANDROID_EMULATOR_PREBUILTS:
189 export ANDROID_EMULATOR_PREBUILTS
192 export PATH=$ANDROID_BUILD_PATHS$PATH
194 unset ANDROID_JAVA_TOOLCHAIN
195 unset ANDROID_PRE_BUILD_PATHS
196 if [ -n "$JAVA_HOME" ]; then
197 export ANDROID_JAVA_TOOLCHAIN=$JAVA_HOME/bin
198 export ANDROID_PRE_BUILD_PATHS=$ANDROID_JAVA_TOOLCHAIN:
199 export PATH=$ANDROID_PRE_BUILD_PATHS$PATH
202 unset ANDROID_PRODUCT_OUT
203 export ANDROID_PRODUCT_OUT=$(get_abs_build_var PRODUCT_OUT)
204 export OUT=$ANDROID_PRODUCT_OUT
206 unset ANDROID_HOST_OUT
207 export ANDROID_HOST_OUT=$(get_abs_build_var HOST_OUT)
209 # needed for building linux on MacOS
211 #export HOST_EXTRACFLAGS="-I "$T/system/kernel_headers/host_include
214 function printconfig()
218 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
221 get_build_var report_config
224 function set_stuff_for_environment()
231 export ANDROID_BUILD_TOP=$(gettop)
232 # With this environment variable new GCC can apply colors to warnings/errors
233 export GCC_COLORS='error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01'
236 function set_sequence_number()
238 export BUILD_ENV_SEQUENCE_NUMBER=10
243 if [ "$STAY_OFF_MY_LAWN" = "" ]; then
244 local arch=$(gettargetarch)
245 local product=$TARGET_PRODUCT
246 local variant=$TARGET_BUILD_VARIANT
247 local apps=$TARGET_BUILD_APPS
248 if [ -z "$apps" ]; then
249 export PROMPT_COMMAND="echo -ne \"\033]0;[${arch}-${product}-${variant}] ${USER}@${HOSTNAME}: ${PWD}\007\""
251 export PROMPT_COMMAND="echo -ne \"\033]0;[$arch $apps $variant] ${USER}@${HOSTNAME}: ${PWD}\007\""
256 function addcompletions()
260 # Keep us from trying to run in something that isn't bash.
261 if [ -z "${BASH_VERSION}" ]; then
265 # Keep us from trying to run in bash that's too old.
266 if [ ${BASH_VERSINFO[0]} -lt 3 ]; then
270 dir="sdk/bash_completion"
271 if [ -d ${dir} ]; then
272 for f in `/bin/ls ${dir}/[a-z]*.bash 2> /dev/null`; do
279 function choosetype()
281 echo "Build type choices are:"
286 local DEFAULT_NUM DEFAULT_VALUE
288 DEFAULT_VALUE=release
290 export TARGET_BUILD_TYPE=
292 while [ -z $TARGET_BUILD_TYPE ]
294 echo -n "Which would you like? ["$DEFAULT_NUM"] "
295 if [ -z "$1" ] ; then
303 export TARGET_BUILD_TYPE=$DEFAULT_VALUE
306 export TARGET_BUILD_TYPE=release
309 export TARGET_BUILD_TYPE=release
312 export TARGET_BUILD_TYPE=debug
315 export TARGET_BUILD_TYPE=debug
319 echo "I didn't understand your response. Please try again."
323 if [ -n "$1" ] ; then
328 set_stuff_for_environment
332 # This function isn't really right: It chooses a TARGET_PRODUCT
333 # based on the list of boards. Usually, that gets you something
334 # that kinda works with a generic product, but really, you should
335 # pick a product by name.
337 function chooseproduct()
339 if [ "x$TARGET_PRODUCT" != x ] ; then
340 default_value=$TARGET_PRODUCT
345 export TARGET_PRODUCT=
347 while [ -z "$TARGET_PRODUCT" ]
349 echo -n "Which product would you like? [$default_value] "
350 if [ -z "$1" ] ; then
357 if [ -z "$ANSWER" ] ; then
358 export TARGET_PRODUCT=$default_value
360 if check_product $ANSWER
362 export TARGET_PRODUCT=$ANSWER
364 echo "** Not a valid product: $ANSWER"
367 if [ -n "$1" ] ; then
372 set_stuff_for_environment
375 function choosevariant()
377 echo "Variant choices are:"
380 for v in ${VARIANT_CHOICES[@]}
382 # The product name is the name of the directory containing
383 # the makefile we found, above.
388 local default_value=eng
391 export TARGET_BUILD_VARIANT=
392 while [ -z "$TARGET_BUILD_VARIANT" ]
394 echo -n "Which would you like? [$default_value] "
395 if [ -z "$1" ] ; then
402 if [ -z "$ANSWER" ] ; then
403 export TARGET_BUILD_VARIANT=$default_value
404 elif (echo -n $ANSWER | grep -q -e "^[0-9][0-9]*$") ; then
405 if [ "$ANSWER" -le "${#VARIANT_CHOICES[@]}" ] ; then
406 export TARGET_BUILD_VARIANT=${VARIANT_CHOICES[$(($ANSWER-1))]}
409 if check_variant $ANSWER
411 export TARGET_BUILD_VARIANT=$ANSWER
413 echo "** Not a valid variant: $ANSWER"
416 if [ -n "$1" ] ; then
422 function choosecombo()
435 set_stuff_for_environment
439 # Clear this variable. It will be built up again when the vendorsetup.sh
440 # files are included at the end of this file.
441 unset LUNCH_MENU_CHOICES
442 function add_lunch_combo()
446 for c in ${LUNCH_MENU_CHOICES[@]} ; do
447 if [ "$new_combo" = "$c" ] ; then
451 LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
454 # add the default one here
455 add_lunch_combo aosp_arm-eng
456 add_lunch_combo aosp_arm64-eng
457 add_lunch_combo aosp_mips-eng
458 add_lunch_combo aosp_mips64-eng
459 add_lunch_combo aosp_x86-eng
460 add_lunch_combo aosp_x86_64-eng
462 function print_lunch_menu()
466 echo "You're building on" $uname
468 echo "Lunch menu... pick a combo:"
472 for choice in ${LUNCH_MENU_CHOICES[@]}
489 echo -n "Which would you like? [aosp_arm-eng] "
497 selection=aosp_arm-eng
498 elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
500 if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
502 selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
504 elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
509 if [ -z "$selection" ]
512 echo "Invalid lunch combo: $answer"
516 export TARGET_BUILD_APPS=
518 local product=$(echo -n $selection | sed -e "s/-.*$//")
519 check_product $product
523 echo "** Don't have a product spec for: '$product'"
524 echo "** Do you have the right repo manifest?"
528 local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
529 check_variant $variant
533 echo "** Invalid variant: '$variant'"
534 echo "** Must be one of ${VARIANT_CHOICES[@]}"
538 if [ -z "$product" -o -z "$variant" ]
544 export TARGET_PRODUCT=$product
545 export TARGET_BUILD_VARIANT=$variant
546 export TARGET_BUILD_TYPE=release
550 set_stuff_for_environment
554 # Tab completion for lunch.
559 cur="${COMP_WORDS[COMP_CWORD]}"
560 prev="${COMP_WORDS[COMP_CWORD-1]}"
562 COMPREPLY=( $(compgen -W "${LUNCH_MENU_CHOICES[*]}" -- ${cur}) )
565 complete -F _lunch lunch
567 # Configures the build to build unbundled apps.
568 # Run tapas with one or more app names (from LOCAL_PACKAGE_NAME)
571 local arch="$(echo $* | xargs -n 1 echo | \grep -E '^(arm|x86|mips|armv5|arm64|x86_64|mips64)$' | xargs)"
572 local variant="$(echo $* | xargs -n 1 echo | \grep -E '^(user|userdebug|eng)$' | xargs)"
573 local density="$(echo $* | xargs -n 1 echo | \grep -E '^(ldpi|mdpi|tvdpi|hdpi|xhdpi|xxhdpi|xxxhdpi|alldpi)$' | xargs)"
574 local apps="$(echo $* | xargs -n 1 echo | \grep -E -v '^(user|userdebug|eng|arm|x86|mips|armv5|arm64|x86_64|mips64|ldpi|mdpi|tvdpi|hdpi|xhdpi|xxhdpi|xxxhdpi|alldpi)$' | xargs)"
576 if [ $(echo $arch | wc -w) -gt 1 ]; then
577 echo "tapas: Error: Multiple build archs supplied: $arch"
580 if [ $(echo $variant | wc -w) -gt 1 ]; then
581 echo "tapas: Error: Multiple build variants supplied: $variant"
584 if [ $(echo $density | wc -w) -gt 1 ]; then
585 echo "tapas: Error: Multiple densities supplied: $density"
591 x86) product=full_x86;;
592 mips) product=full_mips;;
593 armv5) product=generic_armv5;;
594 arm64) product=aosp_arm64;;
595 x86_64) product=aosp_x86_64;;
596 mips64) product=aosp_mips64;;
598 if [ -z "$variant" ]; then
601 if [ -z "$apps" ]; then
604 if [ -z "$density" ]; then
608 export TARGET_PRODUCT=$product
609 export TARGET_BUILD_VARIANT=$variant
610 export TARGET_BUILD_DENSITY=$density
611 export TARGET_BUILD_TYPE=release
612 export TARGET_BUILD_APPS=$apps
614 set_stuff_for_environment
620 local TOPFILE=build/core/envsetup.mk
621 if [ -n "$TOP" -a -f "$TOP/$TOPFILE" ] ; then
622 # The following circumlocution ensures we remove symlinks from TOP.
623 (cd $TOP; PWD= /bin/pwd)
625 if [ -f $TOPFILE ] ; then
626 # The following circumlocution (repeated below as well) ensures
627 # that we record the true directory name and not one that is
628 # faked up with symlink names.
633 while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
638 if [ -f "$T/$TOPFILE" ]; then
645 # Return driver for "make", if any (eg. static analyzer)
649 test "$WITH_STATIC_ANALYZER" = "0" && unset WITH_STATIC_ANALYZER
650 if [ -n "$WITH_STATIC_ANALYZER" ]; then
652 $T/prebuilts/misc/linux-x86/analyzer/tools/scan-build/scan-build \
653 --use-analyzer $T/prebuilts/misc/linux-x86/analyzer/bin/analyzer \
662 local DRV=$(getdriver $T)
664 $DRV make -C $T -f build/core/main.mk $@
666 echo "Couldn't locate the top of the tree. Try setting TOP."
670 function findmakefile()
672 TOPFILE=build/core/envsetup.mk
675 while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
677 if [ -f "$T/Android.mk" ]; then
690 local DRV=$(getdriver $T)
691 # If we're sitting in the root of the build tree, just do a
693 if [ -f build/core/envsetup.mk -a -f Makefile ]; then
696 # Find the closest Android.mk file.
697 local M=$(findmakefile)
699 local GET_INSTALL_PATH=
701 # Remove the path to top as the makefilepath needs to be relative
702 local M=`echo $M|sed 's:'$T'/::'`
704 echo "Couldn't locate the top of the tree. Try setting TOP."
705 elif [ ! "$M" ]; then
706 echo "Couldn't locate a makefile from the current directory."
710 GET-INSTALL-PATH) GET_INSTALL_PATH=$ARG;;
713 if [ -n "$GET_INSTALL_PATH" ]; then
715 ARGS=GET-INSTALL-PATH
720 ONE_SHOT_MAKEFILE=$M $DRV make -C $T -f build/core/main.mk $MODULES $ARGS
728 local DRV=$(getdriver $T)
734 local GET_INSTALL_PATH=
735 local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
736 local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
737 for DIR in $DIRS ; do
738 MODULES=`echo $DIR | sed -n -e 's/.*:\(.*$\)/\1/p' | sed 's/,/ /'`
739 if [ "$MODULES" = "" ]; then
742 DIR=`echo $DIR | sed -e 's/:.*//' -e 's:/$::'`
743 if [ -f $DIR/Android.mk ]; then
744 local TO_CHOP=`(\cd -P -- $T && pwd -P) | wc -c | tr -d ' '`
745 local TO_CHOP=`expr $TO_CHOP + 1`
746 local START=`PWD= /bin/pwd`
747 local MFILE=`echo $START | cut -c${TO_CHOP}-`
748 if [ "$MFILE" = "" ] ; then
749 MFILE=$DIR/Android.mk
751 MFILE=$MFILE/$DIR/Android.mk
753 MAKEFILE="$MAKEFILE $MFILE"
756 showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
757 GET-INSTALL-PATH) GET_INSTALL_PATH=$DIR;;
758 *) echo "No Android.mk in $DIR."; return 1;;
762 if [ -n "$GET_INSTALL_PATH" ]; then
763 ARGS=$GET_INSTALL_PATH
766 ONE_SHOT_MAKEFILE="$MAKEFILE" $DRV make -C $T -f build/core/main.mk $DASH_ARGS $MODULES $ARGS
768 echo "Couldn't locate the top of the tree. Try setting TOP."
775 local DRV=$(getdriver $T)
776 if [ -f build/core/envsetup.mk -a -f Makefile ]; then
780 echo "Couldn't locate the top of the tree. Try setting TOP."
782 local MY_PWD=`PWD= /bin/pwd|sed 's:'$T'/::'`
783 $DRV make -C $T -f build/core/main.mk $@ all_modules BUILD_MODULES_IN_PATHS="$MY_PWD"
790 local DRV=$(getdriver $T)
792 local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
793 local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
794 local MY_PWD=`PWD= /bin/pwd`
795 if [ "$MY_PWD" = "$T" ]; then
798 MY_PWD=`echo $MY_PWD|sed 's:'$T'/::'`
803 for DIR in $DIRS ; do
805 if [ "$MY_PWD" = "" ]; then
806 MODULE_PATHS="$MODULE_PATHS $DIR"
808 MODULE_PATHS="$MODULE_PATHS $MY_PWD/$DIR"
812 showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
813 *) echo "Couldn't find directory $DIR"; return 1;;
817 $DRV make -C $T -f build/core/main.mk $DASH_ARGS $ARGS all_modules BUILD_MODULES_IN_PATHS="$MODULE_PATHS"
819 echo "Couldn't locate the top of the tree. Try setting TOP."
829 echo "Couldn't locate the top of the tree. Try setting TOP."
835 TOPFILE=build/core/envsetup.mk
838 while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
840 if [ -f "$T/Android.mk" ]; then
847 echo "can't find Android.mk"
850 # simplified version of ps; output in the form
855 if [ "$1" = "--exact" ]; then
859 elif [ "$1" = "--help" -o "$1" = "-h" ]; then
860 echo "usage: qpid [[--exact] <process name|pid>"
866 qpid | \grep "$prepend$EXE$append"
870 | sed -e 1d -e 's/^[^ ]* *\([0-9]*\).* \([^ ]*\)$/\1 \2/'
878 if [ "$1" = "--exact" ]; then
885 local PID=`adb shell ps \
887 | \grep "$prepend$EXE$append" \
888 | sed -e 's/^[^ ]* *\([0-9]*\).*$/\1/'`
891 echo "usage: pid [--exact] <process name>"
896 # coredump_setup - enable core dumps globally for any process
897 # that has the core-file-size limit set correctly
899 # NOTE: You must call also coredump_enable for a specific process
900 # if its core-file-size limit is not set already.
901 # NOTE: Core dumps are written to ramdisk; they will not survive a reboot!
903 function coredump_setup()
905 echo "Getting root...";
909 echo "Remounting root parition read-write...";
910 adb shell mount -w -o remount -t rootfs rootfs;
913 adb shell mkdir -p /cores;
914 adb shell mount -t tmpfs tmpfs /cores;
915 adb shell chmod 0777 /cores;
917 echo "Granting SELinux permission to dump in /cores...";
918 adb shell restorecon -R /cores;
920 echo "Set core pattern.";
921 adb shell 'echo /cores/core.%p > /proc/sys/kernel/core_pattern';
926 # coredump_enable - enable core dumps for the specified process
927 # $1 = PID of process (e.g., $(pid mediaserver))
929 # NOTE: coredump_setup must have been called as well for a core
930 # dump to actually be generated.
932 function coredump_enable()
935 if [ -z "$PID" ]; then
936 printf "Expecting a PID!\n";
939 echo "Setting core limit for $PID to infinite...";
940 adb shell prlimit $PID 4 -1 -1
943 # core - send SIGV and pull the core for process
944 # $1 = PID of process (e.g., $(pid mediaserver))
946 # NOTE: coredump_setup must be called once per boot for core dumps to be
953 if [ -z "$PID" ]; then
954 printf "Expecting a PID!\n";
958 local CORENAME=core.$PID;
959 local COREPATH=/cores/$CORENAME;
965 while [ $(adb shell "[ -d /proc/$PID ] && echo -n yes") ]; do
966 printf "\tSending SIG%s to %d...\n" $SIG $PID;
967 adb shell kill -$SIG $PID;
971 adb shell "while [ ! -f $COREPATH ] ; do echo waiting for $COREPATH to be generated; sleep 1; done"
972 echo "Done: core is under $COREPATH on device.";
975 # systemstack - dump the current stack trace of all threads in the system process
976 # to the usual ANR traces file
977 function systemstack()
984 if [[ $1 =~ ^[0-9]+$ ]] ; then
987 local PIDLIST="$(pid $1)"
988 if [[ $PIDLIST =~ ^[0-9]+$ ]] ; then
990 elif [ "$PIDLIST" ] ; then
991 echo "more than one process: $1"
993 echo "no such process: $1"
996 echo "usage: stacks [pid|process name]"
1000 # Determine whether the process is native
1001 if adb shell ls -l /proc/$PID/exe | grep -q /system/bin/app_process ; then
1002 # Dump stacks of Dalvik process
1003 local TRACES=/data/anr/traces.txt
1004 local ORIG=/data/anr/traces.orig
1005 local TMP=/data/anr/traces.tmp
1007 # Keep original traces to avoid clobbering
1008 adb shell mv $TRACES $ORIG
1010 # Make sure we have a usable file
1011 adb shell touch $TRACES
1012 adb shell chmod 666 $TRACES
1014 # Dump stacks and wait for dump to finish
1015 adb shell kill -3 $PID
1016 adb shell notify $TRACES >/dev/null
1018 # Restore original stacks, and show current output
1019 adb shell mv $TRACES $TMP
1020 adb shell mv $ORIG $TRACES
1023 # Dump stacks of native process
1024 local USE64BIT="$(is64bit $PID)"
1025 adb shell debuggerd$USE64BIT -b $PID
1030 function gdbwrapper()
1037 function get_symbols_directory()
1039 echo $(get_abs_build_var TARGET_OUT_UNSTRIPPED)
1042 # Read the ELF header from /proc/$PID/exe to determine if the process is
1047 if [ "$PID" ] ; then
1048 if [[ "$(adb shell cat /proc/$PID/exe | xxd -l 1 -s 4 -ps)" -eq "02" ]] ; then
1058 function adb_get_product_device() {
1059 echo `adb shell getprop ro.product.device | sed s/.$//`
1062 # returns 0 when process is not traced
1063 function adb_get_traced_by() {
1064 echo `adb shell cat /proc/$1/status | grep -e "^TracerPid:" | sed "s/^TracerPid:\t//" | sed s/.$//`
1067 function gdbclient() {
1069 # 1. Check for ANDROID_SERIAL/multiple devices
1070 local PROCESS_NAME="n/a"
1073 if [ -z "$PID" ]; then
1074 echo "Usage: gdbclient <pid|processname> [port number]"
1077 local DEVICE=$(adb_get_product_device)
1079 if [ -z "$DEVICE" ]; then
1080 echo "Error: Unable to get device name. Please check if device is connected and ANDROID_SERIAL is set."
1084 if [ -n "$2" ]; then
1088 local ROOT=$(gettop)
1089 if [ -z "$ROOT" ]; then
1090 # This is for the situation with downloaded symbols (from the build server)
1091 # we check if they are available.
1095 local OUT_ROOT="$ROOT/out/target/product/$DEVICE"
1096 local SYMBOLS_DIR="$OUT_ROOT/symbols"
1098 if [ ! -d $SYMBOLS_DIR ]; then
1099 echo "Error: couldn't find symbols: $SYMBOLS_DIR does not exist or is not a directory."
1103 # let's figure out which executable we are about to debug
1105 # check if user specified a name -> resolve to pid
1106 if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
1108 PID=$(pid --exact $PROCESS_NAME)
1109 if [ -z "$PID" ]; then
1110 echo "Error: couldn't resolve pid by process name: $PROCESS_NAME"
1115 local EXE=`adb shell readlink /proc/$PID/exe | sed s/.$//`
1116 # TODO: print error in case there is no such pid
1117 local LOCAL_EXE_PATH=$SYMBOLS_DIR$EXE
1119 if [ ! -f $LOCAL_EXE_PATH ]; then
1120 echo "Error: unable to find symbols for executable $EXE: file $LOCAL_EXE_PATH does not exist"
1126 if [[ "$(file $LOCAL_EXE_PATH)" =~ 64-bit ]]; then
1132 local CPU_ABI=`adb shell getprop ro.product.cpu.abilist | sed s/.$//`
1133 # TODO: we assume these are available via $PATH
1134 if [[ $CPU_ABI =~ (^|,)arm64 ]]; then
1135 GDB=arm-linux-androideabi-gdb
1136 GDB64=aarch64-linux-android-gdb
1137 elif [[ $CPU_ABI =~ (^|,)arm ]]; then
1138 GDB=arm-linux-androideabi-gdb
1139 elif [[ $CPU_ABI =~ (^|,)x86_64 ]]; then
1140 GDB=x86_64-linux-androideabi-gdb
1141 elif [[ $CPU_ABI =~ (^|,)x86 ]]; then
1142 GDB=x86_64-linux-androideabi-gdb
1143 elif [[ $CPU_ABI =~ (^|,)mips64 ]]; then
1144 GDB=mipsel-linux-android-gdb
1145 GDB64=mips64el-linux-android-gdb
1146 elif [[ $CPU_ABI =~ (^|,)mips ]]; then
1147 GDB=mipsel-linux-android-gdb
1149 echo "Error: unrecognized cpu.abilist: $CPU_ABI"
1153 # TODO: check if tracing process is gdbserver and not some random strace...
1154 if [ $(adb_get_traced_by $PID) -eq 0 ]; then
1156 echo "Starting gdbserver..."
1157 # TODO: check if adb is already listening $PORT
1158 # to avoid unnecessary calls
1159 echo ". adb forward for port=$PORT..."
1160 adb forward tcp:$PORT tcp:$PORT
1161 echo ". starting gdbserver to attach to pid=$PID..."
1162 adb shell gdbserver$USE64BIT :$PORT --attach $PID &
1163 echo ". give it couple of seconds to start..."
1167 echo "It looks like gdbserver is already attached to $PID (process is traced), trying to connect to it using local port=$PORT"
1170 local OUT_SO_SYMBOLS=$SYMBOLS_DIR/system/lib$USE64BIT
1171 local OUT_VENDOR_SO_SYMBOLS=$SYMBOLS_DIR/vendor/lib$USE64BIT
1174 echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $SYMBOLS_DIR"
1175 echo >>"$OUT_ROOT/gdbclient.cmds" "set solib-search-path $OUT_SO_SYMBOLS:$OUT_SO_SYMBOLS/hw:$OUT_SO_SYMBOLS/ssl/engines:$OUT_SO_SYMBOLS/drm:$OUT_SO_SYMBOLS/egl:$OUT_SO_SYMBOLS/soundfx:$OUT_VENDOR_SO_SYMBOLS:$OUT_VENDOR_SO_SYMBOLS/hw:$OUT_VENDOR_SO_SYMBOLS/egl"
1176 local DALVIK_GDB_SCRIPT=$ROOT/development/scripts/gdb/dalvik.gdb
1177 if [ -f $DALVIK_GDB_SCRIPT ]; then
1178 echo >>"$OUT_ROOT/gdbclient.cmds" "source $DALVIK_GDB_SCRIPT"
1181 echo "Warning: couldn't find $DALVIK_GDB_SCRIPT - ART debugging options will not be available"
1183 echo >>"$OUT_ROOT/gdbclient.cmds" "target remote :$PORT"
1184 if [[ $EXE =~ (^|/)(app_process|dalvikvm)(|32|64)$ ]]; then
1185 echo >> "$OUT_ROOT/gdbclient.cmds" $ART_CMD
1188 echo >>"$OUT_ROOT/gdbclient.cmds" ""
1190 local WHICH_GDB=$GDB
1192 if [ -n "$USE64BIT" -a -n "$GDB64" ]; then
1196 gdbwrapper $WHICH_GDB "$OUT_ROOT/gdbclient.cmds" "$LOCAL_EXE_PATH"
1199 # gdbclient now determines whether the user wants to debug a 32-bit or 64-bit
1200 # executable, set up the approriate gdbserver, then invokes the proper host
1202 function gdbclient_old()
1204 local OUT_ROOT=$(get_abs_build_var PRODUCT_OUT)
1205 local OUT_SYMBOLS=$(get_abs_build_var TARGET_OUT_UNSTRIPPED)
1206 local OUT_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED)
1207 local OUT_VENDOR_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_VENDOR_SHARED_LIBRARIES_UNSTRIPPED)
1208 local OUT_EXE_SYMBOLS=$(get_symbols_directory)
1209 local PREBUILTS=$(get_abs_build_var ANDROID_PREBUILTS)
1210 local ARCH=$(get_build_var TARGET_ARCH)
1213 arm) GDB=arm-linux-androideabi-gdb;;
1214 arm64) GDB=arm-linux-androideabi-gdb; GDB64=aarch64-linux-android-gdb;;
1215 mips|mips64) GDB=mips64el-linux-android-gdb;;
1216 x86) GDB=x86_64-linux-android-gdb;;
1217 x86_64) GDB=x86_64-linux-android-gdb;;
1218 *) echo "Unknown arch $ARCH"; return 1;;
1221 if [ "$OUT_ROOT" -a "$PREBUILTS" ]; then
1223 if [ "$EXE" ] ; then
1225 if [[ $EXE =~ ^[^/].* ]] ; then
1226 EXE="system/bin/"$EXE
1233 if [ "$PORT" ] ; then
1240 if [ "$PID" ] ; then
1241 if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
1243 if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
1244 # that likely didn't work because of returning multiple processes
1245 # try again, filtering by root processes (don't contain colon)
1246 PID=`adb shell ps | \grep $3 | \grep -v ":" | awk '{print $2}'`
1247 if [[ ! "$PID" =~ ^[0-9]+$ ]]
1249 echo "Couldn't resolve '$3' to single PID"
1253 echo "WARNING: multiple processes matching '$3' observed, using root process"
1258 adb forward "tcp$PORT" "tcp$PORT"
1259 local USE64BIT="$(is64bit $PID)"
1260 adb shell gdbserver$USE64BIT $PORT --attach $PID &
1264 echo "If you haven't done so already, do this first on the device:"
1265 echo " gdbserver $PORT /system/bin/$EXE"
1267 echo " gdbserver $PORT --attach <PID>"
1271 OUT_SO_SYMBOLS=$OUT_SO_SYMBOLS$USE64BIT
1272 OUT_VENDOR_SO_SYMBOLS=$OUT_VENDOR_SO_SYMBOLS$USE64BIT
1274 echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $OUT_SYMBOLS"
1275 echo >>"$OUT_ROOT/gdbclient.cmds" "set solib-search-path $OUT_SO_SYMBOLS:$OUT_SO_SYMBOLS/hw:$OUT_SO_SYMBOLS/ssl/engines:$OUT_SO_SYMBOLS/drm:$OUT_SO_SYMBOLS/egl:$OUT_SO_SYMBOLS/soundfx:$OUT_VENDOR_SO_SYMBOLS:$OUT_VENDOR_SO_SYMBOLS/hw:$OUT_VENDOR_SO_SYMBOLS/egl"
1276 echo >>"$OUT_ROOT/gdbclient.cmds" "source $ANDROID_BUILD_TOP/development/scripts/gdb/dalvik.gdb"
1277 echo >>"$OUT_ROOT/gdbclient.cmds" "target remote $PORT"
1278 # Enable special debugging for ART processes.
1279 if [[ $EXE =~ (^|/)(app_process|dalvikvm)(|32|64)$ ]]; then
1280 echo >> "$OUT_ROOT/gdbclient.cmds" "art-on"
1282 echo >>"$OUT_ROOT/gdbclient.cmds" ""
1286 if [ "$USE64BIT" != "" ] ; then
1287 WHICH_GDB=$ANDROID_TOOLCHAIN/$GDB64
1288 # 32-bit exe / 32-bit platform
1289 elif [ "$(get_build_var TARGET_2ND_ARCH)" = "" ]; then
1290 WHICH_GDB=$ANDROID_TOOLCHAIN/$GDB
1291 # 32-bit exe / 64-bit platform
1293 WHICH_GDB=$ANDROID_TOOLCHAIN_2ND_ARCH/$GDB
1296 gdbwrapper $WHICH_GDB "$OUT_ROOT/gdbclient.cmds" "$OUT_EXE_SYMBOLS/$EXE"
1298 echo "Unable to determine build system output dir."
1307 find -E . -name .repo -prune -o -name .git -prune -o -type f -iregex '.*\.(c|h|cc|cpp|S|java|xml|sh|mk|aidl)' -print0 | xargs -0 grep --color -n "$@"
1314 find . -name .repo -prune -o -name .git -prune -o -type f -iregex '.*\.\(c\|h\|cc\|cpp\|S\|java\|xml\|sh\|mk\|aidl\)' -print0 | xargs -0 grep --color -n "$@"
1319 function gettargetarch
1321 get_build_var TARGET_ARCH
1326 find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f -name "*\.gradle" -print0 | xargs -0 grep --color -n "$@"
1331 find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f -name "*\.java" -print0 | xargs -0 grep --color -n "$@"
1336 find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f \( -name '*.c' -o -name '*.cc' -o -name '*.cpp' -o -name '*.h' \) -print0 | xargs -0 grep --color -n "$@"
1341 for dir in `find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -name res -type d`; do find $dir -type f -name '*\.xml' -print0 | xargs -0 grep --color -n "$@"; done;
1346 find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -type f -name 'AndroidManifest.xml' -print0 | xargs -0 grep --color -n "$@"
1351 find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -name sepolicy -type d -print0 | xargs -0 grep --color -n -r --exclude-dir=\.git "$@"
1358 find -E . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -type f -iregex '.*/(Makefile|Makefile\..*|.*\.make|.*\.mak|.*\.mk)' -print0 | xargs -0 grep --color -n "$@"
1363 find -E . -name .repo -prune -o -name .git -prune -o -type f -iregex '.*\.(c|h|cpp|S|java|xml)' -print0 | xargs -0 grep --color -n -i "$@"
1370 find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -regextype posix-egrep -iregex '(.*\/Makefile|.*\/Makefile\..*|.*\.make|.*\.mak|.*\.mk)' -type f -print0 | xargs -0 grep --color -n "$@"
1375 find . -name .repo -prune -o -name .git -prune -o -regextype posix-egrep -iregex '.*\.(c|h|cpp|S|java|xml)' -type f -print0 | xargs -0 grep --color -n -i "$@"
1381 function getprebuilt
1383 get_abs_build_var ANDROID_PREBUILTS
1386 function tracedmdump()
1390 echo "Couldn't locate the top of the tree. Try setting TOP."
1393 local prebuiltdir=$(getprebuilt)
1394 local arch=$(gettargetarch)
1395 local KERNEL=$T/prebuilts/qemu-kernel/$arch/vmlinux-qemu
1398 if [ ! "$TRACE" ] ; then
1399 echo "usage: tracedmdump tracename"
1403 if [ ! -r "$KERNEL" ] ; then
1404 echo "Error: cannot find kernel: '$KERNEL'"
1408 local BASETRACE=$(basename $TRACE)
1409 if [ "$BASETRACE" = "$TRACE" ] ; then
1410 TRACE=$ANDROID_PRODUCT_OUT/traces/$TRACE
1413 echo "post-processing traces..."
1414 rm -f $TRACE/qtrace.dexlist
1416 if [ $? -ne 0 ]; then
1418 echo "*** Error: malformed trace. Did you remember to exit the emulator?"
1422 echo "generating dexlist output..."
1423 /bin/ls $ANDROID_PRODUCT_OUT/system/framework/*.jar $ANDROID_PRODUCT_OUT/system/app/*.apk $ANDROID_PRODUCT_OUT/data/app/*.apk 2>/dev/null | xargs dexlist > $TRACE/qtrace.dexlist
1424 echo "generating dmtrace data..."
1425 q2dm -r $ANDROID_PRODUCT_OUT/symbols $TRACE $KERNEL $TRACE/dmtrace || return
1426 echo "generating html file..."
1427 dmtracedump -h $TRACE/dmtrace >| $TRACE/dmtrace.html || return
1428 echo "done, see $TRACE/dmtrace.html for details"
1430 echo " traceview $TRACE/dmtrace"
1433 # communicate with a running device or emulator, set up necessary state,
1434 # and run the hat command.
1437 # process standard adb options
1439 if [ "$1" = "-d" -o "$1" = "-e" ]; then
1442 elif [ "$1" = "-s" ]; then
1446 local adbOptions=${adbTarget}
1447 #echo adbOptions = ${adbOptions}
1452 if [ "$targetPid" = "" ]; then
1453 echo "Usage: runhat [ -d | -e | -s serial ] target-pid"
1457 # confirm hat is available
1458 if [ -z $(which hat) ]; then
1459 echo "hat is not available in this configuration."
1463 # issue "am" command to cause the hprof dump
1464 local devFile=/data/local/tmp/hprof-$targetPid
1465 echo "Poking $targetPid and waiting for data..."
1466 echo "Storing data at $devFile"
1467 adb ${adbOptions} shell am dumpheap $targetPid $devFile
1468 echo "Press enter when logcat shows \"hprof: heap dump completed\""
1472 local localFile=/tmp/$$-hprof
1474 echo "Retrieving file $devFile..."
1475 adb ${adbOptions} pull $devFile $localFile
1477 adb ${adbOptions} shell rm $devFile
1479 echo "Running hat on $localFile"
1480 echo "View the output by pointing your browser at http://localhost:7000/"
1482 hat -JXmx512m $localFile
1485 function getbugreports()
1487 local reports=(`adb shell ls /sdcard/bugreports | tr -d '\r'`)
1489 if [ ! "$reports" ]; then
1490 echo "Could not locate any bugreports."
1495 for report in ${reports[@]}
1497 echo "/sdcard/bugreports/${report}"
1498 adb pull /sdcard/bugreports/${report} ${report}
1503 function getsdcardpath()
1505 adb ${adbOptions} shell echo -n \$\{EXTERNAL_STORAGE\}
1508 function getscreenshotpath()
1510 echo "$(getsdcardpath)/Pictures/Screenshots"
1513 function getlastscreenshot()
1515 local screenshot_path=$(getscreenshotpath)
1516 local screenshot=`adb ${adbOptions} ls ${screenshot_path} | grep Screenshot_[0-9-]*.*\.png | sort -rk 3 | cut -d " " -f 4 | head -n 1`
1517 if [ "$screenshot" = "" ]; then
1518 echo "No screenshots found."
1521 echo "${screenshot}"
1522 adb ${adbOptions} pull ${screenshot_path}/${screenshot}
1525 function startviewserver()
1528 if [ $# -gt 0 ]; then
1531 adb shell service call window 1 i32 $port
1534 function stopviewserver()
1536 adb shell service call window 2
1539 function isviewserverstarted()
1541 adb shell service call window 3
1546 adb shell input keyevent 3
1551 adb shell input keyevent 4
1556 adb shell input keyevent 82
1559 function smoketest()
1561 if [ ! "$ANDROID_PRODUCT_OUT" ]; then
1562 echo "Couldn't locate output files. Try running 'lunch' first." >&2
1567 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
1571 (\cd "$T" && mmm tests/SmokeTest) &&
1572 adb uninstall com.android.smoketest > /dev/null &&
1573 adb uninstall com.android.smoketest.tests > /dev/null &&
1574 adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTestApp.apk &&
1575 adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTest.apk &&
1576 adb shell am instrument -w com.android.smoketest.tests/android.test.InstrumentationTestRunner
1579 # simple shortcut to the runtest command
1584 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
1587 ("$T"/development/testrunner/runtest.py $@)
1591 if [[ -z "$1" ]]; then
1592 echo "Usage: godir <regex>"
1596 if [[ ! -f $T/filelist ]]; then
1597 echo -n "Creating index..."
1598 (\cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > filelist)
1603 lines=($(\grep "$1" $T/filelist | sed -e 's/\/[^/]*$//' | sort | uniq))
1604 if [[ ${#lines[@]} = 0 ]]; then
1610 if [[ ${#lines[@]} > 1 ]]; then
1611 while [[ -z "$pathname" ]]; do
1614 for line in ${lines[@]}; do
1615 printf "%6s %s\n" "[$index]" $line
1616 index=$(($index + 1))
1619 echo -n "Select one: "
1622 if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then
1623 echo "Invalid choice"
1626 pathname=${lines[$(($choice-1))]}
1629 pathname=${lines[0]}
1634 # Force JAVA_HOME to point to java 1.7 or java 1.6 if it isn't already set.
1636 # Note that the MacOS path for java 1.7 includes a minor revision number (sigh).
1637 # For some reason, installing the JDK doesn't make it show up in the
1638 # JavaVM.framework/Versions/1.7/ folder.
1639 function set_java_home() {
1640 # Clear the existing JAVA_HOME value if we set it ourselves, so that
1641 # we can reset it later, depending on the version of java the build
1644 # If we don't do this, the JAVA_HOME value set by the first call to
1645 # build/envsetup.sh will persist forever.
1646 if [ -n "$ANDROID_SET_JAVA_HOME" ]; then
1650 if [ ! "$JAVA_HOME" ]; then
1651 if [ -n "$LEGACY_USE_JAVA6" ]; then
1654 export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
1657 export JAVA_HOME=/usr/lib/jvm/java-6-sun
1663 export JAVA_HOME=$(/usr/libexec/java_home -v 1.7)
1666 export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
1671 # Keep track of the fact that we set JAVA_HOME ourselves, so that
1672 # we can change it on the next envsetup.sh, if required.
1673 export ANDROID_SET_JAVA_HOME=true
1677 # Print colored exit condition
1681 if [ $retval -ne 0 ]
1683 echo -e "\e[0;31mFAILURE\e[00m"
1685 echo -e "\e[0;32mSUCCESS\e[00m"
1690 function get_make_command()
1697 local start_time=$(date +"%s")
1698 $(get_make_command) "$@"
1700 local end_time=$(date +"%s")
1701 local tdiff=$(($end_time-$start_time))
1702 local hours=$(($tdiff / 3600 ))
1703 local mins=$((($tdiff % 3600) / 60))
1704 local secs=$(($tdiff % 60))
1706 if [ $ret -eq 0 ] ; then
1707 echo -n -e "#### make completed successfully "
1709 echo -n -e "#### make failed to build some targets "
1711 if [ $hours -gt 0 ] ; then
1712 printf "(%02g:%02g:%02g (hh:mm:ss))" $hours $mins $secs
1713 elif [ $mins -gt 0 ] ; then
1714 printf "(%02g:%02g (mm:ss))" $mins $secs
1715 elif [ $secs -gt 0 ] ; then
1716 printf "(%s seconds)" $secs
1725 if [ "x$SHELL" != "x/bin/bash" ]; then
1726 case `ps -o command -p $$` in
1730 echo "WARNING: Only bash is supported, use of other shell would lead to erroneous results"
1735 # Execute the contents of any vendorsetup.sh files we can find.
1736 for f in `test -d device && find -L device -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null` \
1737 `test -d vendor && find -L vendor -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null`