envsetup.sh revision 1efd9e462a157c38d8ce0049582b27b3591c8c45
1function hmm() {
2cat <<EOF
3Invoke ". 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] [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- mma:     Builds all of the modules in the current directory, and their dependencies.
11- mmma:    Builds all of the modules in the supplied directories, and their dependencies.
12- cgrep:   Greps on all local C/C++ files.
13- jgrep:   Greps on all local Java files.
14- resgrep: Greps on all local res/*.xml files.
15- godir:   Go to the directory containing a file.
16
17Look at the source to view more functions. The complete list is:
18EOF
19    T=$(gettop)
20    local A
21    A=""
22    for i in `cat $T/build/envsetup.sh | sed -n "/^function /s/function \([a-z_]*\).*/\1/p" | sort`; do
23      A="$A $i"
24    done
25    echo $A
26}
27
28# Get the value of a build variable as an absolute path.
29function get_abs_build_var()
30{
31    T=$(gettop)
32    if [ ! "$T" ]; then
33        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
34        return
35    fi
36    (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
37      make --no-print-directory -f build/core/config.mk dumpvar-abs-$1)
38}
39
40# Get the exact value of a build variable.
41function get_build_var()
42{
43    T=$(gettop)
44    if [ ! "$T" ]; then
45        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
46        return
47    fi
48    (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
49      make --no-print-directory -f build/core/config.mk dumpvar-$1)
50}
51
52# check to see if the supplied product is one we can build
53function check_product()
54{
55    T=$(gettop)
56    if [ ! "$T" ]; then
57        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
58        return
59    fi
60    CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
61        TARGET_PRODUCT=$1 \
62        TARGET_BUILD_VARIANT= \
63        TARGET_BUILD_TYPE= \
64        TARGET_BUILD_APPS= \
65        get_build_var TARGET_DEVICE > /dev/null
66    # hide successful answers, but allow the errors to show
67}
68
69VARIANT_CHOICES=(user userdebug eng)
70
71# check to see if the supplied variant is valid
72function check_variant()
73{
74    for v in ${VARIANT_CHOICES[@]}
75    do
76        if [ "$v" = "$1" ]
77        then
78            return 0
79        fi
80    done
81    return 1
82}
83
84function setpaths()
85{
86    T=$(gettop)
87    if [ ! "$T" ]; then
88        echo "Couldn't locate the top of the tree.  Try setting TOP."
89        return
90    fi
91
92    ##################################################################
93    #                                                                #
94    #              Read me before you modify this code               #
95    #                                                                #
96    #   This function sets ANDROID_BUILD_PATHS to what it is adding  #
97    #   to PATH, and the next time it is run, it removes that from   #
98    #   PATH.  This is required so lunch can be run more than once   #
99    #   and still have working paths.                                #
100    #                                                                #
101    ##################################################################
102
103    # Note: on windows/cygwin, ANDROID_BUILD_PATHS will contain spaces
104    # due to "C:\Program Files" being in the path.
105
106    # out with the old
107    if [ -n "$ANDROID_BUILD_PATHS" ] ; then
108        export PATH=${PATH/$ANDROID_BUILD_PATHS/}
109    fi
110    if [ -n "$ANDROID_PRE_BUILD_PATHS" ] ; then
111        export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/}
112        # strip leading ':', if any
113        export PATH=${PATH/:%/}
114    fi
115
116    # and in with the new
117    CODE_REVIEWS=
118    prebuiltdir=$(getprebuilt)
119    gccprebuiltdir=$(get_abs_build_var ANDROID_GCC_PREBUILTS)
120
121    # defined in core/config.mk
122    targetgccversion=$(get_build_var TARGET_GCC_VERSION)
123    export TARGET_GCC_VERSION=$targetgccversion
124
125    # The gcc toolchain does not exists for windows/cygwin. In this case, do not reference it.
126    export ANDROID_EABI_TOOLCHAIN=
127    local ARCH=$(get_build_var TARGET_ARCH)
128    case $ARCH in
129        x86) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
130            ;;
131        x86_64) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
132            ;;
133        arm) toolchaindir=arm/arm-linux-androideabi-$targetgccversion/bin
134            ;;
135        arm64) toolchaindir=aarch64/aarch64-linux-android-$targetgccversion/bin
136            ;;
137        mips) toolchaindir=mips/mipsel-linux-android-$targetgccversion/bin
138            ;;
139        mips64) toolchaindir=mips/mips64el-linux-android-$targetgccversion/bin
140            ;;
141        *)
142            echo "Can't find toolchain for unknown architecture: $ARCH"
143            toolchaindir=xxxxxxxxx
144            ;;
145    esac
146    if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
147        export ANDROID_EABI_TOOLCHAIN=$gccprebuiltdir/$toolchaindir
148    fi
149
150    unset ARM_EABI_TOOLCHAIN ARM_EABI_TOOLCHAIN_PATH
151    case $ARCH in
152        arm)
153            toolchaindir=arm/arm-eabi-$targetgccversion/bin
154            if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
155                 export ARM_EABI_TOOLCHAIN="$gccprebuiltdir/$toolchaindir"
156                 ARM_EABI_TOOLCHAIN_PATH=":$gccprebuiltdir/$toolchaindir"
157            fi
158            ;;
159        mips) toolchaindir=mips/mips-eabi-4.4.3/bin
160            ;;
161        *)
162            # No need to set ARM_EABI_TOOLCHAIN for other ARCHs
163            ;;
164    esac
165
166    export ANDROID_TOOLCHAIN=$ANDROID_EABI_TOOLCHAIN
167    export ANDROID_QTOOLS=$T/development/emulator/qtools
168    export ANDROID_DEV_SCRIPTS=$T/development/scripts:$T/prebuilts/devtools/tools
169    export ANDROID_BUILD_PATHS=$(get_build_var ANDROID_BUILD_PATHS):$ANDROID_QTOOLS:$ANDROID_TOOLCHAIN$ARM_EABI_TOOLCHAIN_PATH$CODE_REVIEWS:$ANDROID_DEV_SCRIPTS:
170    export PATH=$ANDROID_BUILD_PATHS$PATH
171
172    unset ANDROID_JAVA_TOOLCHAIN
173    unset ANDROID_PRE_BUILD_PATHS
174    if [ -n "$JAVA_HOME" ]; then
175        export ANDROID_JAVA_TOOLCHAIN=$JAVA_HOME/bin
176        export ANDROID_PRE_BUILD_PATHS=$ANDROID_JAVA_TOOLCHAIN:
177        export PATH=$ANDROID_PRE_BUILD_PATHS$PATH
178    fi
179
180    unset ANDROID_PRODUCT_OUT
181    export ANDROID_PRODUCT_OUT=$(get_abs_build_var PRODUCT_OUT)
182    export OUT=$ANDROID_PRODUCT_OUT
183
184    unset ANDROID_HOST_OUT
185    export ANDROID_HOST_OUT=$(get_abs_build_var HOST_OUT)
186
187    # needed for processing samples collected by perf counters
188    unset OPROFILE_EVENTS_DIR
189    export OPROFILE_EVENTS_DIR=$T/external/oprofile/events
190
191    # needed for building linux on MacOS
192    # TODO: fix the path
193    #export HOST_EXTRACFLAGS="-I "$T/system/kernel_headers/host_include
194}
195
196function printconfig()
197{
198    T=$(gettop)
199    if [ ! "$T" ]; then
200        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
201        return
202    fi
203    get_build_var report_config
204}
205
206function set_stuff_for_environment()
207{
208    settitle
209    set_java_home
210    setpaths
211    set_sequence_number
212
213    export ANDROID_BUILD_TOP=$(gettop)
214    # With this environment variable new GCC can apply colors to warnings/errors
215    export GCC_COLORS='error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01'
216}
217
218function set_sequence_number()
219{
220    export BUILD_ENV_SEQUENCE_NUMBER=10
221}
222
223function settitle()
224{
225    if [ "$STAY_OFF_MY_LAWN" = "" ]; then
226        local arch=$(gettargetarch)
227        local product=$TARGET_PRODUCT
228        local variant=$TARGET_BUILD_VARIANT
229        local apps=$TARGET_BUILD_APPS
230        if [ -z "$apps" ]; then
231            export PROMPT_COMMAND="echo -ne \"\033]0;[${arch}-${product}-${variant}] ${USER}@${HOSTNAME}: ${PWD}\007\""
232        else
233            export PROMPT_COMMAND="echo -ne \"\033]0;[$arch $apps $variant] ${USER}@${HOSTNAME}: ${PWD}\007\""
234        fi
235    fi
236}
237
238function addcompletions()
239{
240    local T dir f
241
242    # Keep us from trying to run in something that isn't bash.
243    if [ -z "${BASH_VERSION}" ]; then
244        return
245    fi
246
247    # Keep us from trying to run in bash that's too old.
248    if [ ${BASH_VERSINFO[0]} -lt 3 ]; then
249        return
250    fi
251
252    dir="sdk/bash_completion"
253    if [ -d ${dir} ]; then
254        for f in `/bin/ls ${dir}/[a-z]*.bash 2> /dev/null`; do
255            echo "including $f"
256            . $f
257        done
258    fi
259}
260
261function choosetype()
262{
263    echo "Build type choices are:"
264    echo "     1. release"
265    echo "     2. debug"
266    echo
267
268    local DEFAULT_NUM DEFAULT_VALUE
269    DEFAULT_NUM=1
270    DEFAULT_VALUE=release
271
272    export TARGET_BUILD_TYPE=
273    local ANSWER
274    while [ -z $TARGET_BUILD_TYPE ]
275    do
276        echo -n "Which would you like? ["$DEFAULT_NUM"] "
277        if [ -z "$1" ] ; then
278            read ANSWER
279        else
280            echo $1
281            ANSWER=$1
282        fi
283        case $ANSWER in
284        "")
285            export TARGET_BUILD_TYPE=$DEFAULT_VALUE
286            ;;
287        1)
288            export TARGET_BUILD_TYPE=release
289            ;;
290        release)
291            export TARGET_BUILD_TYPE=release
292            ;;
293        2)
294            export TARGET_BUILD_TYPE=debug
295            ;;
296        debug)
297            export TARGET_BUILD_TYPE=debug
298            ;;
299        *)
300            echo
301            echo "I didn't understand your response.  Please try again."
302            echo
303            ;;
304        esac
305        if [ -n "$1" ] ; then
306            break
307        fi
308    done
309
310    set_stuff_for_environment
311}
312
313#
314# This function isn't really right:  It chooses a TARGET_PRODUCT
315# based on the list of boards.  Usually, that gets you something
316# that kinda works with a generic product, but really, you should
317# pick a product by name.
318#
319function chooseproduct()
320{
321    if [ "x$TARGET_PRODUCT" != x ] ; then
322        default_value=$TARGET_PRODUCT
323    else
324        default_value=full
325    fi
326
327    export TARGET_PRODUCT=
328    local ANSWER
329    while [ -z "$TARGET_PRODUCT" ]
330    do
331        echo -n "Which product would you like? [$default_value] "
332        if [ -z "$1" ] ; then
333            read ANSWER
334        else
335            echo $1
336            ANSWER=$1
337        fi
338
339        if [ -z "$ANSWER" ] ; then
340            export TARGET_PRODUCT=$default_value
341        else
342            if check_product $ANSWER
343            then
344                export TARGET_PRODUCT=$ANSWER
345            else
346                echo "** Not a valid product: $ANSWER"
347            fi
348        fi
349        if [ -n "$1" ] ; then
350            break
351        fi
352    done
353
354    set_stuff_for_environment
355}
356
357function choosevariant()
358{
359    echo "Variant choices are:"
360    local index=1
361    local v
362    for v in ${VARIANT_CHOICES[@]}
363    do
364        # The product name is the name of the directory containing
365        # the makefile we found, above.
366        echo "     $index. $v"
367        index=$(($index+1))
368    done
369
370    local default_value=eng
371    local ANSWER
372
373    export TARGET_BUILD_VARIANT=
374    while [ -z "$TARGET_BUILD_VARIANT" ]
375    do
376        echo -n "Which would you like? [$default_value] "
377        if [ -z "$1" ] ; then
378            read ANSWER
379        else
380            echo $1
381            ANSWER=$1
382        fi
383
384        if [ -z "$ANSWER" ] ; then
385            export TARGET_BUILD_VARIANT=$default_value
386        elif (echo -n $ANSWER | grep -q -e "^[0-9][0-9]*$") ; then
387            if [ "$ANSWER" -le "${#VARIANT_CHOICES[@]}" ] ; then
388                export TARGET_BUILD_VARIANT=${VARIANT_CHOICES[$(($ANSWER-1))]}
389            fi
390        else
391            if check_variant $ANSWER
392            then
393                export TARGET_BUILD_VARIANT=$ANSWER
394            else
395                echo "** Not a valid variant: $ANSWER"
396            fi
397        fi
398        if [ -n "$1" ] ; then
399            break
400        fi
401    done
402}
403
404function choosecombo()
405{
406    choosetype $1
407
408    echo
409    echo
410    chooseproduct $2
411
412    echo
413    echo
414    choosevariant $3
415
416    echo
417    set_stuff_for_environment
418    printconfig
419}
420
421# Clear this variable.  It will be built up again when the vendorsetup.sh
422# files are included at the end of this file.
423unset LUNCH_MENU_CHOICES
424function add_lunch_combo()
425{
426    local new_combo=$1
427    local c
428    for c in ${LUNCH_MENU_CHOICES[@]} ; do
429        if [ "$new_combo" = "$c" ] ; then
430            return
431        fi
432    done
433    LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
434}
435
436# add the default one here
437add_lunch_combo aosp_arm-eng
438add_lunch_combo aosp_arm64-eng
439add_lunch_combo aosp_mips-eng
440add_lunch_combo aosp_mips64-eng
441add_lunch_combo aosp_x86-eng
442add_lunch_combo aosp_x86_64-eng
443add_lunch_combo vbox_x86-eng
444
445function print_lunch_menu()
446{
447    local uname=$(uname)
448    echo
449    echo "You're building on" $uname
450    echo
451    echo "Lunch menu... pick a combo:"
452
453    local i=1
454    local choice
455    for choice in ${LUNCH_MENU_CHOICES[@]}
456    do
457        echo "     $i. $choice"
458        i=$(($i+1))
459    done
460
461    echo
462}
463
464function lunch()
465{
466    local answer
467
468    if [ "$1" ] ; then
469        answer=$1
470    else
471        print_lunch_menu
472        echo -n "Which would you like? [aosp_arm-eng] "
473        read answer
474    fi
475
476    local selection=
477
478    if [ -z "$answer" ]
479    then
480        selection=aosp_arm-eng
481    elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
482    then
483        if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
484        then
485            selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
486        fi
487    elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
488    then
489        selection=$answer
490    fi
491
492    if [ -z "$selection" ]
493    then
494        echo
495        echo "Invalid lunch combo: $answer"
496        return 1
497    fi
498
499    export TARGET_BUILD_APPS=
500
501    local product=$(echo -n $selection | sed -e "s/-.*$//")
502    check_product $product
503    if [ $? -ne 0 ]
504    then
505        echo
506        echo "** Don't have a product spec for: '$product'"
507        echo "** Do you have the right repo manifest?"
508        product=
509    fi
510
511    local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
512    check_variant $variant
513    if [ $? -ne 0 ]
514    then
515        echo
516        echo "** Invalid variant: '$variant'"
517        echo "** Must be one of ${VARIANT_CHOICES[@]}"
518        variant=
519    fi
520
521    if [ -z "$product" -o -z "$variant" ]
522    then
523        echo
524        return 1
525    fi
526
527    export TARGET_PRODUCT=$product
528    export TARGET_BUILD_VARIANT=$variant
529    export TARGET_BUILD_TYPE=release
530
531    echo
532
533    set_stuff_for_environment
534    printconfig
535}
536
537# Tab completion for lunch.
538function _lunch()
539{
540    local cur prev opts
541    COMPREPLY=()
542    cur="${COMP_WORDS[COMP_CWORD]}"
543    prev="${COMP_WORDS[COMP_CWORD-1]}"
544
545    COMPREPLY=( $(compgen -W "${LUNCH_MENU_CHOICES[*]}" -- ${cur}) )
546    return 0
547}
548complete -F _lunch lunch
549
550# Configures the build to build unbundled apps.
551# Run tapas with one ore more app names (from LOCAL_PACKAGE_NAME)
552function tapas()
553{
554    local arch=$(echo -n $(echo $* | xargs -n 1 echo | \grep -E '^(arm|x86|mips|armv5)$'))
555    local variant=$(echo -n $(echo $* | xargs -n 1 echo | \grep -E '^(user|userdebug|eng)$'))
556    local apps=$(echo -n $(echo $* | xargs -n 1 echo | \grep -E -v '^(user|userdebug|eng|arm|x86|mips|armv5)$'))
557
558    if [ $(echo $arch | wc -w) -gt 1 ]; then
559        echo "tapas: Error: Multiple build archs supplied: $arch"
560        return
561    fi
562    if [ $(echo $variant | wc -w) -gt 1 ]; then
563        echo "tapas: Error: Multiple build variants supplied: $variant"
564        return
565    fi
566
567    local product=full
568    case $arch in
569      x86)   product=full_x86;;
570      mips)  product=full_mips;;
571      armv5) product=generic_armv5;;
572    esac
573    if [ -z "$variant" ]; then
574        variant=eng
575    fi
576    if [ -z "$apps" ]; then
577        apps=all
578    fi
579
580    export TARGET_PRODUCT=$product
581    export TARGET_BUILD_VARIANT=$variant
582    export TARGET_BUILD_TYPE=release
583    export TARGET_BUILD_APPS=$apps
584
585    set_stuff_for_environment
586    printconfig
587}
588
589function gettop
590{
591    local TOPFILE=build/core/envsetup.mk
592    if [ -n "$TOP" -a -f "$TOP/$TOPFILE" ] ; then
593        echo $TOP
594    else
595        if [ -f $TOPFILE ] ; then
596            # The following circumlocution (repeated below as well) ensures
597            # that we record the true directory name and not one that is
598            # faked up with symlink names.
599            PWD= /bin/pwd
600        else
601            local HERE=$PWD
602            T=
603            while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
604                \cd ..
605                T=`PWD= /bin/pwd`
606            done
607            \cd $HERE
608            if [ -f "$T/$TOPFILE" ]; then
609                echo $T
610            fi
611        fi
612    fi
613}
614
615# Return driver for "make", if any (eg. static analyzer)
616function getdriver()
617{
618    local T="$1"
619    test "$WITH_STATIC_ANALYZER" = "0" && unset WITH_STATIC_ANALYZER
620    if [ -n "$WITH_STATIC_ANALYZER" ]; then
621        echo "\
622$T/prebuilts/clang/linux-x86/host/3.3/tools/scan-build/scan-build \
623--use-analyzer $T/prebuilts/clang/linux-x86/host/3.3/bin/analyzer \
624--status-bugs \
625--top=$T"
626    fi
627}
628
629function m()
630{
631    local T=$(gettop)
632    local DRV=$(getdriver $T)
633    if [ "$T" ]; then
634        $DRV make -C $T -f build/core/main.mk $@
635    else
636        echo "Couldn't locate the top of the tree.  Try setting TOP."
637    fi
638}
639
640function findmakefile()
641{
642    TOPFILE=build/core/envsetup.mk
643    local HERE=$PWD
644    T=
645    while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
646        T=`PWD= /bin/pwd`
647        if [ -f "$T/Android.mk" ]; then
648            echo $T/Android.mk
649            \cd $HERE
650            return
651        fi
652        \cd ..
653    done
654    \cd $HERE
655}
656
657function mm()
658{
659    local T=$(gettop)
660    local DRV=$(getdriver $T)
661    # If we're sitting in the root of the build tree, just do a
662    # normal make.
663    if [ -f build/core/envsetup.mk -a -f Makefile ]; then
664        $DRV make $@
665    else
666        # Find the closest Android.mk file.
667        local M=$(findmakefile)
668        local MODULES=
669        local GET_INSTALL_PATH=
670        local ARGS=
671        # Remove the path to top as the makefilepath needs to be relative
672        local M=`echo $M|sed 's:'$T'/::'`
673        if [ ! "$T" ]; then
674            echo "Couldn't locate the top of the tree.  Try setting TOP."
675        elif [ ! "$M" ]; then
676            echo "Couldn't locate a makefile from the current directory."
677        else
678            for ARG in $@; do
679                case $ARG in
680                  GET-INSTALL-PATH) GET_INSTALL_PATH=$ARG;;
681                esac
682            done
683            if [ -n "$GET_INSTALL_PATH" ]; then
684              MODULES=
685              ARGS=GET-INSTALL-PATH
686            else
687              MODULES=all_modules
688              ARGS=$@
689            fi
690            ONE_SHOT_MAKEFILE=$M $DRV make -C $T -f build/core/main.mk $MODULES $ARGS
691        fi
692    fi
693}
694
695function mmm()
696{
697    local T=$(gettop)
698    local DRV=$(getdriver $T)
699    if [ "$T" ]; then
700        local MAKEFILE=
701        local MODULES=
702        local ARGS=
703        local DIR TO_CHOP
704        local GET_INSTALL_PATH=
705        local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
706        local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
707        for DIR in $DIRS ; do
708            MODULES=`echo $DIR | sed -n -e 's/.*:\(.*$\)/\1/p' | sed 's/,/ /'`
709            if [ "$MODULES" = "" ]; then
710                MODULES=all_modules
711            fi
712            DIR=`echo $DIR | sed -e 's/:.*//' -e 's:/$::'`
713            if [ -f $DIR/Android.mk ]; then
714                local TO_CHOP=`(\cd -P -- $T && pwd -P) | wc -c | tr -d ' '`
715                local TO_CHOP=`expr $TO_CHOP + 1`
716                local START=`PWD= /bin/pwd`
717                local MFILE=`echo $START | cut -c${TO_CHOP}-`
718                if [ "$MFILE" = "" ] ; then
719                    MFILE=$DIR/Android.mk
720                else
721                    MFILE=$MFILE/$DIR/Android.mk
722                fi
723                MAKEFILE="$MAKEFILE $MFILE"
724            else
725                case $DIR in
726                  showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
727                  GET-INSTALL-PATH) GET_INSTALL_PATH=$DIR;;
728                  *) echo "No Android.mk in $DIR."; return 1;;
729                esac
730            fi
731        done
732        if [ -n "$GET_INSTALL_PATH" ]; then
733          ARGS=$GET_INSTALL_PATH
734          MODULES=
735        fi
736        ONE_SHOT_MAKEFILE="$MAKEFILE" $DRV make -C $T -f build/core/main.mk $DASH_ARGS $MODULES $ARGS
737    else
738        echo "Couldn't locate the top of the tree.  Try setting TOP."
739    fi
740}
741
742function mma()
743{
744  local T=$(gettop)
745  local DRV=$(getdriver $T)
746  if [ -f build/core/envsetup.mk -a -f Makefile ]; then
747    $DRV make $@
748  else
749    if [ ! "$T" ]; then
750      echo "Couldn't locate the top of the tree.  Try setting TOP."
751    fi
752    local MY_PWD=`PWD= /bin/pwd|sed 's:'$T'/::'`
753    $DRV make -C $T -f build/core/main.mk $@ all_modules BUILD_MODULES_IN_PATHS="$MY_PWD"
754  fi
755}
756
757function mmma()
758{
759  local T=$(gettop)
760  local DRV=$(getdriver $T)
761  if [ "$T" ]; then
762    local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
763    local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
764    local MY_PWD=`PWD= /bin/pwd`
765    if [ "$MY_PWD" = "$T" ]; then
766      MY_PWD=
767    else
768      MY_PWD=`echo $MY_PWD|sed 's:'$T'/::'`
769    fi
770    local DIR=
771    local MODULE_PATHS=
772    local ARGS=
773    for DIR in $DIRS ; do
774      if [ -d $DIR ]; then
775        if [ "$MY_PWD" = "" ]; then
776          MODULE_PATHS="$MODULE_PATHS $DIR"
777        else
778          MODULE_PATHS="$MODULE_PATHS $MY_PWD/$DIR"
779        fi
780      else
781        case $DIR in
782          showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
783          *) echo "Couldn't find directory $DIR"; return 1;;
784        esac
785      fi
786    done
787    $DRV make -C $T -f build/core/main.mk $DASH_ARGS $ARGS all_modules BUILD_MODULES_IN_PATHS="$MODULE_PATHS"
788  else
789    echo "Couldn't locate the top of the tree.  Try setting TOP."
790  fi
791}
792
793function croot()
794{
795    T=$(gettop)
796    if [ "$T" ]; then
797        \cd $(gettop)
798    else
799        echo "Couldn't locate the top of the tree.  Try setting TOP."
800    fi
801}
802
803function cproj()
804{
805    TOPFILE=build/core/envsetup.mk
806    local HERE=$PWD
807    T=
808    while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
809        T=$PWD
810        if [ -f "$T/Android.mk" ]; then
811            \cd $T
812            return
813        fi
814        \cd ..
815    done
816    \cd $HERE
817    echo "can't find Android.mk"
818}
819
820# simplified version of ps; output in the form
821# <pid> <procname>
822function qpid() {
823    local prepend=''
824    local append=''
825    if [ "$1" = "--exact" ]; then
826        prepend=' '
827        append='$'
828        shift
829    elif [ "$1" = "--help" -o "$1" = "-h" ]; then
830		echo "usage: qpid [[--exact] <process name|pid>"
831		return 255
832	fi
833
834    local EXE="$1"
835    if [ "$EXE" ] ; then
836		qpid | \grep "$prepend$EXE$append"
837	else
838		adb shell ps \
839			| tr -d '\r' \
840			| sed -e 1d -e 's/^[^ ]* *\([0-9]*\).* \([^ ]*\)$/\1 \2/'
841	fi
842}
843
844function pid()
845{
846    local prepend=''
847    local append=''
848    if [ "$1" = "--exact" ]; then
849        prepend=' '
850        append='$'
851        shift
852    fi
853    local EXE="$1"
854    if [ "$EXE" ] ; then
855        local PID=`adb shell ps \
856            | tr -d '\r' \
857            | \grep "$prepend$EXE$append" \
858            | sed -e 's/^[^ ]* *\([0-9]*\).*$/\1/'`
859        echo "$PID"
860    else
861        echo "usage: pid [--exact] <process name>"
862		return 255
863    fi
864}
865
866# systemstack - dump the current stack trace of all threads in the system process
867# to the usual ANR traces file
868function systemstack()
869{
870    stacks system_server
871}
872
873function stacks()
874{
875    if [[ $1 =~ ^[0-9]+$ ]] ; then
876        local PID="$1"
877    elif [ "$1" ] ; then
878        local PIDLIST="$(pid $1)"
879        if [[ $PIDLIST =~ ^[0-9]+$ ]] ; then
880            local PID="$PIDLIST"
881        elif [ "$PIDLIST" ] ; then
882            echo "more than one process: $1"
883        else
884            echo "no such process: $1"
885        fi
886    else
887        echo "usage: stacks [pid|process name]"
888    fi
889
890    if [ "$PID" ] ; then
891        # Determine whether the process is native
892        if adb shell ls -l /proc/$PID/exe | grep -q /system/bin/app_process ; then
893            # Dump stacks of Dalvik process
894            local TRACES=/data/anr/traces.txt
895            local ORIG=/data/anr/traces.orig
896            local TMP=/data/anr/traces.tmp
897
898            # Keep original traces to avoid clobbering
899            adb shell mv $TRACES $ORIG
900
901            # Make sure we have a usable file
902            adb shell touch $TRACES
903            adb shell chmod 666 $TRACES
904
905            # Dump stacks and wait for dump to finish
906            adb shell kill -3 $PID
907            adb shell notify $TRACES >/dev/null
908
909            # Restore original stacks, and show current output
910            adb shell mv $TRACES $TMP
911            adb shell mv $ORIG $TRACES
912            adb shell cat $TMP
913        else
914            # Dump stacks of native process
915            adb shell debuggerd -b $PID
916        fi
917    fi
918}
919
920function gdbwrapper()
921{
922    $ANDROID_TOOLCHAIN/$GDB -x "$@"
923}
924
925function gdbclient()
926{
927   local OUT_ROOT=$(get_abs_build_var PRODUCT_OUT)
928   local OUT_SYMBOLS=$(get_abs_build_var TARGET_OUT_UNSTRIPPED)
929   local OUT_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED)
930   local OUT_EXE_SYMBOLS=$(get_abs_build_var TARGET_OUT_EXECUTABLES_UNSTRIPPED)
931   local PREBUILTS=$(get_abs_build_var ANDROID_PREBUILTS)
932   local ARCH=$(get_build_var TARGET_ARCH)
933   local GDB
934   case "$ARCH" in
935       arm) GDB=arm-linux-androideabi-gdb;;
936       arm64) GDB=aarch64-linux-android-gdb;;
937       mips) GDB=mipsel-linux-android-gdb;;
938       mips64) GDB=mipsel-linux-android-gdb;;
939       x86) GDB=x86_64-linux-android-gdb;;
940       x86_64) GDB=x86_64-linux-android-gdb;;
941       *) echo "Unknown arch $ARCH"; return 1;;
942   esac
943
944   if [ "$OUT_ROOT" -a "$PREBUILTS" ]; then
945       local EXE="$1"
946       if [ "$EXE" ] ; then
947           EXE=$1
948       else
949           EXE="app_process"
950       fi
951
952       local PORT="$2"
953       if [ "$PORT" ] ; then
954           PORT=$2
955       else
956           PORT=":5039"
957       fi
958
959       local PID="$3"
960       if [ "$PID" ] ; then
961           if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
962               PID=`pid $3`
963               if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
964                   # that likely didn't work because of returning multiple processes
965                   # try again, filtering by root processes (don't contain colon)
966                   PID=`adb shell ps | \grep $3 | \grep -v ":" | awk '{print $2}'`
967                   if [[ ! "$PID" =~ ^[0-9]+$ ]]
968                   then
969                       echo "Couldn't resolve '$3' to single PID"
970                       return 1
971                   else
972                       echo ""
973                       echo "WARNING: multiple processes matching '$3' observed, using root process"
974                       echo ""
975                   fi
976               fi
977           fi
978           adb forward "tcp$PORT" "tcp$PORT"
979           adb shell gdbserver $PORT --attach $PID &
980           sleep 2
981       else
982               echo ""
983               echo "If you haven't done so already, do this first on the device:"
984               echo "    gdbserver $PORT /system/bin/$EXE"
985                   echo " or"
986               echo "    gdbserver $PORT --attach <PID>"
987               echo ""
988       fi
989
990       echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $OUT_SYMBOLS"
991       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"
992       echo >>"$OUT_ROOT/gdbclient.cmds" "source $ANDROID_BUILD_TOP/development/scripts/gdb/dalvik.gdb"
993       echo >>"$OUT_ROOT/gdbclient.cmds" "target remote $PORT"
994       echo >>"$OUT_ROOT/gdbclient.cmds" ""
995
996       gdbwrapper "$OUT_ROOT/gdbclient.cmds" "$OUT_EXE_SYMBOLS/$EXE"
997  else
998       echo "Unable to determine build system output dir."
999   fi
1000
1001}
1002
1003case `uname -s` in
1004    Darwin)
1005        function sgrep()
1006        {
1007            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 "$@"
1008        }
1009
1010        ;;
1011    *)
1012        function sgrep()
1013        {
1014            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 "$@"
1015        }
1016        ;;
1017esac
1018
1019function gettargetarch
1020{
1021    get_build_var TARGET_ARCH
1022}
1023
1024function jgrep()
1025{
1026    find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f -name "*\.java" -print0 | xargs -0 grep --color -n "$@"
1027}
1028
1029function cgrep()
1030{
1031    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 "$@"
1032}
1033
1034function resgrep()
1035{
1036    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;
1037}
1038
1039function mangrep()
1040{
1041    find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -type f -name 'AndroidManifest.xml' -print0 | xargs -0 grep --color -n "$@"
1042}
1043
1044function sepgrep()
1045{
1046    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 "$@"
1047}
1048
1049case `uname -s` in
1050    Darwin)
1051        function mgrep()
1052        {
1053            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 "$@"
1054        }
1055
1056        function treegrep()
1057        {
1058            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 "$@"
1059        }
1060
1061        ;;
1062    *)
1063        function mgrep()
1064        {
1065            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 "$@"
1066        }
1067
1068        function treegrep()
1069        {
1070            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 "$@"
1071        }
1072
1073        ;;
1074esac
1075
1076function getprebuilt
1077{
1078    get_abs_build_var ANDROID_PREBUILTS
1079}
1080
1081function tracedmdump()
1082{
1083    T=$(gettop)
1084    if [ ! "$T" ]; then
1085        echo "Couldn't locate the top of the tree.  Try setting TOP."
1086        return
1087    fi
1088    local prebuiltdir=$(getprebuilt)
1089    local arch=$(gettargetarch)
1090    local KERNEL=$T/prebuilts/qemu-kernel/$arch/vmlinux-qemu
1091
1092    local TRACE=$1
1093    if [ ! "$TRACE" ] ; then
1094        echo "usage:  tracedmdump  tracename"
1095        return
1096    fi
1097
1098    if [ ! -r "$KERNEL" ] ; then
1099        echo "Error: cannot find kernel: '$KERNEL'"
1100        return
1101    fi
1102
1103    local BASETRACE=$(basename $TRACE)
1104    if [ "$BASETRACE" = "$TRACE" ] ; then
1105        TRACE=$ANDROID_PRODUCT_OUT/traces/$TRACE
1106    fi
1107
1108    echo "post-processing traces..."
1109    rm -f $TRACE/qtrace.dexlist
1110    post_trace $TRACE
1111    if [ $? -ne 0 ]; then
1112        echo "***"
1113        echo "*** Error: malformed trace.  Did you remember to exit the emulator?"
1114        echo "***"
1115        return
1116    fi
1117    echo "generating dexlist output..."
1118    /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
1119    echo "generating dmtrace data..."
1120    q2dm -r $ANDROID_PRODUCT_OUT/symbols $TRACE $KERNEL $TRACE/dmtrace || return
1121    echo "generating html file..."
1122    dmtracedump -h $TRACE/dmtrace >| $TRACE/dmtrace.html || return
1123    echo "done, see $TRACE/dmtrace.html for details"
1124    echo "or run:"
1125    echo "    traceview $TRACE/dmtrace"
1126}
1127
1128# communicate with a running device or emulator, set up necessary state,
1129# and run the hat command.
1130function runhat()
1131{
1132    # process standard adb options
1133    local adbTarget=""
1134    if [ "$1" = "-d" -o "$1" = "-e" ]; then
1135        adbTarget=$1
1136        shift 1
1137    elif [ "$1" = "-s" ]; then
1138        adbTarget="$1 $2"
1139        shift 2
1140    fi
1141    local adbOptions=${adbTarget}
1142    #echo adbOptions = ${adbOptions}
1143
1144    # runhat options
1145    local targetPid=$1
1146
1147    if [ "$targetPid" = "" ]; then
1148        echo "Usage: runhat [ -d | -e | -s serial ] target-pid"
1149        return
1150    fi
1151
1152    # confirm hat is available
1153    if [ -z $(which hat) ]; then
1154        echo "hat is not available in this configuration."
1155        return
1156    fi
1157
1158    # issue "am" command to cause the hprof dump
1159    local sdcard=$(adb ${adbOptions} shell echo -n '$EXTERNAL_STORAGE')
1160    local devFile=$sdcard/hprof-$targetPid
1161    #local devFile=/data/local/hprof-$targetPid
1162    echo "Poking $targetPid and waiting for data..."
1163    echo "Storing data at $devFile"
1164    adb ${adbOptions} shell am dumpheap $targetPid $devFile
1165    echo "Press enter when logcat shows \"hprof: heap dump completed\""
1166    echo -n "> "
1167    read
1168
1169    local localFile=/tmp/$$-hprof
1170
1171    echo "Retrieving file $devFile..."
1172    adb ${adbOptions} pull $devFile $localFile
1173
1174    adb ${adbOptions} shell rm $devFile
1175
1176    echo "Running hat on $localFile"
1177    echo "View the output by pointing your browser at http://localhost:7000/"
1178    echo ""
1179    hat -JXmx512m $localFile
1180}
1181
1182function getbugreports()
1183{
1184    local reports=(`adb shell ls /sdcard/bugreports | tr -d '\r'`)
1185
1186    if [ ! "$reports" ]; then
1187        echo "Could not locate any bugreports."
1188        return
1189    fi
1190
1191    local report
1192    for report in ${reports[@]}
1193    do
1194        echo "/sdcard/bugreports/${report}"
1195        adb pull /sdcard/bugreports/${report} ${report}
1196        gunzip ${report}
1197    done
1198}
1199
1200function getsdcardpath()
1201{
1202    adb ${adbOptions} shell echo -n \$\{EXTERNAL_STORAGE\}
1203}
1204
1205function getscreenshotpath()
1206{
1207    echo "$(getsdcardpath)/Pictures/Screenshots"
1208}
1209
1210function getlastscreenshot()
1211{
1212    local screenshot_path=$(getscreenshotpath)
1213    local screenshot=`adb ${adbOptions} ls ${screenshot_path} | grep Screenshot_[0-9-]*.*\.png | sort -rk 3 | cut -d " " -f 4 | head -n 1`
1214    if [ "$screenshot" = "" ]; then
1215        echo "No screenshots found."
1216        return
1217    fi
1218    echo "${screenshot}"
1219    adb ${adbOptions} pull ${screenshot_path}/${screenshot}
1220}
1221
1222function startviewserver()
1223{
1224    local port=4939
1225    if [ $# -gt 0 ]; then
1226            port=$1
1227    fi
1228    adb shell service call window 1 i32 $port
1229}
1230
1231function stopviewserver()
1232{
1233    adb shell service call window 2
1234}
1235
1236function isviewserverstarted()
1237{
1238    adb shell service call window 3
1239}
1240
1241function key_home()
1242{
1243    adb shell input keyevent 3
1244}
1245
1246function key_back()
1247{
1248    adb shell input keyevent 4
1249}
1250
1251function key_menu()
1252{
1253    adb shell input keyevent 82
1254}
1255
1256function smoketest()
1257{
1258    if [ ! "$ANDROID_PRODUCT_OUT" ]; then
1259        echo "Couldn't locate output files.  Try running 'lunch' first." >&2
1260        return
1261    fi
1262    T=$(gettop)
1263    if [ ! "$T" ]; then
1264        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1265        return
1266    fi
1267
1268    (\cd "$T" && mmm tests/SmokeTest) &&
1269      adb uninstall com.android.smoketest > /dev/null &&
1270      adb uninstall com.android.smoketest.tests > /dev/null &&
1271      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTestApp.apk &&
1272      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTest.apk &&
1273      adb shell am instrument -w com.android.smoketest.tests/android.test.InstrumentationTestRunner
1274}
1275
1276# simple shortcut to the runtest command
1277function runtest()
1278{
1279    T=$(gettop)
1280    if [ ! "$T" ]; then
1281        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1282        return
1283    fi
1284    ("$T"/development/testrunner/runtest.py $@)
1285}
1286
1287function godir () {
1288    if [[ -z "$1" ]]; then
1289        echo "Usage: godir <regex>"
1290        return
1291    fi
1292    T=$(gettop)
1293    if [[ ! -f $T/filelist ]]; then
1294        echo -n "Creating index..."
1295        (\cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > filelist)
1296        echo " Done"
1297        echo ""
1298    fi
1299    local lines
1300    lines=($(\grep "$1" $T/filelist | sed -e 's/\/[^/]*$//' | sort | uniq))
1301    if [[ ${#lines[@]} = 0 ]]; then
1302        echo "Not found"
1303        return
1304    fi
1305    local pathname
1306    local choice
1307    if [[ ${#lines[@]} > 1 ]]; then
1308        while [[ -z "$pathname" ]]; do
1309            local index=1
1310            local line
1311            for line in ${lines[@]}; do
1312                printf "%6s %s\n" "[$index]" $line
1313                index=$(($index + 1))
1314            done
1315            echo
1316            echo -n "Select one: "
1317            unset choice
1318            read choice
1319            if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then
1320                echo "Invalid choice"
1321                continue
1322            fi
1323            pathname=${lines[$(($choice-1))]}
1324        done
1325    else
1326        pathname=${lines[0]}
1327    fi
1328    \cd $T/$pathname
1329}
1330
1331# Force JAVA_HOME to point to java 1.7 or java 1.6  if it isn't already set.
1332#
1333# Note that the MacOS path for java 1.7 includes a minor revision number (sigh).
1334# For some reason, installing the JDK doesn't make it show up in the
1335# JavaVM.framework/Versions/1.7/ folder.
1336function set_java_home() {
1337    # Clear the existing JAVA_HOME value if we set it ourselves, so that
1338    # we can reset it later, depending on the value of EXPERIMENTAL_USE_JAVA7.
1339    #
1340    # If we don't do this, the JAVA_HOME value set by the first call to
1341    # build/envsetup.sh will persist forever.
1342    if [ -n "$ANDROID_SET_JAVA_HOME" ]; then
1343      export JAVA_HOME=""
1344    fi
1345
1346    if [ ! "$JAVA_HOME" ]; then
1347      if [ ! "$EXPERIMENTAL_USE_JAVA7" ]; then
1348        case `uname -s` in
1349            Darwin)
1350                export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
1351                ;;
1352            *)
1353                export JAVA_HOME=/usr/lib/jvm/java-6-sun
1354                ;;
1355        esac
1356      else
1357        case `uname -s` in
1358            Darwin)
1359                export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_51.jdk/Contents/Home
1360                ;;
1361            *)
1362                export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
1363                ;;
1364        esac
1365      fi
1366
1367      # Keep track of the fact that we set JAVA_HOME ourselves, so that
1368      # we can change it on the next envsetup.sh, if required.
1369      export ANDROID_SET_JAVA_HOME=true
1370    fi
1371}
1372
1373# Print colored exit condition
1374function pez {
1375    "$@"
1376    local retval=$?
1377    if [ $retval -ne 0 ]
1378    then
1379        echo -e "\e[0;31mFAILURE\e[00m"
1380    else
1381        echo -e "\e[0;32mSUCCESS\e[00m"
1382    fi
1383    return $retval
1384}
1385
1386if [ "x$SHELL" != "x/bin/bash" ]; then
1387    case `ps -o command -p $$` in
1388        *bash*)
1389            ;;
1390        *)
1391            echo "WARNING: Only bash is supported, use of other shell would lead to erroneous results"
1392            ;;
1393    esac
1394fi
1395
1396# Execute the contents of any vendorsetup.sh files we can find.
1397for f in `test -d device && find device -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null` \
1398         `test -d vendor && find vendor -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null`
1399do
1400    echo "including $f"
1401    . $f
1402done
1403unset f
1404
1405addcompletions
1406