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 - godir: Go to the directory containing a file.
19 Look at the source to view more functions. The complete list is:
24 for i in `cat $T/build/envsetup.sh | sed -n "/^function /s/function \([a-z_]*\).*/\1/p" | sort`; do
30 # Get the value of a build variable as an absolute path.
31 function get_abs_build_var()
35 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
38 (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
39 command make --no-print-directory -f build/core/config.mk dumpvar-abs-$1)
42 # Get the exact value of a build variable.
43 function get_build_var()
47 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
50 (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
51 command make --no-print-directory -f build/core/config.mk dumpvar-$1)
54 # check to see if the supplied product is one we can build
55 function check_product()
59 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
63 TARGET_BUILD_VARIANT= \
66 get_build_var TARGET_DEVICE > /dev/null
67 # hide successful answers, but allow the errors to show
70 VARIANT_CHOICES=(user userdebug eng)
72 # check to see if the supplied variant is valid
73 function check_variant()
75 for v in ${VARIANT_CHOICES[@]}
89 echo "Couldn't locate the top of the tree. Try setting TOP."
93 ##################################################################
95 # Read me before you modify this code #
97 # This function sets ANDROID_BUILD_PATHS to what it is adding #
98 # to PATH, and the next time it is run, it removes that from #
99 # PATH. This is required so lunch can be run more than once #
100 # and still have working paths. #
102 ##################################################################
104 # Note: on windows/cygwin, ANDROID_BUILD_PATHS will contain spaces
105 # due to "C:\Program Files" being in the path.
108 if [ -n "$ANDROID_BUILD_PATHS" ] ; then
109 export PATH=${PATH/$ANDROID_BUILD_PATHS/}
111 if [ -n "$ANDROID_PRE_BUILD_PATHS" ] ; then
112 export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/}
113 # strip leading ':', if any
114 export PATH=${PATH/:%/}
117 # and in with the new
118 prebuiltdir=$(getprebuilt)
119 gccprebuiltdir=$(get_abs_build_var ANDROID_GCC_PREBUILTS)
121 # defined in core/config.mk
122 targetgccversion=$(get_build_var TARGET_GCC_VERSION)
123 targetgccversion2=$(get_build_var 2ND_TARGET_GCC_VERSION)
124 export TARGET_GCC_VERSION=$targetgccversion
126 # The gcc toolchain does not exists for windows/cygwin. In this case, do not reference it.
127 export ANDROID_TOOLCHAIN=
128 export ANDROID_TOOLCHAIN_2ND_ARCH=
129 local ARCH=$(get_build_var TARGET_ARCH)
131 x86) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
133 x86_64) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
135 arm) toolchaindir=arm/arm-linux-androideabi-$targetgccversion/bin
137 arm64) toolchaindir=aarch64/aarch64-linux-android-$targetgccversion/bin;
138 toolchaindir2=arm/arm-linux-androideabi-$targetgccversion2/bin
140 mips) toolchaindir=mips/mipsel-linux-android-$targetgccversion/bin
142 mips64) toolchaindir=mips/mips64el-linux-android-$targetgccversion/bin
145 echo "Can't find toolchain for unknown architecture: $ARCH"
146 toolchaindir=xxxxxxxxx
149 if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
150 export ANDROID_TOOLCHAIN=$gccprebuiltdir/$toolchaindir
153 if [ -d "$gccprebuiltdir/$toolchaindir2" ]; then
154 export ANDROID_TOOLCHAIN_2ND_ARCH=$gccprebuiltdir/$toolchaindir2
157 unset ANDROID_KERNEL_TOOLCHAIN_PATH
160 # Legacy toolchain configuration used for ARM kernel compilation
161 toolchaindir=arm/arm-eabi-$targetgccversion/bin
162 if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
163 export ARM_EABI_TOOLCHAIN="$gccprebuiltdir/$toolchaindir"
164 ANDROID_KERNEL_TOOLCHAIN_PATH="$ARM_EABI_TOOLCHAIN":
168 # No need to set ARM_EABI_TOOLCHAIN for other ARCHs
172 export ANDROID_DEV_SCRIPTS=$T/development/scripts:$T/prebuilts/devtools/tools
173 export ANDROID_BUILD_PATHS=$(get_build_var ANDROID_BUILD_PATHS):$ANDROID_TOOLCHAIN:$ANDROID_TOOLCHAIN_2ND_ARCH:$ANDROID_KERNEL_TOOLCHAIN_PATH$ANDROID_DEV_SCRIPTS:
175 # If prebuilts/android-emulator/<system>/ exists, prepend it to our PATH
176 # to ensure that the corresponding 'emulator' binaries are used.
179 ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/darwin-x86_64
182 ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/linux-x86_64
185 ANDROID_EMULATOR_PREBUILTS=
188 if [ -n "$ANDROID_EMULATOR_PREBUILTS" -a -d "$ANDROID_EMULATOR_PREBUILTS" ]; then
189 ANDROID_BUILD_PATHS=$ANDROID_BUILD_PATHS$ANDROID_EMULATOR_PREBUILTS:
190 export ANDROID_EMULATOR_PREBUILTS
193 export PATH=$ANDROID_BUILD_PATHS$PATH
195 unset ANDROID_JAVA_TOOLCHAIN
196 unset ANDROID_PRE_BUILD_PATHS
197 if [ -n "$JAVA_HOME" ]; then
198 export ANDROID_JAVA_TOOLCHAIN=$JAVA_HOME/bin
199 export ANDROID_PRE_BUILD_PATHS=$ANDROID_JAVA_TOOLCHAIN:
200 export PATH=$ANDROID_PRE_BUILD_PATHS$PATH
203 unset ANDROID_PRODUCT_OUT
204 export ANDROID_PRODUCT_OUT=$(get_abs_build_var PRODUCT_OUT)
205 export OUT=$ANDROID_PRODUCT_OUT
207 unset ANDROID_HOST_OUT
208 export ANDROID_HOST_OUT=$(get_abs_build_var HOST_OUT)
210 # If prebuilts/android-emulator/<system>/ exists, prepend it to our PATH
211 # to ensure that the corresponding 'emulator' binaries are used.
214 ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/darwin-x86_64
217 ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/linux-x86_64
220 ANDROID_EMULATOR_PREBUILTS=
223 if [ -n "$ANDROID_EMULATOR_PREBUILTS" -a -d "$ANDROID_EMULATOR_PREBUILTS" ]; then
224 PATH=$ANDROID_EMULATOR_PREBUILTS:$PATH
225 export ANDROID_EMULATOR_PREBUILTS
228 # needed for building linux on MacOS
230 #export HOST_EXTRACFLAGS="-I "$T/system/kernel_headers/host_include
233 function printconfig()
237 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
240 get_build_var report_config
243 function set_stuff_for_environment()
250 export ANDROID_BUILD_TOP=$(gettop)
251 # With this environment variable new GCC can apply colors to warnings/errors
252 export GCC_COLORS='error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01'
255 function set_sequence_number()
257 export BUILD_ENV_SEQUENCE_NUMBER=10
262 if [ "$STAY_OFF_MY_LAWN" = "" ]; then
263 local arch=$(gettargetarch)
264 local product=$TARGET_PRODUCT
265 local variant=$TARGET_BUILD_VARIANT
266 local apps=$TARGET_BUILD_APPS
267 if [ -z "$apps" ]; then
268 export PROMPT_COMMAND="echo -ne \"\033]0;[${arch}-${product}-${variant}] ${USER}@${HOSTNAME}: ${PWD}\007\""
270 export PROMPT_COMMAND="echo -ne \"\033]0;[$arch $apps $variant] ${USER}@${HOSTNAME}: ${PWD}\007\""
275 function addcompletions()
279 # Keep us from trying to run in something that isn't bash.
280 if [ -z "${BASH_VERSION}" ]; then
284 # Keep us from trying to run in bash that's too old.
285 if [ ${BASH_VERSINFO[0]} -lt 3 ]; then
289 dir="sdk/bash_completion"
290 if [ -d ${dir} ]; then
291 for f in `/bin/ls ${dir}/[a-z]*.bash 2> /dev/null`; do
298 function choosetype()
300 echo "Build type choices are:"
305 local DEFAULT_NUM DEFAULT_VALUE
307 DEFAULT_VALUE=release
309 export TARGET_BUILD_TYPE=
311 while [ -z $TARGET_BUILD_TYPE ]
313 echo -n "Which would you like? ["$DEFAULT_NUM"] "
314 if [ -z "$1" ] ; then
322 export TARGET_BUILD_TYPE=$DEFAULT_VALUE
325 export TARGET_BUILD_TYPE=release
328 export TARGET_BUILD_TYPE=release
331 export TARGET_BUILD_TYPE=debug
334 export TARGET_BUILD_TYPE=debug
338 echo "I didn't understand your response. Please try again."
342 if [ -n "$1" ] ; then
347 set_stuff_for_environment
351 # This function isn't really right: It chooses a TARGET_PRODUCT
352 # based on the list of boards. Usually, that gets you something
353 # that kinda works with a generic product, but really, you should
354 # pick a product by name.
356 function chooseproduct()
358 if [ "x$TARGET_PRODUCT" != x ] ; then
359 default_value=$TARGET_PRODUCT
364 export TARGET_PRODUCT=
366 while [ -z "$TARGET_PRODUCT" ]
368 echo -n "Which product would you like? [$default_value] "
369 if [ -z "$1" ] ; then
376 if [ -z "$ANSWER" ] ; then
377 export TARGET_PRODUCT=$default_value
379 if check_product $ANSWER
381 export TARGET_PRODUCT=$ANSWER
383 echo "** Not a valid product: $ANSWER"
386 if [ -n "$1" ] ; then
391 set_stuff_for_environment
394 function choosevariant()
396 echo "Variant choices are:"
399 for v in ${VARIANT_CHOICES[@]}
401 # The product name is the name of the directory containing
402 # the makefile we found, above.
407 local default_value=eng
410 export TARGET_BUILD_VARIANT=
411 while [ -z "$TARGET_BUILD_VARIANT" ]
413 echo -n "Which would you like? [$default_value] "
414 if [ -z "$1" ] ; then
421 if [ -z "$ANSWER" ] ; then
422 export TARGET_BUILD_VARIANT=$default_value
423 elif (echo -n $ANSWER | grep -q -e "^[0-9][0-9]*$") ; then
424 if [ "$ANSWER" -le "${#VARIANT_CHOICES[@]}" ] ; then
425 export TARGET_BUILD_VARIANT=${VARIANT_CHOICES[$(($ANSWER-1))]}
428 if check_variant $ANSWER
430 export TARGET_BUILD_VARIANT=$ANSWER
432 echo "** Not a valid variant: $ANSWER"
435 if [ -n "$1" ] ; then
441 function choosecombo()
454 set_stuff_for_environment
458 # Clear this variable. It will be built up again when the vendorsetup.sh
459 # files are included at the end of this file.
460 unset LUNCH_MENU_CHOICES
461 function add_lunch_combo()
465 for c in ${LUNCH_MENU_CHOICES[@]} ; do
466 if [ "$new_combo" = "$c" ] ; then
470 LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
473 # add the default one here
474 add_lunch_combo aosp_arm-eng
475 add_lunch_combo aosp_arm64-eng
476 add_lunch_combo aosp_mips-eng
477 add_lunch_combo aosp_mips64-eng
478 add_lunch_combo aosp_x86-eng
479 add_lunch_combo aosp_x86_64-eng
480 add_lunch_combo vbox_x86-eng
482 function print_lunch_menu()
486 echo "You're building on" $uname
488 echo "Lunch menu... pick a combo:"
492 for choice in ${LUNCH_MENU_CHOICES[@]}
509 echo -n "Which would you like? [aosp_arm-eng] "
517 selection=aosp_arm-eng
518 elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
520 if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
522 selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
524 elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
529 if [ -z "$selection" ]
532 echo "Invalid lunch combo: $answer"
536 export TARGET_BUILD_APPS=
538 local product=$(echo -n $selection | sed -e "s/-.*$//")
539 check_product $product
543 echo "** Don't have a product spec for: '$product'"
544 echo "** Do you have the right repo manifest?"
548 local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
549 check_variant $variant
553 echo "** Invalid variant: '$variant'"
554 echo "** Must be one of ${VARIANT_CHOICES[@]}"
558 if [ -z "$product" -o -z "$variant" ]
564 export TARGET_PRODUCT=$product
565 export TARGET_BUILD_VARIANT=$variant
566 export TARGET_BUILD_TYPE=release
570 set_stuff_for_environment
574 # Tab completion for lunch.
579 cur="${COMP_WORDS[COMP_CWORD]}"
580 prev="${COMP_WORDS[COMP_CWORD-1]}"
582 COMPREPLY=( $(compgen -W "${LUNCH_MENU_CHOICES[*]}" -- ${cur}) )
585 complete -F _lunch lunch
587 # Configures the build to build unbundled apps.
588 # Run tapas with one or more app names (from LOCAL_PACKAGE_NAME)
591 local arch="$(echo $* | xargs -n 1 echo | \grep -E '^(arm|x86|mips|armv5|arm64|x86_64|mips64)$' | xargs)"
592 local variant="$(echo $* | xargs -n 1 echo | \grep -E '^(user|userdebug|eng)$' | xargs)"
593 local apps="$(echo $* | xargs -n 1 echo | \grep -E -v '^(user|userdebug|eng|arm|x86|mips|armv5|arm64|x86_64|mips64)$' | xargs)"
595 if [ $(echo $arch | wc -w) -gt 1 ]; then
596 echo "tapas: Error: Multiple build archs supplied: $arch"
599 if [ $(echo $variant | wc -w) -gt 1 ]; then
600 echo "tapas: Error: Multiple build variants supplied: $variant"
606 x86) product=full_x86;;
607 mips) product=full_mips;;
608 armv5) product=generic_armv5;;
609 arm64) product=aosp_arm64;;
610 x86_64) product=aosp_x86_64;;
611 mips64) product=aosp_mips64;;
613 if [ -z "$variant" ]; then
616 if [ -z "$apps" ]; then
620 export TARGET_PRODUCT=$product
621 export TARGET_BUILD_VARIANT=$variant
622 export TARGET_BUILD_TYPE=release
623 export TARGET_BUILD_APPS=$apps
625 set_stuff_for_environment
631 local TOPFILE=build/core/envsetup.mk
632 if [ -n "$TOP" -a -f "$TOP/$TOPFILE" ] ; then
635 if [ -f $TOPFILE ] ; then
636 # The following circumlocution (repeated below as well) ensures
637 # that we record the true directory name and not one that is
638 # faked up with symlink names.
643 while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
648 if [ -f "$T/$TOPFILE" ]; then
655 # Return driver for "make", if any (eg. static analyzer)
659 test "$WITH_STATIC_ANALYZER" = "0" && unset WITH_STATIC_ANALYZER
660 if [ -n "$WITH_STATIC_ANALYZER" ]; then
662 $T/prebuilts/misc/linux-x86/analyzer/tools/scan-build/scan-build \
663 --use-analyzer $T/prebuilts/misc/linux-x86/analyzer/bin/analyzer \
672 local DRV=$(getdriver $T)
674 $DRV make -C $T -f build/core/main.mk $@
676 echo "Couldn't locate the top of the tree. Try setting TOP."
680 function findmakefile()
682 TOPFILE=build/core/envsetup.mk
685 while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
687 if [ -f "$T/Android.mk" ]; then
700 local DRV=$(getdriver $T)
701 # If we're sitting in the root of the build tree, just do a
703 if [ -f build/core/envsetup.mk -a -f Makefile ]; then
706 # Find the closest Android.mk file.
707 local M=$(findmakefile)
709 local GET_INSTALL_PATH=
711 # Remove the path to top as the makefilepath needs to be relative
712 local M=`echo $M|sed 's:'$T'/::'`
714 echo "Couldn't locate the top of the tree. Try setting TOP."
715 elif [ ! "$M" ]; then
716 echo "Couldn't locate a makefile from the current directory."
720 GET-INSTALL-PATH) GET_INSTALL_PATH=$ARG;;
723 if [ -n "$GET_INSTALL_PATH" ]; then
725 ARGS=GET-INSTALL-PATH
730 ONE_SHOT_MAKEFILE=$M $DRV make -C $T -f build/core/main.mk $MODULES $ARGS
738 local DRV=$(getdriver $T)
744 local GET_INSTALL_PATH=
745 local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
746 local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
747 for DIR in $DIRS ; do
748 MODULES=`echo $DIR | sed -n -e 's/.*:\(.*$\)/\1/p' | sed 's/,/ /'`
749 if [ "$MODULES" = "" ]; then
752 DIR=`echo $DIR | sed -e 's/:.*//' -e 's:/$::'`
753 if [ -f $DIR/Android.mk ]; then
754 local TO_CHOP=`(\cd -P -- $T && pwd -P) | wc -c | tr -d ' '`
755 local TO_CHOP=`expr $TO_CHOP + 1`
756 local START=`PWD= /bin/pwd`
757 local MFILE=`echo $START | cut -c${TO_CHOP}-`
758 if [ "$MFILE" = "" ] ; then
759 MFILE=$DIR/Android.mk
761 MFILE=$MFILE/$DIR/Android.mk
763 MAKEFILE="$MAKEFILE $MFILE"
766 showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
767 GET-INSTALL-PATH) GET_INSTALL_PATH=$DIR;;
768 *) echo "No Android.mk in $DIR."; return 1;;
772 if [ -n "$GET_INSTALL_PATH" ]; then
773 ARGS=$GET_INSTALL_PATH
776 ONE_SHOT_MAKEFILE="$MAKEFILE" $DRV make -C $T -f build/core/main.mk $DASH_ARGS $MODULES $ARGS
778 echo "Couldn't locate the top of the tree. Try setting TOP."
785 local DRV=$(getdriver $T)
786 if [ -f build/core/envsetup.mk -a -f Makefile ]; then
790 echo "Couldn't locate the top of the tree. Try setting TOP."
792 local MY_PWD=`PWD= /bin/pwd|sed 's:'$T'/::'`
793 $DRV make -C $T -f build/core/main.mk $@ all_modules BUILD_MODULES_IN_PATHS="$MY_PWD"
800 local DRV=$(getdriver $T)
802 local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
803 local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
804 local MY_PWD=`PWD= /bin/pwd`
805 if [ "$MY_PWD" = "$T" ]; then
808 MY_PWD=`echo $MY_PWD|sed 's:'$T'/::'`
813 for DIR in $DIRS ; do
815 if [ "$MY_PWD" = "" ]; then
816 MODULE_PATHS="$MODULE_PATHS $DIR"
818 MODULE_PATHS="$MODULE_PATHS $MY_PWD/$DIR"
822 showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
823 *) echo "Couldn't find directory $DIR"; return 1;;
827 $DRV make -C $T -f build/core/main.mk $DASH_ARGS $ARGS all_modules BUILD_MODULES_IN_PATHS="$MODULE_PATHS"
829 echo "Couldn't locate the top of the tree. Try setting TOP."
839 echo "Couldn't locate the top of the tree. Try setting TOP."
845 TOPFILE=build/core/envsetup.mk
848 while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
850 if [ -f "$T/Android.mk" ]; then
857 echo "can't find Android.mk"
860 # simplified version of ps; output in the form
865 if [ "$1" = "--exact" ]; then
869 elif [ "$1" = "--help" -o "$1" = "-h" ]; then
870 echo "usage: qpid [[--exact] <process name|pid>"
876 qpid | \grep "$prepend$EXE$append"
880 | sed -e 1d -e 's/^[^ ]* *\([0-9]*\).* \([^ ]*\)$/\1 \2/'
888 if [ "$1" = "--exact" ]; then
895 local PID=`adb shell ps \
897 | \grep "$prepend$EXE$append" \
898 | sed -e 's/^[^ ]* *\([0-9]*\).*$/\1/'`
901 echo "usage: pid [--exact] <process name>"
906 # systemstack - dump the current stack trace of all threads in the system process
907 # to the usual ANR traces file
908 function systemstack()
915 if [[ $1 =~ ^[0-9]+$ ]] ; then
918 local PIDLIST="$(pid $1)"
919 if [[ $PIDLIST =~ ^[0-9]+$ ]] ; then
921 elif [ "$PIDLIST" ] ; then
922 echo "more than one process: $1"
924 echo "no such process: $1"
927 echo "usage: stacks [pid|process name]"
931 # Determine whether the process is native
932 if adb shell ls -l /proc/$PID/exe | grep -q /system/bin/app_process ; then
933 # Dump stacks of Dalvik process
934 local TRACES=/data/anr/traces.txt
935 local ORIG=/data/anr/traces.orig
936 local TMP=/data/anr/traces.tmp
938 # Keep original traces to avoid clobbering
939 adb shell mv $TRACES $ORIG
941 # Make sure we have a usable file
942 adb shell touch $TRACES
943 adb shell chmod 666 $TRACES
945 # Dump stacks and wait for dump to finish
946 adb shell kill -3 $PID
947 adb shell notify $TRACES >/dev/null
949 # Restore original stacks, and show current output
950 adb shell mv $TRACES $TMP
951 adb shell mv $ORIG $TRACES
954 # Dump stacks of native process
955 local USE64BIT="$(is64bit $PID)"
956 adb shell debuggerd$USE64BIT -b $PID
961 function gdbwrapper()
968 function get_symbols_directory()
970 echo $(get_abs_build_var TARGET_OUT_UNSTRIPPED)
973 # Read the ELF header from /proc/$PID/exe to determine if the process is
979 if [[ "$(adb shell cat /proc/$PID/exe | xxd -l 1 -s 4 -ps)" -eq "02" ]] ; then
989 # gdbclient now determines whether the user wants to debug a 32-bit or 64-bit
990 # executable, set up the approriate gdbserver, then invokes the proper host
994 local OUT_ROOT=$(get_abs_build_var PRODUCT_OUT)
995 local OUT_SYMBOLS=$(get_abs_build_var TARGET_OUT_UNSTRIPPED)
996 local OUT_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED)
997 local OUT_VENDOR_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_VENDOR_SHARED_LIBRARIES_UNSTRIPPED)
998 local OUT_EXE_SYMBOLS=$(get_symbols_directory)
999 local PREBUILTS=$(get_abs_build_var ANDROID_PREBUILTS)
1000 local ARCH=$(get_build_var TARGET_ARCH)
1003 arm) GDB=arm-linux-androideabi-gdb;;
1004 arm64) GDB=arm-linux-androideabi-gdb; GDB64=aarch64-linux-android-gdb;;
1005 mips) GDB=mipsel-linux-android-gdb;;
1006 mips64) GDB=mipsel-linux-android-gdb;;
1007 x86) GDB=x86_64-linux-android-gdb;;
1008 x86_64) GDB=x86_64-linux-android-gdb;;
1009 *) echo "Unknown arch $ARCH"; return 1;;
1012 if [ "$OUT_ROOT" -a "$PREBUILTS" ]; then
1014 if [ "$EXE" ] ; then
1016 if [[ $EXE =~ ^[^/].* ]] ; then
1017 EXE="system/bin/"$EXE
1024 if [ "$PORT" ] ; then
1031 if [ "$PID" ] ; then
1032 if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
1034 if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
1035 # that likely didn't work because of returning multiple processes
1036 # try again, filtering by root processes (don't contain colon)
1037 PID=`adb shell ps | \grep $3 | \grep -v ":" | awk '{print $2}'`
1038 if [[ ! "$PID" =~ ^[0-9]+$ ]]
1040 echo "Couldn't resolve '$3' to single PID"
1044 echo "WARNING: multiple processes matching '$3' observed, using root process"
1049 adb forward "tcp$PORT" "tcp$PORT"
1050 local USE64BIT="$(is64bit $PID)"
1051 adb shell gdbserver$USE64BIT $PORT --attach $PID &
1055 echo "If you haven't done so already, do this first on the device:"
1056 echo " gdbserver $PORT /system/bin/$EXE"
1058 echo " gdbserver $PORT --attach <PID>"
1062 OUT_SO_SYMBOLS=$OUT_SO_SYMBOLS$USE64BIT
1063 OUT_VENDOR_SO_SYMBOLS=$OUT_VENDOR_SO_SYMBOLS$USE64BIT
1065 echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $OUT_SYMBOLS"
1066 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"
1067 echo >>"$OUT_ROOT/gdbclient.cmds" "source $ANDROID_BUILD_TOP/development/scripts/gdb/dalvik.gdb"
1068 echo >>"$OUT_ROOT/gdbclient.cmds" "target remote $PORT"
1069 echo >>"$OUT_ROOT/gdbclient.cmds" ""
1073 if [ "$USE64BIT" != "" ] ; then
1074 WHICH_GDB=$ANDROID_TOOLCHAIN/$GDB64
1075 # 32-bit exe / 32-bit platform
1076 elif [ "$(get_build_var TARGET_2ND_ARCH)" = "" ]; then
1077 WHICH_GDB=$ANDROID_TOOLCHAIN/$GDB
1078 # 32-bit exe / 64-bit platform
1080 WHICH_GDB=$ANDROID_TOOLCHAIN_2ND_ARCH/$GDB
1083 gdbwrapper $WHICH_GDB "$OUT_ROOT/gdbclient.cmds" "$OUT_EXE_SYMBOLS/$EXE"
1085 echo "Unable to determine build system output dir."
1094 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 "$@"
1101 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 "$@"
1106 function gettargetarch
1108 get_build_var TARGET_ARCH
1113 find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f -name "*\.gradle" -print0 | xargs -0 grep --color -n "$@"
1118 find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f -name "*\.java" -print0 | xargs -0 grep --color -n "$@"
1123 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 "$@"
1128 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;
1133 find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -type f -name 'AndroidManifest.xml' -print0 | xargs -0 grep --color -n "$@"
1138 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 "$@"
1145 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 "$@"
1150 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 "$@"
1157 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 "$@"
1162 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 "$@"
1168 function getprebuilt
1170 get_abs_build_var ANDROID_PREBUILTS
1173 function tracedmdump()
1177 echo "Couldn't locate the top of the tree. Try setting TOP."
1180 local prebuiltdir=$(getprebuilt)
1181 local arch=$(gettargetarch)
1182 local KERNEL=$T/prebuilts/qemu-kernel/$arch/vmlinux-qemu
1185 if [ ! "$TRACE" ] ; then
1186 echo "usage: tracedmdump tracename"
1190 if [ ! -r "$KERNEL" ] ; then
1191 echo "Error: cannot find kernel: '$KERNEL'"
1195 local BASETRACE=$(basename $TRACE)
1196 if [ "$BASETRACE" = "$TRACE" ] ; then
1197 TRACE=$ANDROID_PRODUCT_OUT/traces/$TRACE
1200 echo "post-processing traces..."
1201 rm -f $TRACE/qtrace.dexlist
1203 if [ $? -ne 0 ]; then
1205 echo "*** Error: malformed trace. Did you remember to exit the emulator?"
1209 echo "generating dexlist output..."
1210 /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
1211 echo "generating dmtrace data..."
1212 q2dm -r $ANDROID_PRODUCT_OUT/symbols $TRACE $KERNEL $TRACE/dmtrace || return
1213 echo "generating html file..."
1214 dmtracedump -h $TRACE/dmtrace >| $TRACE/dmtrace.html || return
1215 echo "done, see $TRACE/dmtrace.html for details"
1217 echo " traceview $TRACE/dmtrace"
1220 # communicate with a running device or emulator, set up necessary state,
1221 # and run the hat command.
1224 # process standard adb options
1226 if [ "$1" = "-d" -o "$1" = "-e" ]; then
1229 elif [ "$1" = "-s" ]; then
1233 local adbOptions=${adbTarget}
1234 #echo adbOptions = ${adbOptions}
1239 if [ "$targetPid" = "" ]; then
1240 echo "Usage: runhat [ -d | -e | -s serial ] target-pid"
1244 # confirm hat is available
1245 if [ -z $(which hat) ]; then
1246 echo "hat is not available in this configuration."
1250 # issue "am" command to cause the hprof dump
1251 local sdcard=$(adb ${adbOptions} shell echo -n '$EXTERNAL_STORAGE')
1252 local devFile=$sdcard/hprof-$targetPid
1253 #local devFile=/data/local/hprof-$targetPid
1254 echo "Poking $targetPid and waiting for data..."
1255 echo "Storing data at $devFile"
1256 adb ${adbOptions} shell am dumpheap $targetPid $devFile
1257 echo "Press enter when logcat shows \"hprof: heap dump completed\""
1261 local localFile=/tmp/$$-hprof
1263 echo "Retrieving file $devFile..."
1264 adb ${adbOptions} pull $devFile $localFile
1266 adb ${adbOptions} shell rm $devFile
1268 echo "Running hat on $localFile"
1269 echo "View the output by pointing your browser at http://localhost:7000/"
1271 hat -JXmx512m $localFile
1274 function getbugreports()
1276 local reports=(`adb shell ls /sdcard/bugreports | tr -d '\r'`)
1278 if [ ! "$reports" ]; then
1279 echo "Could not locate any bugreports."
1284 for report in ${reports[@]}
1286 echo "/sdcard/bugreports/${report}"
1287 adb pull /sdcard/bugreports/${report} ${report}
1292 function getsdcardpath()
1294 adb ${adbOptions} shell echo -n \$\{EXTERNAL_STORAGE\}
1297 function getscreenshotpath()
1299 echo "$(getsdcardpath)/Pictures/Screenshots"
1302 function getlastscreenshot()
1304 local screenshot_path=$(getscreenshotpath)
1305 local screenshot=`adb ${adbOptions} ls ${screenshot_path} | grep Screenshot_[0-9-]*.*\.png | sort -rk 3 | cut -d " " -f 4 | head -n 1`
1306 if [ "$screenshot" = "" ]; then
1307 echo "No screenshots found."
1310 echo "${screenshot}"
1311 adb ${adbOptions} pull ${screenshot_path}/${screenshot}
1314 function startviewserver()
1317 if [ $# -gt 0 ]; then
1320 adb shell service call window 1 i32 $port
1323 function stopviewserver()
1325 adb shell service call window 2
1328 function isviewserverstarted()
1330 adb shell service call window 3
1335 adb shell input keyevent 3
1340 adb shell input keyevent 4
1345 adb shell input keyevent 82
1348 function smoketest()
1350 if [ ! "$ANDROID_PRODUCT_OUT" ]; then
1351 echo "Couldn't locate output files. Try running 'lunch' first." >&2
1356 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
1360 (\cd "$T" && mmm tests/SmokeTest) &&
1361 adb uninstall com.android.smoketest > /dev/null &&
1362 adb uninstall com.android.smoketest.tests > /dev/null &&
1363 adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTestApp.apk &&
1364 adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTest.apk &&
1365 adb shell am instrument -w com.android.smoketest.tests/android.test.InstrumentationTestRunner
1368 # simple shortcut to the runtest command
1373 echo "Couldn't locate the top of the tree. Try setting TOP." >&2
1376 ("$T"/development/testrunner/runtest.py $@)
1380 if [[ -z "$1" ]]; then
1381 echo "Usage: godir <regex>"
1385 if [[ ! -f $T/filelist ]]; then
1386 echo -n "Creating index..."
1387 (\cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > filelist)
1392 lines=($(\grep "$1" $T/filelist | sed -e 's/\/[^/]*$//' | sort | uniq))
1393 if [[ ${#lines[@]} = 0 ]]; then
1399 if [[ ${#lines[@]} > 1 ]]; then
1400 while [[ -z "$pathname" ]]; do
1403 for line in ${lines[@]}; do
1404 printf "%6s %s\n" "[$index]" $line
1405 index=$(($index + 1))
1408 echo -n "Select one: "
1411 if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then
1412 echo "Invalid choice"
1415 pathname=${lines[$(($choice-1))]}
1418 pathname=${lines[0]}
1423 # Force JAVA_HOME to point to java 1.7 or java 1.6 if it isn't already set.
1425 # Note that the MacOS path for java 1.7 includes a minor revision number (sigh).
1426 # For some reason, installing the JDK doesn't make it show up in the
1427 # JavaVM.framework/Versions/1.7/ folder.
1428 function set_java_home() {
1429 # Clear the existing JAVA_HOME value if we set it ourselves, so that
1430 # we can reset it later, depending on the version of java the build
1433 # If we don't do this, the JAVA_HOME value set by the first call to
1434 # build/envsetup.sh will persist forever.
1435 if [ -n "$ANDROID_SET_JAVA_HOME" ]; then
1439 if [ ! "$JAVA_HOME" ]; then
1440 if [ -n "$LEGACY_USE_JAVA6" ]; then
1443 export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
1446 export JAVA_HOME=/usr/lib/jvm/java-6-sun
1452 export JAVA_HOME=$(/usr/libexec/java_home -v 1.7)
1455 export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
1460 # Keep track of the fact that we set JAVA_HOME ourselves, so that
1461 # we can change it on the next envsetup.sh, if required.
1462 export ANDROID_SET_JAVA_HOME=true
1466 # Print colored exit condition
1470 if [ $retval -ne 0 ]
1472 echo -e "\e[0;31mFAILURE\e[00m"
1474 echo -e "\e[0;32mSUCCESS\e[00m"
1481 local start_time=$(date +"%s")
1484 local end_time=$(date +"%s")
1485 local tdiff=$(($end_time-$start_time))
1486 local hours=$(($tdiff / 3600 ))
1487 local mins=$((($tdiff % 3600) / 60))
1488 local secs=$(($tdiff % 60))
1490 if [ $ret -eq 0 ] ; then
1491 echo -n -e "#### make completed successfully "
1493 echo -n -e "#### make failed to build some targets "
1495 if [ $hours -gt 0 ] ; then
1496 printf "(%02g:%02g:%02g (hh:mm:ss))" $hours $mins $secs
1497 elif [ $mins -gt 0 ] ; then
1498 printf "(%02g:%02g (mm:ss))" $mins $secs
1499 elif [ $secs -gt 0 ] ; then
1500 printf "(%s seconds)" $secs
1509 if [ "x$SHELL" != "x/bin/bash" ]; then
1510 case `ps -o command -p $$` in
1514 echo "WARNING: Only bash is supported, use of other shell would lead to erroneous results"
1519 # Execute the contents of any vendorsetup.sh files we can find.
1520 for f in `test -d device && find device -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null` \
1521 `test -d vendor && find vendor -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null`