envsetup.sh

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