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