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