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