envsetup.sh revision 8bc4c438bd8483c8bf794a51908229c8e644b3f3
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] [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.
9- mmm:     Builds all of the modules in the supplied directories.
10- cgrep:   Greps on all local C/C++ files.
11- jgrep:   Greps on all local Java files.
12- resgrep: Greps on all local res/*.xml files.
13- godir:   Go to the directory containing a file.
14
15Look at the source to view more functions. The complete list is:
16EOF
17    T=$(gettop)
18    local A
19    A=""
20    for i in `cat $T/build/envsetup.sh | sed -n "/^function /s/function \([a-z_]*\).*/\1/p" | sort`; do
21      A="$A $i"
22    done
23    echo $A
24}
25
26# Get the value of a build variable as an absolute path.
27function get_abs_build_var()
28{
29    T=$(gettop)
30    if [ ! "$T" ]; then
31        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
32        return
33    fi
34    (cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
35      make --no-print-directory -C "$T" -f build/core/config.mk dumpvar-abs-$1)
36}
37
38# Get the exact value of a build variable.
39function get_build_var()
40{
41    T=$(gettop)
42    if [ ! "$T" ]; then
43        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
44        return
45    fi
46    CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
47      make --no-print-directory -C "$T" -f build/core/config.mk dumpvar-$1
48}
49
50# check to see if the supplied product is one we can build
51function check_product()
52{
53    T=$(gettop)
54    if [ ! "$T" ]; then
55        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
56        return
57    fi
58    CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
59        TARGET_PRODUCT=$1 \
60        TARGET_BUILD_VARIANT= \
61        TARGET_BUILD_TYPE= \
62        TARGET_BUILD_APPS= \
63        get_build_var TARGET_DEVICE > /dev/null
64    # hide successful answers, but allow the errors to show
65}
66
67VARIANT_CHOICES=(user userdebug eng)
68
69# check to see if the supplied variant is valid
70function check_variant()
71{
72    for v in ${VARIANT_CHOICES[@]}
73    do
74        if [ "$v" = "$1" ]
75        then
76            return 0
77        fi
78    done
79    return 1
80}
81
82function setpaths()
83{
84    T=$(gettop)
85    if [ ! "$T" ]; then
86        echo "Couldn't locate the top of the tree.  Try setting TOP."
87        return
88    fi
89
90    ##################################################################
91    #                                                                #
92    #              Read me before you modify this code               #
93    #                                                                #
94    #   This function sets ANDROID_BUILD_PATHS to what it is adding  #
95    #   to PATH, and the next time it is run, it removes that from   #
96    #   PATH.  This is required so lunch can be run more than once   #
97    #   and still have working paths.                                #
98    #                                                                #
99    ##################################################################
100
101    # Note: on windows/cygwin, ANDROID_BUILD_PATHS will contain spaces
102    # due to "C:\Program Files" being in the path.
103
104    # out with the old
105    if [ -n "$ANDROID_BUILD_PATHS" ] ; then
106        export PATH=${PATH/$ANDROID_BUILD_PATHS/}
107    fi
108    if [ -n "$ANDROID_PRE_BUILD_PATHS" ] ; then
109        export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/}
110        # strip trailing ':', if any
111        export PATH=${PATH/%:/}
112    fi
113
114    # and in with the new
115    CODE_REVIEWS=
116    prebuiltdir=$(getprebuilt)
117    gccprebuiltdir=$(get_abs_build_var ANDROID_GCC_PREBUILTS)
118
119    # defined in core/config.mk
120    targetgccversion=$(get_build_var TARGET_GCC_VERSION)
121
122    # The gcc toolchain does not exists for windows/cygwin. In this case, do not reference it.
123    export ANDROID_EABI_TOOLCHAIN=
124    local ARCH=$(get_build_var TARGET_ARCH)
125    case $ARCH in
126        x86) toolchaindir=x86/i686-linux-android-4.6/bin
127            ;;
128        arm) toolchaindir=arm/arm-linux-androideabi-$targetgccversion/bin
129            ;;
130        mips) toolchaindir=mips/mipsel-linux-android-4.6/bin
131            ;;
132        *)
133            echo "Can't find toolchain for unknown architecture: $ARCH"
134            toolchaindir=xxxxxxxxx
135            ;;
136    esac
137    if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
138        export ANDROID_EABI_TOOLCHAIN=$gccprebuiltdir/$toolchaindir
139    fi
140
141    unset ARM_EABI_TOOLCHAIN ARM_EABI_TOOLCHAIN_PATH
142    case $ARCH in
143        arm)
144            toolchaindir=arm/arm-eabi-$targetgccversion/bin
145            if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
146                 export ARM_EABI_TOOLCHAIN="$gccprebuiltdir/$toolchaindir"
147                 ARM_EABI_TOOLCHAIN_PATH=":$gccprebuiltdir/$toolchaindir"
148            fi
149            ;;
150        mips) toolchaindir=mips/mips-eabi-4.4.3/bin
151            ;;
152        *)
153            # No need to set ARM_EABI_TOOLCHAIN for other ARCHs
154            ;;
155    esac
156
157    export ANDROID_TOOLCHAIN=$ANDROID_EABI_TOOLCHAIN
158    export ANDROID_QTOOLS=$T/development/emulator/qtools
159    export ANDROID_DEV_SCRIPTS=$T/development/scripts
160    export ANDROID_BUILD_PATHS=:$(get_build_var ANDROID_BUILD_PATHS):$ANDROID_QTOOLS:$ANDROID_TOOLCHAIN$ARM_EABI_TOOLCHAIN_PATH$CODE_REVIEWS:$ANDROID_DEV_SCRIPTS
161    export PATH=$PATH$ANDROID_BUILD_PATHS
162
163    unset ANDROID_JAVA_TOOLCHAIN
164    unset ANDROID_PRE_BUILD_PATHS
165    if [ -n "$JAVA_HOME" ]; then
166        export ANDROID_JAVA_TOOLCHAIN=$JAVA_HOME/bin
167        export ANDROID_PRE_BUILD_PATHS=$ANDROID_JAVA_TOOLCHAIN:
168        export PATH=$ANDROID_PRE_BUILD_PATHS$PATH
169    fi
170
171    unset ANDROID_PRODUCT_OUT
172    export ANDROID_PRODUCT_OUT=$(get_abs_build_var PRODUCT_OUT)
173    export OUT=$ANDROID_PRODUCT_OUT
174
175    unset ANDROID_HOST_OUT
176    export ANDROID_HOST_OUT=$(get_abs_build_var HOST_OUT)
177
178    # needed for processing samples collected by perf counters
179    unset OPROFILE_EVENTS_DIR
180    export OPROFILE_EVENTS_DIR=$T/external/oprofile/events
181
182    # needed for building linux on MacOS
183    # TODO: fix the path
184    #export HOST_EXTRACFLAGS="-I "$T/system/kernel_headers/host_include
185}
186
187function printconfig()
188{
189    T=$(gettop)
190    if [ ! "$T" ]; then
191        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
192        return
193    fi
194    get_build_var report_config
195}
196
197function set_stuff_for_environment()
198{
199    settitle
200    set_java_home
201    setpaths
202    set_sequence_number
203
204    export ANDROID_BUILD_TOP=$(gettop)
205}
206
207function set_sequence_number()
208{
209    export BUILD_ENV_SEQUENCE_NUMBER=10
210}
211
212function settitle()
213{
214    if [ "$STAY_OFF_MY_LAWN" = "" ]; then
215        local arch=$(gettargetarch)
216        local product=$TARGET_PRODUCT
217        local variant=$TARGET_BUILD_VARIANT
218        local apps=$TARGET_BUILD_APPS
219        if [ -z "$apps" ]; then
220            export PROMPT_COMMAND="echo -ne \"\033]0;[${arch}-${product}-${variant}] ${USER}@${HOSTNAME}: ${PWD}\007\""
221        else
222            export PROMPT_COMMAND="echo -ne \"\033]0;[$arch $apps $variant] ${USER}@${HOSTNAME}: ${PWD}\007\""
223        fi
224    fi
225}
226
227function addcompletions()
228{
229    local T dir f
230
231    # Keep us from trying to run in something that isn't bash.
232    if [ -z "${BASH_VERSION}" ]; then
233        return
234    fi
235
236    # Keep us from trying to run in bash that's too old.
237    if [ ${BASH_VERSINFO[0]} -lt 3 ]; then
238        return
239    fi
240
241    dir="sdk/bash_completion"
242    if [ -d ${dir} ]; then
243        for f in `/bin/ls ${dir}/[a-z]*.bash 2> /dev/null`; do
244            echo "including $f"
245            . $f
246        done
247    fi
248}
249
250function choosetype()
251{
252    echo "Build type choices are:"
253    echo "     1. release"
254    echo "     2. debug"
255    echo
256
257    local DEFAULT_NUM DEFAULT_VALUE
258    DEFAULT_NUM=1
259    DEFAULT_VALUE=release
260
261    export TARGET_BUILD_TYPE=
262    local ANSWER
263    while [ -z $TARGET_BUILD_TYPE ]
264    do
265        echo -n "Which would you like? ["$DEFAULT_NUM"] "
266        if [ -z "$1" ] ; then
267            read ANSWER
268        else
269            echo $1
270            ANSWER=$1
271        fi
272        case $ANSWER in
273        "")
274            export TARGET_BUILD_TYPE=$DEFAULT_VALUE
275            ;;
276        1)
277            export TARGET_BUILD_TYPE=release
278            ;;
279        release)
280            export TARGET_BUILD_TYPE=release
281            ;;
282        2)
283            export TARGET_BUILD_TYPE=debug
284            ;;
285        debug)
286            export TARGET_BUILD_TYPE=debug
287            ;;
288        *)
289            echo
290            echo "I didn't understand your response.  Please try again."
291            echo
292            ;;
293        esac
294        if [ -n "$1" ] ; then
295            break
296        fi
297    done
298
299    set_stuff_for_environment
300}
301
302#
303# This function isn't really right:  It chooses a TARGET_PRODUCT
304# based on the list of boards.  Usually, that gets you something
305# that kinda works with a generic product, but really, you should
306# pick a product by name.
307#
308function chooseproduct()
309{
310    if [ "x$TARGET_PRODUCT" != x ] ; then
311        default_value=$TARGET_PRODUCT
312    else
313        default_value=full
314    fi
315
316    export TARGET_PRODUCT=
317    local ANSWER
318    while [ -z "$TARGET_PRODUCT" ]
319    do
320        echo -n "Which product would you like? [$default_value] "
321        if [ -z "$1" ] ; then
322            read ANSWER
323        else
324            echo $1
325            ANSWER=$1
326        fi
327
328        if [ -z "$ANSWER" ] ; then
329            export TARGET_PRODUCT=$default_value
330        else
331            if check_product $ANSWER
332            then
333                export TARGET_PRODUCT=$ANSWER
334            else
335                echo "** Not a valid product: $ANSWER"
336            fi
337        fi
338        if [ -n "$1" ] ; then
339            break
340        fi
341    done
342
343    set_stuff_for_environment
344}
345
346function choosevariant()
347{
348    echo "Variant choices are:"
349    local index=1
350    local v
351    for v in ${VARIANT_CHOICES[@]}
352    do
353        # The product name is the name of the directory containing
354        # the makefile we found, above.
355        echo "     $index. $v"
356        index=$(($index+1))
357    done
358
359    local default_value=eng
360    local ANSWER
361
362    export TARGET_BUILD_VARIANT=
363    while [ -z "$TARGET_BUILD_VARIANT" ]
364    do
365        echo -n "Which would you like? [$default_value] "
366        if [ -z "$1" ] ; then
367            read ANSWER
368        else
369            echo $1
370            ANSWER=$1
371        fi
372
373        if [ -z "$ANSWER" ] ; then
374            export TARGET_BUILD_VARIANT=$default_value
375        elif (echo -n $ANSWER | grep -q -e "^[0-9][0-9]*$") ; then
376            if [ "$ANSWER" -le "${#VARIANT_CHOICES[@]}" ] ; then
377                export TARGET_BUILD_VARIANT=${VARIANT_CHOICES[$(($ANSWER-1))]}
378            fi
379        else
380            if check_variant $ANSWER
381            then
382                export TARGET_BUILD_VARIANT=$ANSWER
383            else
384                echo "** Not a valid variant: $ANSWER"
385            fi
386        fi
387        if [ -n "$1" ] ; then
388            break
389        fi
390    done
391}
392
393function choosecombo()
394{
395    choosetype $1
396
397    echo
398    echo
399    chooseproduct $2
400
401    echo
402    echo
403    choosevariant $3
404
405    echo
406    set_stuff_for_environment
407    printconfig
408}
409
410# Clear this variable.  It will be built up again when the vendorsetup.sh
411# files are included at the end of this file.
412unset LUNCH_MENU_CHOICES
413function add_lunch_combo()
414{
415    local new_combo=$1
416    local c
417    for c in ${LUNCH_MENU_CHOICES[@]} ; do
418        if [ "$new_combo" = "$c" ] ; then
419            return
420        fi
421    done
422    LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
423}
424
425# add the default one here
426add_lunch_combo full-eng
427add_lunch_combo full_x86-eng
428add_lunch_combo vbox_x86-eng
429add_lunch_combo full_mips-eng
430
431function print_lunch_menu()
432{
433    local uname=$(uname)
434    echo
435    echo "You're building on" $uname
436    echo
437    echo "Lunch menu... pick a combo:"
438
439    local i=1
440    local choice
441    for choice in ${LUNCH_MENU_CHOICES[@]}
442    do
443        echo "     $i. $choice"
444        i=$(($i+1))
445    done
446
447    echo
448}
449
450function lunch()
451{
452    local answer
453
454    if [ "$1" ] ; then
455        answer=$1
456    else
457        print_lunch_menu
458        echo -n "Which would you like? [full-eng] "
459        read answer
460    fi
461
462    local selection=
463
464    if [ -z "$answer" ]
465    then
466        selection=full-eng
467    elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
468    then
469        if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
470        then
471            selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
472        fi
473    elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
474    then
475        selection=$answer
476    fi
477
478    if [ -z "$selection" ]
479    then
480        echo
481        echo "Invalid lunch combo: $answer"
482        return 1
483    fi
484
485    export TARGET_BUILD_APPS=
486
487    local product=$(echo -n $selection | sed -e "s/-.*$//")
488    check_product $product
489    if [ $? -ne 0 ]
490    then
491        echo
492        echo "** Don't have a product spec for: '$product'"
493        echo "** Do you have the right repo manifest?"
494        product=
495    fi
496
497    local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
498    check_variant $variant
499    if [ $? -ne 0 ]
500    then
501        echo
502        echo "** Invalid variant: '$variant'"
503        echo "** Must be one of ${VARIANT_CHOICES[@]}"
504        variant=
505    fi
506
507    if [ -z "$product" -o -z "$variant" ]
508    then
509        echo
510        return 1
511    fi
512
513    export TARGET_PRODUCT=$product
514    export TARGET_BUILD_VARIANT=$variant
515    export TARGET_BUILD_TYPE=release
516
517    echo
518
519    set_stuff_for_environment
520    printconfig
521}
522
523# Tab completion for lunch.
524function _lunch()
525{
526    local cur prev opts
527    COMPREPLY=()
528    cur="${COMP_WORDS[COMP_CWORD]}"
529    prev="${COMP_WORDS[COMP_CWORD-1]}"
530
531    COMPREPLY=( $(compgen -W "${LUNCH_MENU_CHOICES[*]}" -- ${cur}) )
532    return 0
533}
534complete -F _lunch lunch
535
536# Configures the build to build unbundled apps.
537# Run tapas with one ore more app names (from LOCAL_PACKAGE_NAME)
538function tapas()
539{
540    local arch=$(echo -n $(echo $* | xargs -n 1 echo | \grep -E '^(arm|x86|mips)$'))
541    local variant=$(echo -n $(echo $* | xargs -n 1 echo | \grep -E '^(user|userdebug|eng)$'))
542    local apps=$(echo -n $(echo $* | xargs -n 1 echo | \grep -E -v '^(user|userdebug|eng|arm|x86|mips)$'))
543
544    if [ $(echo $arch | wc -w) -gt 1 ]; then
545        echo "tapas: Error: Multiple build archs supplied: $arch"
546        return
547    fi
548    if [ $(echo $variant | wc -w) -gt 1 ]; then
549        echo "tapas: Error: Multiple build variants supplied: $variant"
550        return
551    fi
552
553    local product=full
554    case $arch in
555      x86)   product=full_x86;;
556      mips)  product=full_mips;;
557    esac
558    if [ -z "$variant" ]; then
559        variant=eng
560    fi
561    if [ -z "$apps" ]; then
562        apps=all
563    fi
564
565    export TARGET_PRODUCT=$product
566    export TARGET_BUILD_VARIANT=$variant
567    export TARGET_BUILD_TYPE=release
568    export TARGET_BUILD_APPS=$apps
569
570    set_stuff_for_environment
571    printconfig
572}
573
574function gettop
575{
576    local TOPFILE=build/core/envsetup.mk
577    if [ -n "$TOP" -a -f "$TOP/$TOPFILE" ] ; then
578        echo $TOP
579    else
580        if [ -f $TOPFILE ] ; then
581            # The following circumlocution (repeated below as well) ensures
582            # that we record the true directory name and not one that is
583            # faked up with symlink names.
584            PWD= /bin/pwd
585        else
586            # We redirect cd to /dev/null in case it's aliased to
587            # a command that prints something as a side-effect
588            # (like pushd)
589            local HERE=$PWD
590            T=
591            while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
592                cd .. > /dev/null
593                T=`PWD= /bin/pwd`
594            done
595            cd $HERE > /dev/null
596            if [ -f "$T/$TOPFILE" ]; then
597                echo $T
598            fi
599        fi
600    fi
601}
602
603function m()
604{
605    T=$(gettop)
606    if [ "$T" ]; then
607        make -C $T $@
608    else
609        echo "Couldn't locate the top of the tree.  Try setting TOP."
610    fi
611}
612
613function findmakefile()
614{
615    TOPFILE=build/core/envsetup.mk
616    # We redirect cd to /dev/null in case it's aliased to
617    # a command that prints something as a side-effect
618    # (like pushd)
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 > /dev/null
626            return
627        fi
628        cd .. > /dev/null
629    done
630    cd $HERE > /dev/null
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 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 $DASH_ARGS $MODULES $ARGS
698    else
699        echo "Couldn't locate the top of the tree.  Try setting TOP."
700    fi
701}
702
703function croot()
704{
705    T=$(gettop)
706    if [ "$T" ]; then
707        cd $(gettop)
708    else
709        echo "Couldn't locate the top of the tree.  Try setting TOP."
710    fi
711}
712
713function cproj()
714{
715    TOPFILE=build/core/envsetup.mk
716    # We redirect cd to /dev/null in case it's aliased to
717    # a command that prints something as a side-effect
718    # (like pushd)
719    local HERE=$PWD
720    T=
721    while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
722        T=$PWD
723        if [ -f "$T/Android.mk" ]; then
724            cd $T
725            return
726        fi
727        cd .. > /dev/null
728    done
729    cd $HERE > /dev/null
730    echo "can't find Android.mk"
731}
732
733function pid()
734{
735   local EXE="$1"
736   if [ "$EXE" ] ; then
737       local PID=`adb shell ps | fgrep $1 | sed -e 's/[^ ]* *\([0-9]*\).*/\1/'`
738       echo "$PID"
739   else
740       echo "usage: pid name"
741   fi
742}
743
744# systemstack - dump the current stack trace of all threads in the system process
745# to the usual ANR traces file
746function systemstack()
747{
748    adb shell echo '""' '>>' /data/anr/traces.txt && adb shell chmod 776 /data/anr/traces.txt && adb shell kill -3 $(pid system_server)
749}
750
751function gdbclient()
752{
753   local OUT_ROOT=$(get_abs_build_var PRODUCT_OUT)
754   local OUT_SYMBOLS=$(get_abs_build_var TARGET_OUT_UNSTRIPPED)
755   local OUT_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED)
756   local OUT_EXE_SYMBOLS=$(get_abs_build_var TARGET_OUT_EXECUTABLES_UNSTRIPPED)
757   local PREBUILTS=$(get_abs_build_var ANDROID_PREBUILTS)
758   local ARCH=$(get_build_var TARGET_ARCH)
759   local GDB
760   case "$ARCH" in
761       x86) GDB=i686-linux-android-gdb;;
762       arm) GDB=arm-linux-androideabi-gdb;;
763       mips) GDB=mipsel-linux-android-gdb;;
764       *) echo "Unknown arch $ARCH"; return 1;;
765   esac
766
767   if [ "$OUT_ROOT" -a "$PREBUILTS" ]; then
768       local EXE="$1"
769       if [ "$EXE" ] ; then
770           EXE=$1
771       else
772           EXE="app_process"
773       fi
774
775       local PORT="$2"
776       if [ "$PORT" ] ; then
777           PORT=$2
778       else
779           PORT=":5039"
780       fi
781
782       local PID
783       local PROG="$3"
784       if [ "$PROG" ] ; then
785           if [[ "$PROG" =~ ^[0-9]+$ ]] ; then
786               PID="$3"
787           else
788               PID=`pid $3`
789           fi
790           adb forward "tcp$PORT" "tcp$PORT"
791           adb shell gdbserver $PORT --attach $PID &
792           sleep 2
793       else
794               echo ""
795               echo "If you haven't done so already, do this first on the device:"
796               echo "    gdbserver $PORT /system/bin/$EXE"
797                   echo " or"
798               echo "    gdbserver $PORT --attach $PID"
799               echo ""
800       fi
801
802       echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $OUT_SYMBOLS"
803       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"
804       echo >>"$OUT_ROOT/gdbclient.cmds" "target remote $PORT"
805       echo >>"$OUT_ROOT/gdbclient.cmds" ""
806
807       $ANDROID_TOOLCHAIN/$GDB -x "$OUT_ROOT/gdbclient.cmds" "$OUT_EXE_SYMBOLS/$EXE"
808  else
809       echo "Unable to determine build system output dir."
810   fi
811
812}
813
814case `uname -s` in
815    Darwin)
816        function sgrep()
817        {
818            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 "$@"
819        }
820
821        ;;
822    *)
823        function sgrep()
824        {
825            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 "$@"
826        }
827        ;;
828esac
829
830function gettargetarch
831{
832    get_build_var TARGET_ARCH
833}
834
835function jgrep()
836{
837    find . -name .repo -prune -o -name .git -prune -o  -type f -name "*\.java" -print0 | xargs -0 grep --color -n "$@"
838}
839
840function cgrep()
841{
842    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 "$@"
843}
844
845function resgrep()
846{
847    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;
848}
849
850case `uname -s` in
851    Darwin)
852        function mgrep()
853        {
854            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 "$@"
855        }
856
857        function treegrep()
858        {
859            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 "$@"
860        }
861
862        ;;
863    *)
864        function mgrep()
865        {
866            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 "$@"
867        }
868
869        function treegrep()
870        {
871            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 "$@"
872        }
873
874        ;;
875esac
876
877function getprebuilt
878{
879    get_abs_build_var ANDROID_PREBUILTS
880}
881
882function tracedmdump()
883{
884    T=$(gettop)
885    if [ ! "$T" ]; then
886        echo "Couldn't locate the top of the tree.  Try setting TOP."
887        return
888    fi
889    local prebuiltdir=$(getprebuilt)
890    local arch=$(gettargetarch)
891    local KERNEL=$T/prebuilts/qemu-kernel/$arch/vmlinux-qemu
892
893    local TRACE=$1
894    if [ ! "$TRACE" ] ; then
895        echo "usage:  tracedmdump  tracename"
896        return
897    fi
898
899    if [ ! -r "$KERNEL" ] ; then
900        echo "Error: cannot find kernel: '$KERNEL'"
901        return
902    fi
903
904    local BASETRACE=$(basename $TRACE)
905    if [ "$BASETRACE" = "$TRACE" ] ; then
906        TRACE=$ANDROID_PRODUCT_OUT/traces/$TRACE
907    fi
908
909    echo "post-processing traces..."
910    rm -f $TRACE/qtrace.dexlist
911    post_trace $TRACE
912    if [ $? -ne 0 ]; then
913        echo "***"
914        echo "*** Error: malformed trace.  Did you remember to exit the emulator?"
915        echo "***"
916        return
917    fi
918    echo "generating dexlist output..."
919    /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
920    echo "generating dmtrace data..."
921    q2dm -r $ANDROID_PRODUCT_OUT/symbols $TRACE $KERNEL $TRACE/dmtrace || return
922    echo "generating html file..."
923    dmtracedump -h $TRACE/dmtrace >| $TRACE/dmtrace.html || return
924    echo "done, see $TRACE/dmtrace.html for details"
925    echo "or run:"
926    echo "    traceview $TRACE/dmtrace"
927}
928
929# communicate with a running device or emulator, set up necessary state,
930# and run the hat command.
931function runhat()
932{
933    # process standard adb options
934    local adbTarget=""
935    if [ "$1" = "-d" -o "$1" = "-e" ]; then
936        adbTarget=$1
937        shift 1
938    elif [ "$1" = "-s" ]; then
939        adbTarget="$1 $2"
940        shift 2
941    fi
942    local adbOptions=${adbTarget}
943    #echo adbOptions = ${adbOptions}
944
945    # runhat options
946    local targetPid=$1
947
948    if [ "$targetPid" = "" ]; then
949        echo "Usage: runhat [ -d | -e | -s serial ] target-pid"
950        return
951    fi
952
953    # confirm hat is available
954    if [ -z $(which hat) ]; then
955        echo "hat is not available in this configuration."
956        return
957    fi
958
959    # issue "am" command to cause the hprof dump
960    local sdcard=$(adb shell echo -n '$EXTERNAL_STORAGE')
961    local devFile=$sdcard/hprof-$targetPid
962    #local devFile=/data/local/hprof-$targetPid
963    echo "Poking $targetPid and waiting for data..."
964    echo "Storing data at $devFile"
965    adb ${adbOptions} shell am dumpheap $targetPid $devFile
966    echo "Press enter when logcat shows \"hprof: heap dump completed\""
967    echo -n "> "
968    read
969
970    local localFile=/tmp/$$-hprof
971
972    echo "Retrieving file $devFile..."
973    adb ${adbOptions} pull $devFile $localFile
974
975    adb ${adbOptions} shell rm $devFile
976
977    echo "Running hat on $localFile"
978    echo "View the output by pointing your browser at http://localhost:7000/"
979    echo ""
980    hat -JXmx512m $localFile
981}
982
983function getbugreports()
984{
985    local reports=(`adb shell ls /sdcard/bugreports | tr -d '\r'`)
986
987    if [ ! "$reports" ]; then
988        echo "Could not locate any bugreports."
989        return
990    fi
991
992    local report
993    for report in ${reports[@]}
994    do
995        echo "/sdcard/bugreports/${report}"
996        adb pull /sdcard/bugreports/${report} ${report}
997        gunzip ${report}
998    done
999}
1000
1001function getsdcardpath()
1002{
1003    adb ${adbOptions} shell echo -n \$\{EXTERNAL_STORAGE\}
1004}
1005
1006function getscreenshotpath()
1007{
1008    echo "$(getsdcardpath)/Pictures/Screenshots"
1009}
1010
1011function getlastscreenshot()
1012{
1013    local screenshot_path=$(getscreenshotpath)
1014    local screenshot=`adb ${adbOptions} ls ${screenshot_path} | grep Screenshot_[0-9-]*.*\.png | sort -rk 3 | cut -d " " -f 4 | head -n 1`
1015    if [ "$screenshot" = "" ]; then
1016        echo "No screenshots found."
1017        return
1018    fi
1019    echo "${screenshot}"
1020    adb ${adbOptions} pull ${screenshot_path}/${screenshot}
1021}
1022
1023function startviewserver()
1024{
1025    local port=4939
1026    if [ $# -gt 0 ]; then
1027            port=$1
1028    fi
1029    adb shell service call window 1 i32 $port
1030}
1031
1032function stopviewserver()
1033{
1034    adb shell service call window 2
1035}
1036
1037function isviewserverstarted()
1038{
1039    adb shell service call window 3
1040}
1041
1042function key_home()
1043{
1044    adb shell input keyevent 3
1045}
1046
1047function key_back()
1048{
1049    adb shell input keyevent 4
1050}
1051
1052function key_menu()
1053{
1054    adb shell input keyevent 82
1055}
1056
1057function smoketest()
1058{
1059    if [ ! "$ANDROID_PRODUCT_OUT" ]; then
1060        echo "Couldn't locate output files.  Try running 'lunch' first." >&2
1061        return
1062    fi
1063    T=$(gettop)
1064    if [ ! "$T" ]; then
1065        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1066        return
1067    fi
1068
1069    (cd "$T" && mmm tests/SmokeTest) &&
1070      adb uninstall com.android.smoketest > /dev/null &&
1071      adb uninstall com.android.smoketest.tests > /dev/null &&
1072      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTestApp.apk &&
1073      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTest.apk &&
1074      adb shell am instrument -w com.android.smoketest.tests/android.test.InstrumentationTestRunner
1075}
1076
1077# simple shortcut to the runtest command
1078function runtest()
1079{
1080    T=$(gettop)
1081    if [ ! "$T" ]; then
1082        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1083        return
1084    fi
1085    ("$T"/development/testrunner/runtest.py $@)
1086}
1087
1088function godir () {
1089    if [[ -z "$1" ]]; then
1090        echo "Usage: godir <regex>"
1091        return
1092    fi
1093    T=$(gettop)
1094    if [[ ! -f $T/filelist ]]; then
1095        echo -n "Creating index..."
1096        (cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > filelist)
1097        echo " Done"
1098        echo ""
1099    fi
1100    local lines
1101    lines=($(\grep "$1" $T/filelist | sed -e 's/\/[^/]*$//' | sort | uniq))
1102    if [[ ${#lines[@]} = 0 ]]; then
1103        echo "Not found"
1104        return
1105    fi
1106    local pathname
1107    local choice
1108    if [[ ${#lines[@]} > 1 ]]; then
1109        while [[ -z "$pathname" ]]; do
1110            local index=1
1111            local line
1112            for line in ${lines[@]}; do
1113                printf "%6s %s\n" "[$index]" $line
1114                index=$(($index + 1))
1115            done
1116            echo
1117            echo -n "Select one: "
1118            unset choice
1119            read choice
1120            if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then
1121                echo "Invalid choice"
1122                continue
1123            fi
1124            pathname=${lines[$(($choice-1))]}
1125        done
1126    else
1127        pathname=${lines[0]}
1128    fi
1129    cd $T/$pathname
1130}
1131
1132# Force JAVA_HOME to point to java 1.6 if it isn't already set
1133function set_java_home() {
1134    if [ ! "$JAVA_HOME" ]; then
1135        case `uname -s` in
1136            Darwin)
1137                export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
1138                ;;
1139            *)
1140                export JAVA_HOME=/usr/lib/jvm/java-6-sun
1141                ;;
1142        esac
1143    fi
1144}
1145
1146if [ "x$SHELL" != "x/bin/bash" ]; then
1147    case `ps -o command -p $$` in
1148        *bash*)
1149            ;;
1150        *)
1151            echo "WARNING: Only bash is supported, use of other shell would lead to erroneous results"
1152            ;;
1153    esac
1154fi
1155
1156# Execute the contents of any vendorsetup.sh files we can find.
1157for f in `/bin/ls vendor/*/vendorsetup.sh vendor/*/*/vendorsetup.sh device/*/*/vendorsetup.sh 2> /dev/null`
1158do
1159    echo "including $f"
1160    . $f
1161done
1162unset f
1163
1164addcompletions
1165