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