OSDN Git Service

am 19ccb3a6: am abc0bf08: Merge "SignApk: add support for EC keys"
[android-x86/build.git] / envsetup.sh
1 function hmm() {
2 cat <<EOF
3 Invoke ". build/envsetup.sh" from your shell to add the following functions to your environment:
4 - lunch:   lunch <product_name>-<build_variant>
5 - tapas:   tapas [<App1> <App2> ...] [arm|x86|mips|armv5] [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
17 Look at the source to view more functions. The complete list is:
18 EOF
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.
29 function 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.
41 function 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
53 function 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
69 VARIANT_CHOICES=(user userdebug eng)
70
71 # check to see if the supplied variant is valid
72 function 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
84 function setpaths()
85 {
86     T=$(gettop)
87     if [ ! "$T" ]; then
88         echo "Couldn't locate the top of the tree.  Try setting TOP."
89         return
90     fi
91
92     ##################################################################
93     #                                                                #
94     #              Read me before you modify this code               #
95     #                                                                #
96     #   This function sets ANDROID_BUILD_PATHS to what it is adding  #
97     #   to PATH, and the next time it is run, it removes that from   #
98     #   PATH.  This is required so lunch can be run more than once   #
99     #   and still have working paths.                                #
100     #                                                                #
101     ##################################################################
102
103     # Note: on windows/cygwin, ANDROID_BUILD_PATHS will contain spaces
104     # due to "C:\Program Files" being in the path.
105
106     # out with the old
107     if [ -n "$ANDROID_BUILD_PATHS" ] ; then
108         export PATH=${PATH/$ANDROID_BUILD_PATHS/}
109     fi
110     if [ -n "$ANDROID_PRE_BUILD_PATHS" ] ; then
111         export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/}
112         # strip leading ':', if any
113         export PATH=${PATH/:%/}
114     fi
115
116     # and in with the new
117     CODE_REVIEWS=
118     prebuiltdir=$(getprebuilt)
119     gccprebuiltdir=$(get_abs_build_var ANDROID_GCC_PREBUILTS)
120
121     # defined in core/config.mk
122     targetgccversion=$(get_build_var TARGET_GCC_VERSION)
123     export TARGET_GCC_VERSION=$targetgccversion
124
125     # The gcc toolchain does not exists for windows/cygwin. In this case, do not reference it.
126     export ANDROID_EABI_TOOLCHAIN=
127     local ARCH=$(get_build_var TARGET_ARCH)
128     case $ARCH in
129         x86) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
130             ;;
131         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
190 function 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
200 function 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
212 function set_sequence_number()
213 {
214     export BUILD_ENV_SEQUENCE_NUMBER=10
215 }
216
217 function 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
232 function 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
255 function 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 #
313 function 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
351 function 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
398 function 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.
417 unset LUNCH_MENU_CHOICES
418 function 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
431 add_lunch_combo aosp_arm-eng
432 add_lunch_combo aosp_x86-eng
433 add_lunch_combo aosp_mips-eng
434 add_lunch_combo vbox_x86-eng
435
436 function 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
455 function 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.
529 function _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 }
539 complete -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)
543 function 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
580 function 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
606 # Return driver for "make", if any (eg. static analyzer)
607 function getdriver()
608 {
609     local T="$1"
610     test "$WITH_STATIC_ANALYZER" = "0" && unset WITH_STATIC_ANALYZER
611     if [ -n "$WITH_STATIC_ANALYZER" ]; then
612         echo "\
613 $T/prebuilts/clang/linux-x86/host/3.3/tools/scan-build/scan-build \
614 --use-analyzer $T/prebuilts/clang/linux-x86/host/3.3/bin/analyzer \
615 --status-bugs \
616 --top=$T"
617     fi
618 }
619
620 function m()
621 {
622     local T=$(gettop)
623     local DRV=$(getdriver $T)
624     if [ "$T" ]; then
625         $DRV make -C $T -f build/core/main.mk $@
626     else
627         echo "Couldn't locate the top of the tree.  Try setting TOP."
628     fi
629 }
630
631 function findmakefile()
632 {
633     TOPFILE=build/core/envsetup.mk
634     local HERE=$PWD
635     T=
636     while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
637         T=`PWD= /bin/pwd`
638         if [ -f "$T/Android.mk" ]; then
639             echo $T/Android.mk
640             \cd $HERE
641             return
642         fi
643         \cd ..
644     done
645     \cd $HERE
646 }
647
648 function mm()
649 {
650     local T=$(gettop)
651     local DRV=$(getdriver $T)
652     # If we're sitting in the root of the build tree, just do a
653     # normal make.
654     if [ -f build/core/envsetup.mk -a -f Makefile ]; then
655         $DRV make $@
656     else
657         # Find the closest Android.mk file.
658         local M=$(findmakefile)
659         local MODULES=
660         local GET_INSTALL_PATH=
661         local ARGS=
662         # Remove the path to top as the makefilepath needs to be relative
663         local M=`echo $M|sed 's:'$T'/::'`
664         if [ ! "$T" ]; then
665             echo "Couldn't locate the top of the tree.  Try setting TOP."
666         elif [ ! "$M" ]; then
667             echo "Couldn't locate a makefile from the current directory."
668         else
669             for ARG in $@; do
670                 case $ARG in
671                   GET-INSTALL-PATH) GET_INSTALL_PATH=$ARG;;
672                 esac
673             done
674             if [ -n "$GET_INSTALL_PATH" ]; then
675               MODULES=
676               ARGS=GET-INSTALL-PATH
677             else
678               MODULES=all_modules
679               ARGS=$@
680             fi
681             ONE_SHOT_MAKEFILE=$M $DRV make -C $T -f build/core/main.mk $MODULES $ARGS
682         fi
683     fi
684 }
685
686 function mmm()
687 {
688     local T=$(gettop)
689     local DRV=$(getdriver $T)
690     if [ "$T" ]; then
691         local MAKEFILE=
692         local MODULES=
693         local ARGS=
694         local DIR TO_CHOP
695         local GET_INSTALL_PATH=
696         local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
697         local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
698         for DIR in $DIRS ; do
699             MODULES=`echo $DIR | sed -n -e 's/.*:\(.*$\)/\1/p' | sed 's/,/ /'`
700             if [ "$MODULES" = "" ]; then
701                 MODULES=all_modules
702             fi
703             DIR=`echo $DIR | sed -e 's/:.*//' -e 's:/$::'`
704             if [ -f $DIR/Android.mk ]; then
705                 local TO_CHOP=`(\cd -P -- $T && pwd -P) | wc -c | tr -d ' '`
706                 local TO_CHOP=`expr $TO_CHOP + 1`
707                 local START=`PWD= /bin/pwd`
708                 local MFILE=`echo $START | cut -c${TO_CHOP}-`
709                 if [ "$MFILE" = "" ] ; then
710                     MFILE=$DIR/Android.mk
711                 else
712                     MFILE=$MFILE/$DIR/Android.mk
713                 fi
714                 MAKEFILE="$MAKEFILE $MFILE"
715             else
716                 case $DIR in
717                   showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
718                   GET-INSTALL-PATH) GET_INSTALL_PATH=$DIR;;
719                   *) echo "No Android.mk in $DIR."; return 1;;
720                 esac
721             fi
722         done
723         if [ -n "$GET_INSTALL_PATH" ]; then
724           ARGS=$GET_INSTALL_PATH
725           MODULES=
726         fi
727         ONE_SHOT_MAKEFILE="$MAKEFILE" $DRV make -C $T -f build/core/main.mk $DASH_ARGS $MODULES $ARGS
728     else
729         echo "Couldn't locate the top of the tree.  Try setting TOP."
730     fi
731 }
732
733 function mma()
734 {
735   local T=$(gettop)
736   local DRV=$(getdriver $T)
737   if [ -f build/core/envsetup.mk -a -f Makefile ]; then
738     $DRV make $@
739   else
740     if [ ! "$T" ]; then
741       echo "Couldn't locate the top of the tree.  Try setting TOP."
742     fi
743     local MY_PWD=`PWD= /bin/pwd|sed 's:'$T'/::'`
744     $DRV make -C $T -f build/core/main.mk $@ all_modules BUILD_MODULES_IN_PATHS="$MY_PWD"
745   fi
746 }
747
748 function mmma()
749 {
750   local T=$(gettop)
751   local DRV=$(getdriver $T)
752   if [ "$T" ]; then
753     local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
754     local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
755     local MY_PWD=`PWD= /bin/pwd`
756     if [ "$MY_PWD" = "$T" ]; then
757       MY_PWD=
758     else
759       MY_PWD=`echo $MY_PWD|sed 's:'$T'/::'`
760     fi
761     local DIR=
762     local MODULE_PATHS=
763     local ARGS=
764     for DIR in $DIRS ; do
765       if [ -d $DIR ]; then
766         if [ "$MY_PWD" = "" ]; then
767           MODULE_PATHS="$MODULE_PATHS $DIR"
768         else
769           MODULE_PATHS="$MODULE_PATHS $MY_PWD/$DIR"
770         fi
771       else
772         case $DIR in
773           showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
774           *) echo "Couldn't find directory $DIR"; return 1;;
775         esac
776       fi
777     done
778     $DRV make -C $T -f build/core/main.mk $DASH_ARGS $ARGS all_modules BUILD_MODULES_IN_PATHS="$MODULE_PATHS"
779   else
780     echo "Couldn't locate the top of the tree.  Try setting TOP."
781   fi
782 }
783
784 function croot()
785 {
786     T=$(gettop)
787     if [ "$T" ]; then
788         \cd $(gettop)
789     else
790         echo "Couldn't locate the top of the tree.  Try setting TOP."
791     fi
792 }
793
794 function cproj()
795 {
796     TOPFILE=build/core/envsetup.mk
797     local HERE=$PWD
798     T=
799     while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
800         T=$PWD
801         if [ -f "$T/Android.mk" ]; then
802             \cd $T
803             return
804         fi
805         \cd ..
806     done
807     \cd $HERE
808     echo "can't find Android.mk"
809 }
810
811 # simplified version of ps; output in the form
812 # <pid> <procname>
813 function qpid() {
814     local prepend=''
815     local append=''
816     if [ "$1" = "--exact" ]; then
817         prepend=' '
818         append='$'
819         shift
820     elif [ "$1" = "--help" -o "$1" = "-h" ]; then
821                 echo "usage: qpid [[--exact] <process name|pid>"
822                 return 255
823         fi
824
825     local EXE="$1"
826     if [ "$EXE" ] ; then
827                 qpid | \grep "$prepend$EXE$append"
828         else
829                 adb shell ps \
830                         | tr -d '\r' \
831                         | sed -e 1d -e 's/^[^ ]* *\([0-9]*\).* \([^ ]*\)$/\1 \2/'
832         fi
833 }
834
835 function pid()
836 {
837     local prepend=''
838     local append=''
839     if [ "$1" = "--exact" ]; then
840         prepend=' '
841         append='$'
842         shift
843     fi
844     local EXE="$1"
845     if [ "$EXE" ] ; then
846         local PID=`adb shell ps \
847             | tr -d '\r' \
848             | \grep "$prepend$EXE$append" \
849             | sed -e 's/^[^ ]* *\([0-9]*\).*$/\1/'`
850         echo "$PID"
851     else
852         echo "usage: pid [--exact] <process name>"
853                 return 255
854     fi
855 }
856
857 # systemstack - dump the current stack trace of all threads in the system process
858 # to the usual ANR traces file
859 function systemstack()
860 {
861     stacks system_server
862 }
863
864 function stacks()
865 {
866     if [[ $1 =~ ^[0-9]+$ ]] ; then
867         local PID="$1"
868     elif [ "$1" ] ; then
869         local PIDLIST="$(pid $1)"
870         if [[ $PIDLIST =~ ^[0-9]+$ ]] ; then
871             local PID="$PIDLIST"
872         elif [ "$PIDLIST" ] ; then
873             echo "more than one process: $1"
874         else
875             echo "no such process: $1"
876         fi
877     else
878         echo "usage: stacks [pid|process name]"
879     fi
880
881     if [ "$PID" ] ; then
882         # Determine whether the process is native
883         if adb shell ls -l /proc/$PID/exe | grep -q /system/bin/app_process ; then
884             # Dump stacks of Dalvik process
885             local TRACES=/data/anr/traces.txt
886             local ORIG=/data/anr/traces.orig
887             local TMP=/data/anr/traces.tmp
888
889             # Keep original traces to avoid clobbering
890             adb shell mv $TRACES $ORIG
891
892             # Make sure we have a usable file
893             adb shell touch $TRACES
894             adb shell chmod 666 $TRACES
895
896             # Dump stacks and wait for dump to finish
897             adb shell kill -3 $PID
898             adb shell notify $TRACES >/dev/null
899
900             # Restore original stacks, and show current output
901             adb shell mv $TRACES $TMP
902             adb shell mv $ORIG $TRACES
903             adb shell cat $TMP
904         else
905             # Dump stacks of native process
906             adb shell debuggerd -b $PID
907         fi
908     fi
909 }
910
911 function gdbwrapper()
912 {
913     $ANDROID_TOOLCHAIN/$GDB -x "$@"
914 }
915
916 function gdbclient()
917 {
918    local OUT_ROOT=$(get_abs_build_var PRODUCT_OUT)
919    local OUT_SYMBOLS=$(get_abs_build_var TARGET_OUT_UNSTRIPPED)
920    local OUT_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED)
921    local OUT_EXE_SYMBOLS=$(get_abs_build_var TARGET_OUT_EXECUTABLES_UNSTRIPPED)
922    local PREBUILTS=$(get_abs_build_var ANDROID_PREBUILTS)
923    local ARCH=$(get_build_var TARGET_ARCH)
924    local GDB
925    case "$ARCH" in
926        x86) GDB=x86_64-linux-android-gdb;;
927        arm) GDB=arm-linux-androideabi-gdb;;
928        mips) GDB=mipsel-linux-android-gdb;;
929        *) echo "Unknown arch $ARCH"; return 1;;
930    esac
931
932    if [ "$OUT_ROOT" -a "$PREBUILTS" ]; then
933        local EXE="$1"
934        if [ "$EXE" ] ; then
935            EXE=$1
936        else
937            EXE="app_process"
938        fi
939
940        local PORT="$2"
941        if [ "$PORT" ] ; then
942            PORT=$2
943        else
944            PORT=":5039"
945        fi
946
947        local PID="$3"
948        if [ "$PID" ] ; then
949            if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
950                PID=`pid $3`
951                if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
952                    # that likely didn't work because of returning multiple processes
953                    # try again, filtering by root processes (don't contain colon)
954                    PID=`adb shell ps | \grep $3 | \grep -v ":" | awk '{print $2}'`
955                    if [[ ! "$PID" =~ ^[0-9]+$ ]]
956                    then
957                        echo "Couldn't resolve '$3' to single PID"
958                        return 1
959                    else
960                        echo ""
961                        echo "WARNING: multiple processes matching '$3' observed, using root process"
962                        echo ""
963                    fi
964                fi
965            fi
966            adb forward "tcp$PORT" "tcp$PORT"
967            adb shell gdbserver $PORT --attach $PID &
968            sleep 2
969        else
970                echo ""
971                echo "If you haven't done so already, do this first on the device:"
972                echo "    gdbserver $PORT /system/bin/$EXE"
973                    echo " or"
974                echo "    gdbserver $PORT --attach <PID>"
975                echo ""
976        fi
977
978        echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $OUT_SYMBOLS"
979        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"
980        echo >>"$OUT_ROOT/gdbclient.cmds" "source $ANDROID_BUILD_TOP/development/scripts/gdb/dalvik.gdb"
981        echo >>"$OUT_ROOT/gdbclient.cmds" "target remote $PORT"
982        echo >>"$OUT_ROOT/gdbclient.cmds" ""
983
984        gdbwrapper "$OUT_ROOT/gdbclient.cmds" "$OUT_EXE_SYMBOLS/$EXE"
985   else
986        echo "Unable to determine build system output dir."
987    fi
988
989 }
990
991 case `uname -s` in
992     Darwin)
993         function sgrep()
994         {
995             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 "$@"
996         }
997
998         ;;
999     *)
1000         function sgrep()
1001         {
1002             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 "$@"
1003         }
1004         ;;
1005 esac
1006
1007 function gettargetarch
1008 {
1009     get_build_var TARGET_ARCH
1010 }
1011
1012 function jgrep()
1013 {
1014     find . -name .repo -prune -o -name .git -prune -o  -type f -name "*\.java" -print0 | xargs -0 grep --color -n "$@"
1015 }
1016
1017 function cgrep()
1018 {
1019     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 "$@"
1020 }
1021
1022 function resgrep()
1023 {
1024     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;
1025 }
1026
1027 function mangrep()
1028 {
1029     find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -type f -name 'AndroidManifest.xml' -print0 | xargs -0 grep --color -n "$@"
1030 }
1031
1032 function sepgrep()
1033 {
1034     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 "$@"
1035 }
1036
1037 case `uname -s` in
1038     Darwin)
1039         function mgrep()
1040         {
1041             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 "$@"
1042         }
1043
1044         function treegrep()
1045         {
1046             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 "$@"
1047         }
1048
1049         ;;
1050     *)
1051         function mgrep()
1052         {
1053             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 "$@"
1054         }
1055
1056         function treegrep()
1057         {
1058             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 "$@"
1059         }
1060
1061         ;;
1062 esac
1063
1064 function getprebuilt
1065 {
1066     get_abs_build_var ANDROID_PREBUILTS
1067 }
1068
1069 function tracedmdump()
1070 {
1071     T=$(gettop)
1072     if [ ! "$T" ]; then
1073         echo "Couldn't locate the top of the tree.  Try setting TOP."
1074         return
1075     fi
1076     local prebuiltdir=$(getprebuilt)
1077     local arch=$(gettargetarch)
1078     local KERNEL=$T/prebuilts/qemu-kernel/$arch/vmlinux-qemu
1079
1080     local TRACE=$1
1081     if [ ! "$TRACE" ] ; then
1082         echo "usage:  tracedmdump  tracename"
1083         return
1084     fi
1085
1086     if [ ! -r "$KERNEL" ] ; then
1087         echo "Error: cannot find kernel: '$KERNEL'"
1088         return
1089     fi
1090
1091     local BASETRACE=$(basename $TRACE)
1092     if [ "$BASETRACE" = "$TRACE" ] ; then
1093         TRACE=$ANDROID_PRODUCT_OUT/traces/$TRACE
1094     fi
1095
1096     echo "post-processing traces..."
1097     rm -f $TRACE/qtrace.dexlist
1098     post_trace $TRACE
1099     if [ $? -ne 0 ]; then
1100         echo "***"
1101         echo "*** Error: malformed trace.  Did you remember to exit the emulator?"
1102         echo "***"
1103         return
1104     fi
1105     echo "generating dexlist output..."
1106     /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
1107     echo "generating dmtrace data..."
1108     q2dm -r $ANDROID_PRODUCT_OUT/symbols $TRACE $KERNEL $TRACE/dmtrace || return
1109     echo "generating html file..."
1110     dmtracedump -h $TRACE/dmtrace >| $TRACE/dmtrace.html || return
1111     echo "done, see $TRACE/dmtrace.html for details"
1112     echo "or run:"
1113     echo "    traceview $TRACE/dmtrace"
1114 }
1115
1116 # communicate with a running device or emulator, set up necessary state,
1117 # and run the hat command.
1118 function runhat()
1119 {
1120     # process standard adb options
1121     local adbTarget=""
1122     if [ "$1" = "-d" -o "$1" = "-e" ]; then
1123         adbTarget=$1
1124         shift 1
1125     elif [ "$1" = "-s" ]; then
1126         adbTarget="$1 $2"
1127         shift 2
1128     fi
1129     local adbOptions=${adbTarget}
1130     #echo adbOptions = ${adbOptions}
1131
1132     # runhat options
1133     local targetPid=$1
1134
1135     if [ "$targetPid" = "" ]; then
1136         echo "Usage: runhat [ -d | -e | -s serial ] target-pid"
1137         return
1138     fi
1139
1140     # confirm hat is available
1141     if [ -z $(which hat) ]; then
1142         echo "hat is not available in this configuration."
1143         return
1144     fi
1145
1146     # issue "am" command to cause the hprof dump
1147     local sdcard=$(adb ${adbOptions} shell echo -n '$EXTERNAL_STORAGE')
1148     local devFile=$sdcard/hprof-$targetPid
1149     #local devFile=/data/local/hprof-$targetPid
1150     echo "Poking $targetPid and waiting for data..."
1151     echo "Storing data at $devFile"
1152     adb ${adbOptions} shell am dumpheap $targetPid $devFile
1153     echo "Press enter when logcat shows \"hprof: heap dump completed\""
1154     echo -n "> "
1155     read
1156
1157     local localFile=/tmp/$$-hprof
1158
1159     echo "Retrieving file $devFile..."
1160     adb ${adbOptions} pull $devFile $localFile
1161
1162     adb ${adbOptions} shell rm $devFile
1163
1164     echo "Running hat on $localFile"
1165     echo "View the output by pointing your browser at http://localhost:7000/"
1166     echo ""
1167     hat -JXmx512m $localFile
1168 }
1169
1170 function getbugreports()
1171 {
1172     local reports=(`adb shell ls /sdcard/bugreports | tr -d '\r'`)
1173
1174     if [ ! "$reports" ]; then
1175         echo "Could not locate any bugreports."
1176         return
1177     fi
1178
1179     local report
1180     for report in ${reports[@]}
1181     do
1182         echo "/sdcard/bugreports/${report}"
1183         adb pull /sdcard/bugreports/${report} ${report}
1184         gunzip ${report}
1185     done
1186 }
1187
1188 function getsdcardpath()
1189 {
1190     adb ${adbOptions} shell echo -n \$\{EXTERNAL_STORAGE\}
1191 }
1192
1193 function getscreenshotpath()
1194 {
1195     echo "$(getsdcardpath)/Pictures/Screenshots"
1196 }
1197
1198 function getlastscreenshot()
1199 {
1200     local screenshot_path=$(getscreenshotpath)
1201     local screenshot=`adb ${adbOptions} ls ${screenshot_path} | grep Screenshot_[0-9-]*.*\.png | sort -rk 3 | cut -d " " -f 4 | head -n 1`
1202     if [ "$screenshot" = "" ]; then
1203         echo "No screenshots found."
1204         return
1205     fi
1206     echo "${screenshot}"
1207     adb ${adbOptions} pull ${screenshot_path}/${screenshot}
1208 }
1209
1210 function startviewserver()
1211 {
1212     local port=4939
1213     if [ $# -gt 0 ]; then
1214             port=$1
1215     fi
1216     adb shell service call window 1 i32 $port
1217 }
1218
1219 function stopviewserver()
1220 {
1221     adb shell service call window 2
1222 }
1223
1224 function isviewserverstarted()
1225 {
1226     adb shell service call window 3
1227 }
1228
1229 function key_home()
1230 {
1231     adb shell input keyevent 3
1232 }
1233
1234 function key_back()
1235 {
1236     adb shell input keyevent 4
1237 }
1238
1239 function key_menu()
1240 {
1241     adb shell input keyevent 82
1242 }
1243
1244 function smoketest()
1245 {
1246     if [ ! "$ANDROID_PRODUCT_OUT" ]; then
1247         echo "Couldn't locate output files.  Try running 'lunch' first." >&2
1248         return
1249     fi
1250     T=$(gettop)
1251     if [ ! "$T" ]; then
1252         echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1253         return
1254     fi
1255
1256     (\cd "$T" && mmm tests/SmokeTest) &&
1257       adb uninstall com.android.smoketest > /dev/null &&
1258       adb uninstall com.android.smoketest.tests > /dev/null &&
1259       adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTestApp.apk &&
1260       adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTest.apk &&
1261       adb shell am instrument -w com.android.smoketest.tests/android.test.InstrumentationTestRunner
1262 }
1263
1264 # simple shortcut to the runtest command
1265 function runtest()
1266 {
1267     T=$(gettop)
1268     if [ ! "$T" ]; then
1269         echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1270         return
1271     fi
1272     ("$T"/development/testrunner/runtest.py $@)
1273 }
1274
1275 function godir () {
1276     if [[ -z "$1" ]]; then
1277         echo "Usage: godir <regex>"
1278         return
1279     fi
1280     T=$(gettop)
1281     if [[ ! -f $T/filelist ]]; then
1282         echo -n "Creating index..."
1283         (\cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > filelist)
1284         echo " Done"
1285         echo ""
1286     fi
1287     local lines
1288     lines=($(\grep "$1" $T/filelist | sed -e 's/\/[^/]*$//' | sort | uniq))
1289     if [[ ${#lines[@]} = 0 ]]; then
1290         echo "Not found"
1291         return
1292     fi
1293     local pathname
1294     local choice
1295     if [[ ${#lines[@]} > 1 ]]; then
1296         while [[ -z "$pathname" ]]; do
1297             local index=1
1298             local line
1299             for line in ${lines[@]}; do
1300                 printf "%6s %s\n" "[$index]" $line
1301                 index=$(($index + 1))
1302             done
1303             echo
1304             echo -n "Select one: "
1305             unset choice
1306             read choice
1307             if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then
1308                 echo "Invalid choice"
1309                 continue
1310             fi
1311             pathname=${lines[$(($choice-1))]}
1312         done
1313     else
1314         pathname=${lines[0]}
1315     fi
1316     \cd $T/$pathname
1317 }
1318
1319 # Force JAVA_HOME to point to java 1.6 if it isn't already set
1320 function set_java_home() {
1321     if [ ! "$JAVA_HOME" ]; then
1322         case `uname -s` in
1323             Darwin)
1324                 export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
1325                 ;;
1326             *)
1327                 export JAVA_HOME=/usr/lib/jvm/java-6-sun
1328                 ;;
1329         esac
1330     fi
1331 }
1332
1333 # Print colored exit condition
1334 function pez {
1335     "$@"
1336     local retval=$?
1337     if [ $retval -ne 0 ]
1338     then
1339         echo -e "\e[0;31mFAILURE\e[00m"
1340     else
1341         echo -e "\e[0;32mSUCCESS\e[00m"
1342     fi
1343     return $retval
1344 }
1345
1346 if [ "x$SHELL" != "x/bin/bash" ]; then
1347     case `ps -o command -p $$` in
1348         *bash*)
1349             ;;
1350         *)
1351             echo "WARNING: Only bash is supported, use of other shell would lead to erroneous results"
1352             ;;
1353     esac
1354 fi
1355
1356 # Execute the contents of any vendorsetup.sh files we can find.
1357 for f in `test -d device && find device -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null` \
1358          `test -d vendor && find vendor -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null`
1359 do
1360     echo "including $f"
1361     . $f
1362 done
1363 unset f
1364
1365 addcompletions