| # Copyright (C) 2022 The Android Open Source Project |
| # |
| # Licensed under the Apache License, Version 2.0 (the "License"); |
| # you may not use this file except in compliance with the License. |
| # You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| |
| # gettop is duplicated here and in shell_utils.mk, because it's difficult |
| # to find shell_utils.make without it for all the novel ways this file can be |
| # sourced. Other common functions should only be in one place or the other. |
| function _gettop_once |
| { |
| local TOPFILE=build/make/core/envsetup.mk |
| if [ -n "$TOP" -a -f "$TOP/$TOPFILE" ] ; then |
| # The following circumlocution ensures we remove symlinks from TOP. |
| (cd "$TOP"; PWD= /bin/pwd) |
| else |
| if [ -f $TOPFILE ] ; then |
| # The following circumlocution (repeated below as well) ensures |
| # that we record the true directory name and not one that is |
| # faked up with symlink names. |
| PWD= /bin/pwd |
| else |
| local HERE=$PWD |
| local T= |
| while [ \( ! \( -f $TOPFILE \) \) -a \( "$PWD" != "/" \) ]; do |
| \cd .. |
| T=`PWD= /bin/pwd -P` |
| done |
| \cd "$HERE" |
| if [ -f "$T/$TOPFILE" ]; then |
| echo "$T" |
| fi |
| fi |
| fi |
| } |
| T=$(_gettop_once) |
| if [ ! "$T" ]; then |
| echo "Couldn't locate the top of the tree. Always source build/envsetup.sh from the root of the tree." >&2 |
| return 1 |
| fi |
| IMPORTING_ENVSETUP=true source $T/build/make/shell_utils.sh |
| |
| # Get all the build variables needed by this script in a single call to the build system. |
| function build_build_var_cache() |
| { |
| local T=$(gettop) |
| # Grep out the variable names from the script. |
| cached_vars=(`cat $T/build/envsetup.sh | tr '()' ' ' | awk '{for(i=1;i<=NF;i++) if($i~/_get_build_var_cached/) print $(i+1)}' | sort -u | tr '\n' ' '`) |
| cached_abs_vars=(`cat $T/build/envsetup.sh | tr '()' ' ' | awk '{for(i=1;i<=NF;i++) if($i~/_get_abs_build_var_cached/) print $(i+1)}' | sort -u | tr '\n' ' '`) |
| # Call the build system to dump the "<val>=<value>" pairs as a shell script. |
| build_dicts_script=`\builtin cd $T; build/soong/soong_ui.bash --dumpvars-mode \ |
| --vars="${cached_vars[*]}" \ |
| --abs-vars="${cached_abs_vars[*]}" \ |
| --var-prefix=var_cache_ \ |
| --abs-var-prefix=abs_var_cache_` |
| local ret=$? |
| if [ $ret -ne 0 ] |
| then |
| unset build_dicts_script |
| return $ret |
| fi |
| # Execute the script to store the "<val>=<value>" pairs as shell variables. |
| eval "$build_dicts_script" |
| ret=$? |
| unset build_dicts_script |
| if [ $ret -ne 0 ] |
| then |
| return $ret |
| fi |
| BUILD_VAR_CACHE_READY="true" |
| } |
| |
| # Delete the build var cache, so that we can still call into the build system |
| # to get build variables not listed in this script. |
| function destroy_build_var_cache() |
| { |
| unset BUILD_VAR_CACHE_READY |
| local v |
| for v in $cached_vars; do |
| unset var_cache_$v |
| done |
| unset cached_vars |
| for v in $cached_abs_vars; do |
| unset abs_var_cache_$v |
| done |
| unset cached_abs_vars |
| } |
| |
| # Get the value of a build variable as an absolute path. |
| function _get_abs_build_var_cached() |
| { |
| if [ "$BUILD_VAR_CACHE_READY" = "true" ] |
| then |
| eval "echo \"\${abs_var_cache_$1}\"" |
| return |
| fi |
| |
| local T=$(gettop) |
| if [ ! "$T" ]; then |
| echo "Couldn't locate the top of the tree. Try setting TOP." >&2 |
| return |
| fi |
| (\cd $T; build/soong/soong_ui.bash --dumpvar-mode --abs $1) |
| } |
| |
| # Get the exact value of a build variable. |
| function _get_build_var_cached() |
| { |
| if [ "$BUILD_VAR_CACHE_READY" = "true" ] |
| then |
| eval "echo \"\${var_cache_$1}\"" |
| return 0 |
| fi |
| |
| local T=$(gettop) |
| if [ ! "$T" ]; then |
| echo "Couldn't locate the top of the tree. Try setting TOP." >&2 |
| return 1 |
| fi |
| (\cd $T; build/soong/soong_ui.bash --dumpvar-mode $1) |
| } |
| |
| # This logic matches envsetup.mk |
| function get_host_prebuilt_prefix |
| { |
| local un=$(uname) |
| if [[ $un == "Linux" ]] ; then |
| echo linux-x86 |
| elif [[ $un == "Darwin" ]] ; then |
| echo darwin-x86 |
| else |
| echo "Error: Invalid host operating system: $un" 1>&2 |
| fi |
| } |
| |
| # Add directories to PATH that are dependent on the lunch target. |
| # For directories that are not lunch-specific, add them in set_global_paths |
| function set_lunch_paths() |
| { |
| local T=$(gettop) |
| if [ ! "$T" ]; then |
| echo "Couldn't locate the top of the tree. Try setting TOP." |
| return |
| fi |
| |
| ################################################################## |
| # # |
| # Read me before you modify this code # |
| # # |
| # This function sets ANDROID_LUNCH_BUILD_PATHS to what it is # |
| # adding to PATH, and the next time it is run, it removes that # |
| # from PATH. This is required so lunch can be run more than # |
| # once and still have working paths. # |
| # # |
| ################################################################## |
| |
| # Note: on windows/cygwin, ANDROID_LUNCH_BUILD_PATHS will contain spaces |
| # due to "C:\Program Files" being in the path. |
| |
| # Handle compat with the old ANDROID_BUILD_PATHS variable. |
| # TODO: Remove this after we think everyone has lunched again. |
| if [ -z "$ANDROID_LUNCH_BUILD_PATHS" -a -n "$ANDROID_BUILD_PATHS" ] ; then |
| ANDROID_LUNCH_BUILD_PATHS="$ANDROID_BUILD_PATHS" |
| ANDROID_BUILD_PATHS= |
| fi |
| if [ -n "$ANDROID_PRE_BUILD_PATHS" ] ; then |
| export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/} |
| # strip leading ':', if any |
| export PATH=${PATH/:%/} |
| ANDROID_PRE_BUILD_PATHS= |
| fi |
| |
| # Out with the old... |
| if [ -n "$ANDROID_LUNCH_BUILD_PATHS" ] ; then |
| export PATH=${PATH/$ANDROID_LUNCH_BUILD_PATHS/} |
| fi |
| |
| # And in with the new... |
| ANDROID_LUNCH_BUILD_PATHS=$(_get_abs_build_var_cached SOONG_HOST_OUT_EXECUTABLES) |
| ANDROID_LUNCH_BUILD_PATHS+=:$(_get_abs_build_var_cached HOST_OUT_EXECUTABLES) |
| |
| # Append llvm binutils prebuilts path to ANDROID_LUNCH_BUILD_PATHS. |
| local ANDROID_LLVM_BINUTILS=$(_get_abs_build_var_cached ANDROID_CLANG_PREBUILTS)/llvm-binutils-stable |
| ANDROID_LUNCH_BUILD_PATHS+=:$ANDROID_LLVM_BINUTILS |
| |
| # Set up ASAN_SYMBOLIZER_PATH for SANITIZE_HOST=address builds. |
| export ASAN_SYMBOLIZER_PATH=$ANDROID_LLVM_BINUTILS/llvm-symbolizer |
| |
| # Append asuite prebuilts path to ANDROID_LUNCH_BUILD_PATHS. |
| local os_arch=$(_get_build_var_cached HOST_PREBUILT_TAG) |
| ANDROID_LUNCH_BUILD_PATHS+=:$T/prebuilts/asuite/acloud/$os_arch |
| ANDROID_LUNCH_BUILD_PATHS+=:$T/prebuilts/asuite/aidegen/$os_arch |
| ANDROID_LUNCH_BUILD_PATHS+=:$T/prebuilts/asuite/atest/$os_arch |
| |
| export ANDROID_JAVA_HOME=$(_get_abs_build_var_cached ANDROID_JAVA_HOME) |
| export JAVA_HOME=$ANDROID_JAVA_HOME |
| export ANDROID_JAVA_TOOLCHAIN=$(_get_abs_build_var_cached ANDROID_JAVA_TOOLCHAIN) |
| ANDROID_LUNCH_BUILD_PATHS+=:$ANDROID_JAVA_TOOLCHAIN |
| |
| # Fix up PYTHONPATH |
| if [ -n $ANDROID_PYTHONPATH ]; then |
| export PYTHONPATH=${PYTHONPATH//$ANDROID_PYTHONPATH/} |
| fi |
| # //development/python-packages contains both a pseudo-PYTHONPATH which |
| # mimics an already assembled venv, but also contains real Python packages |
| # that are not in that layout until they are installed. We can fake it for |
| # the latter type by adding the package source directories to the PYTHONPATH |
| # directly. For the former group, we only need to add the python-packages |
| # directory itself. |
| # |
| # This could be cleaned up by converting the remaining packages that are in |
| # the first category into a typical python source layout (that is, another |
| # layer of directory nesting) and automatically adding all subdirectories of |
| # python-packages to the PYTHONPATH instead of manually curating this. We |
| # can't convert the packages like adb to the other style because doing so |
| # would prevent exporting type info from those packages. |
| # |
| # http://b/266688086 |
| export ANDROID_PYTHONPATH=$T/development/python-packages/adb:$T/development/python-packages/gdbrunner:$T/development/python-packages: |
| if [ -n $VENDOR_PYTHONPATH ]; then |
| ANDROID_PYTHONPATH=$ANDROID_PYTHONPATH$VENDOR_PYTHONPATH |
| fi |
| export PYTHONPATH=$ANDROID_PYTHONPATH$PYTHONPATH |
| |
| unset ANDROID_PRODUCT_OUT |
| export ANDROID_PRODUCT_OUT=$(_get_abs_build_var_cached PRODUCT_OUT) |
| export OUT=$ANDROID_PRODUCT_OUT |
| |
| unset ANDROID_HOST_OUT |
| export ANDROID_HOST_OUT=$(_get_abs_build_var_cached HOST_OUT) |
| |
| unset ANDROID_SOONG_HOST_OUT |
| export ANDROID_SOONG_HOST_OUT=$(_get_abs_build_var_cached SOONG_HOST_OUT) |
| |
| unset ANDROID_HOST_OUT_TESTCASES |
| export ANDROID_HOST_OUT_TESTCASES=$(_get_abs_build_var_cached HOST_OUT_TESTCASES) |
| |
| unset ANDROID_TARGET_OUT_TESTCASES |
| export ANDROID_TARGET_OUT_TESTCASES=$(_get_abs_build_var_cached TARGET_OUT_TESTCASES) |
| |
| # Finally, set PATH |
| export PATH=$ANDROID_LUNCH_BUILD_PATHS:$PATH |
| } |
| |
| # Add directories to PATH that are NOT dependent on the lunch target. |
| # For directories that are lunch-specific, add them in set_lunch_paths |
| function set_global_paths() |
| { |
| local T=$(gettop) |
| if [ ! "$T" ]; then |
| echo "Couldn't locate the top of the tree. Try setting TOP." |
| return |
| fi |
| |
| ################################################################## |
| # # |
| # Read me before you modify this code # |
| # # |
| # This function sets ANDROID_GLOBAL_BUILD_PATHS to what it is # |
| # adding to PATH, and the next time it is run, it removes that # |
| # from PATH. This is required so envsetup.sh can be sourced # |
| # more than once and still have working paths. # |
| # # |
| ################################################################## |
| |
| # Out with the old... |
| if [ -n "$ANDROID_GLOBAL_BUILD_PATHS" ] ; then |
| export PATH=${PATH/$ANDROID_GLOBAL_BUILD_PATHS/} |
| fi |
| |
| # And in with the new... |
| ANDROID_GLOBAL_BUILD_PATHS=$T/build/soong/bin |
| ANDROID_GLOBAL_BUILD_PATHS+=:$T/build/bazel/bin |
| ANDROID_GLOBAL_BUILD_PATHS+=:$T/development/scripts |
| ANDROID_GLOBAL_BUILD_PATHS+=:$T/prebuilts/devtools/tools |
| |
| # add kernel specific binaries |
| if [ $(uname -s) = Linux ] ; then |
| ANDROID_GLOBAL_BUILD_PATHS+=:$T/prebuilts/misc/linux-x86/dtc |
| ANDROID_GLOBAL_BUILD_PATHS+=:$T/prebuilts/misc/linux-x86/libufdt |
| fi |
| |
| # If prebuilts/android-emulator/<system>/ exists, prepend it to our PATH |
| # to ensure that the corresponding 'emulator' binaries are used. |
| case $(uname -s) in |
| Darwin) |
| ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/darwin-x86_64 |
| ;; |
| Linux) |
| ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/linux-x86_64 |
| ;; |
| *) |
| ANDROID_EMULATOR_PREBUILTS= |
| ;; |
| esac |
| if [ -n "$ANDROID_EMULATOR_PREBUILTS" -a -d "$ANDROID_EMULATOR_PREBUILTS" ]; then |
| ANDROID_GLOBAL_BUILD_PATHS+=:$ANDROID_EMULATOR_PREBUILTS |
| export ANDROID_EMULATOR_PREBUILTS |
| fi |
| |
| # Finally, set PATH |
| export PATH=$ANDROID_GLOBAL_BUILD_PATHS:$PATH |
| } |
| |
| function printconfig() |
| { |
| local T=$(gettop) |
| if [ ! "$T" ]; then |
| echo "Couldn't locate the top of the tree. Try setting TOP." >&2 |
| return |
| fi |
| _get_build_var_cached report_config |
| } |
| |
| function set_stuff_for_environment() |
| { |
| set_lunch_paths |
| set_sequence_number |
| |
| export ANDROID_BUILD_TOP=$(gettop) |
| } |
| |
| function set_sequence_number() |
| { |
| export BUILD_ENV_SEQUENCE_NUMBER=13 |
| } |
| |
| # Takes a command name, and check if it's in ENVSETUP_NO_COMPLETION or not. |
| function should_add_completion() { |
| local cmd="$(basename $1| sed 's/_completion//' |sed 's/\.\(.*\)*sh$//')" |
| case :"$ENVSETUP_NO_COMPLETION": in |
| *:"$cmd":*) |
| return 1 |
| ;; |
| esac |
| return 0 |
| } |
| |
| function addcompletions() |
| { |
| local f= |
| |
| # Keep us from trying to run in something that's neither bash nor zsh. |
| if [ -z "$BASH_VERSION" -a -z "$ZSH_VERSION" ]; then |
| return |
| fi |
| |
| # Keep us from trying to run in bash that's too old. |
| if [ -n "$BASH_VERSION" -a ${BASH_VERSINFO[0]} -lt 3 ]; then |
| return |
| fi |
| |
| local completion_files=( |
| packages/modules/adb/adb.bash |
| system/core/fastboot/fastboot.bash |
| tools/asuite/asuite.sh |
| prebuilts/bazel/common/bazel-complete.bash |
| ) |
| # Completion can be disabled selectively to allow users to use non-standard completion. |
| # e.g. |
| # ENVSETUP_NO_COMPLETION=adb # -> disable adb completion |
| # ENVSETUP_NO_COMPLETION=adb:bit # -> disable adb and bit completion |
| local T=$(gettop) |
| for f in ${completion_files[*]}; do |
| f="$T/$f" |
| if [ ! -f "$f" ]; then |
| echo "Warning: completion file $f not found" |
| elif should_add_completion "$f"; then |
| . $f |
| fi |
| done |
| |
| if [ -z "$ZSH_VERSION" ]; then |
| # Doesn't work in zsh. |
| complete -o nospace -F _croot croot |
| # TODO(b/244559459): Support b autocompletion for zsh |
| complete -F _bazel__complete -o nospace b |
| fi |
| complete -F _lunch lunch |
| complete -F _lunch_completion lunch2 |
| |
| complete -F _complete_android_module_names pathmod |
| complete -F _complete_android_module_names gomod |
| complete -F _complete_android_module_names outmod |
| complete -F _complete_android_module_names installmod |
| complete -F _complete_android_module_names m |
| } |
| |
| function add_lunch_combo() |
| { |
| if [ -n "$ZSH_VERSION" ]; then |
| echo -n "${funcfiletrace[1]}: " |
| else |
| echo -n "${BASH_SOURCE[1]}:${BASH_LINENO[0]}: " |
| fi |
| echo "add_lunch_combo is obsolete. Use COMMON_LUNCH_CHOICES in your AndroidProducts.mk instead." |
| } |
| |
| function print_lunch_menu() |
| { |
| local uname=$(uname) |
| local choices |
| choices=$(TARGET_BUILD_APPS= TARGET_PRODUCT= TARGET_RELEASE= TARGET_BUILD_VARIANT= _get_build_var_cached COMMON_LUNCH_CHOICES 2>/dev/null) |
| local ret=$? |
| |
| echo |
| echo "You're building on" $uname |
| echo |
| |
| if [ $ret -ne 0 ] |
| then |
| echo "Warning: Cannot display lunch menu." |
| echo |
| echo "Note: You can invoke lunch with an explicit target:" |
| echo |
| echo " usage: lunch [target]" >&2 |
| echo |
| return |
| fi |
| |
| echo "Lunch menu .. Here are the common combinations:" |
| |
| local i=1 |
| local choice |
| for choice in $(echo $choices) |
| do |
| echo " $i. $choice" |
| i=$(($i+1)) |
| done |
| |
| echo |
| } |
| |
| function lunch() |
| { |
| local answer |
| |
| if [[ $# -gt 1 ]]; then |
| echo "usage: lunch [target]" >&2 |
| return 1 |
| fi |
| |
| local used_lunch_menu=0 |
| |
| if [ "$1" ]; then |
| answer=$1 |
| else |
| print_lunch_menu |
| echo "Which would you like? [aosp_cf_x86_64_phone-trunk_staging-eng]" |
| echo -n "Pick from common choices above (e.g. 13) or specify your own (e.g. aosp_barbet-trunk_staging-eng): " |
| read answer |
| used_lunch_menu=1 |
| fi |
| |
| local selection= |
| |
| if [ -z "$answer" ] |
| then |
| selection=aosp_cf_x86_64_phone-trunk_staging-eng |
| elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$") |
| then |
| local choices=($(TARGET_BUILD_APPS= TARGET_PRODUCT= TARGET_RELEASE= TARGET_BUILD_VARIANT= _get_build_var_cached COMMON_LUNCH_CHOICES 2>/dev/null)) |
| if [ $answer -le ${#choices[@]} ] |
| then |
| # array in zsh starts from 1 instead of 0. |
| if [ -n "$ZSH_VERSION" ] |
| then |
| selection=${choices[$(($answer))]} |
| else |
| selection=${choices[$(($answer-1))]} |
| fi |
| fi |
| else |
| selection=$answer |
| fi |
| |
| export TARGET_BUILD_APPS= |
| |
| # This must be <product>-<release>-<variant> |
| local product release variant |
| # Split string on the '-' character. |
| IFS="-" read -r product release variant <<< "$selection" |
| |
| if [[ -z "$product" ]] || [[ -z "$release" ]] || [[ -z "$variant" ]] |
| then |
| echo |
| echo "Invalid lunch combo: $selection" |
| echo "Valid combos must be of the form <product>-<release>-<variant>" |
| return 1 |
| fi |
| |
| _lunch_meat $product $release $variant |
| } |
| |
| function _lunch_meat() |
| { |
| local product=$1 |
| local release=$2 |
| local variant=$3 |
| |
| TARGET_PRODUCT=$product \ |
| TARGET_RELEASE=$release \ |
| TARGET_BUILD_VARIANT=$variant \ |
| build_build_var_cache |
| if [ $? -ne 0 ] |
| then |
| if [[ "$product" =~ .*_(eng|user|userdebug) ]] |
| then |
| echo "Did you mean -${product/*_/}? (dash instead of underscore)" |
| fi |
| return 1 |
| fi |
| export TARGET_PRODUCT=$(_get_build_var_cached TARGET_PRODUCT) |
| export TARGET_BUILD_VARIANT=$(_get_build_var_cached TARGET_BUILD_VARIANT) |
| export TARGET_RELEASE=$release |
| # Note this is the string "release", not the value of the variable. |
| export TARGET_BUILD_TYPE=release |
| |
| [[ -n "${ANDROID_QUIET_BUILD:-}" ]] || echo |
| |
| set_stuff_for_environment |
| [[ -n "${ANDROID_QUIET_BUILD:-}" ]] || printconfig |
| |
| if [[ -z "${ANDROID_QUIET_BUILD}" ]]; then |
| local spam_for_lunch=$(gettop)/build/make/tools/envsetup/spam_for_lunch |
| if [[ -x $spam_for_lunch ]]; then |
| $spam_for_lunch |
| fi |
| fi |
| |
| destroy_build_var_cache |
| |
| if [[ -n "${CHECK_MU_CONFIG:-}" ]]; then |
| check_mu_config |
| fi |
| } |
| |
| unset COMMON_LUNCH_CHOICES_CACHE |
| # Tab completion for lunch. |
| function _lunch() |
| { |
| local cur prev opts |
| COMPREPLY=() |
| cur="${COMP_WORDS[COMP_CWORD]}" |
| prev="${COMP_WORDS[COMP_CWORD-1]}" |
| |
| if [ -z "$COMMON_LUNCH_CHOICES_CACHE" ]; then |
| COMMON_LUNCH_CHOICES_CACHE=$(TARGET_BUILD_APPS= _get_build_var_cached COMMON_LUNCH_CHOICES) |
| fi |
| |
| COMPREPLY=( $(compgen -W "${COMMON_LUNCH_CHOICES_CACHE}" -- ${cur}) ) |
| return 0 |
| } |
| |
| function _lunch_usage() |
| { |
| ( |
| echo "The lunch command selects the configuration to use for subsequent" |
| echo "Android builds." |
| echo |
| echo "Usage: lunch TARGET_PRODUCT [TARGET_RELEASE [TARGET_BUILD_VARIANT]]" |
| echo |
| echo " Choose the product, release and variant to use. If not" |
| echo " supplied, TARGET_RELEASE will be 'trunk_staging' and" |
| echo " TARGET_BUILD_VARIANT will be 'eng'" |
| echo |
| echo |
| echo "Usage: lunch TARGET_PRODUCT-TARGET_RELEASE-TARGET_BUILD_VARIANT" |
| echo |
| echo " Chose the product, release and variant to use. This" |
| echo " legacy format is maintained for compatibility." |
| echo |
| echo |
| echo "Note that the previous interactive menu and list of hard-coded" |
| echo "list of curated targets has been removed. If you would like the" |
| echo "list of products, release configs for a particular product, or" |
| echo "variants, run list_products, list_release_configs, list_variants" |
| echo "respectively." |
| echo |
| ) 1>&2 |
| } |
| |
| function lunch2() |
| { |
| if [[ $# -eq 1 && $1 = "--help" ]]; then |
| _lunch_usage |
| return 0 |
| fi |
| if [[ $# -eq 0 ]]; then |
| echo "No target specified. See lunch --help" 1>&2 |
| return 1 |
| fi |
| if [[ $# -gt 3 ]]; then |
| echo "Too many parameters given. See lunch --help" 1>&2 |
| return 1 |
| fi |
| |
| local product release variant |
| |
| # Handle the legacy format |
| local legacy=$(echo $1 | grep "-") |
| if [[ $# -eq 1 && -n $legacy ]]; then |
| IFS="-" read -r product release variant <<< "$1" |
| if [[ -z "$product" ]] || [[ -z "$release" ]] || [[ -z "$variant" ]]; then |
| echo "Invalid lunch combo: $1" 1>&2 |
| echo "Valid combos must be of the form <product>-<release>-<variant> when using" 1>&2 |
| echo "the legacy format. Run 'lunch --help' for usage." 1>&2 |
| return 1 |
| fi |
| fi |
| |
| # Handle the new format. |
| if [[ -z $legacy ]]; then |
| product=$1 |
| release=$2 |
| if [[ -z $release ]]; then |
| release=trunk_staging |
| fi |
| variant=$3 |
| if [[ -z $variant ]]; then |
| variant=eng |
| fi |
| fi |
| |
| # Validate the selection and set all the environment stuff |
| _lunch_meat $product $release $variant |
| } |
| |
| unset ANDROID_LUNCH_COMPLETION_PRODUCT_CACHE |
| unset ANDROID_LUNCH_COMPLETION_CHOSEN_PRODUCT |
| unset ANDROID_LUNCH_COMPLETION_RELEASE_CACHE |
| # Tab completion for lunch. |
| function _lunch_completion() |
| { |
| # Available products |
| if [[ $COMP_CWORD -eq 1 ]] ; then |
| if [[ -z $ANDROID_LUNCH_COMPLETION_PRODUCT_CACHE ]]; then |
| ANDROID_LUNCH_COMPLETION_PRODUCT_CACHE=$(list_products) |
| fi |
| COMPREPLY=( $(compgen -W "${ANDROID_LUNCH_COMPLETION_PRODUCT_CACHE}" -- "${COMP_WORDS[COMP_CWORD]}") ) |
| fi |
| |
| # Available release configs |
| if [[ $COMP_CWORD -eq 2 ]] ; then |
| if [[ -z $ANDROID_LUNCH_COMPLETION_RELEASE_CACHE || $ANDROID_LUNCH_COMPLETION_CHOSEN_PRODUCT != ${COMP_WORDS[1]} ]] ; then |
| ANDROID_LUNCH_COMPLETION_RELEASE_CACHE=$(list_releases ${COMP_WORDS[1]}) |
| ANDROID_LUNCH_COMPLETION_CHOSEN_PRODUCT=${COMP_WORDS[1]} |
| fi |
| COMPREPLY=( $(compgen -W "${ANDROID_LUNCH_COMPLETION_RELEASE_CACHE}" -- "${COMP_WORDS[COMP_CWORD]}") ) |
| fi |
| |
| # Available variants |
| if [[ $COMP_CWORD -eq 3 ]] ; then |
| COMPREPLY=(user userdebug eng) |
| fi |
| |
| return 0 |
| } |
| |
| |
| # Configures the build to build unbundled apps. |
| # Run tapas with one or more app names (from LOCAL_PACKAGE_NAME) |
| function tapas() |
| { |
| local showHelp="$(echo $* | xargs -n 1 echo | \grep -E '^(help)$' | xargs)" |
| local arch="$(echo $* | xargs -n 1 echo | \grep -E '^(arm|x86|arm64|x86_64)$' | xargs)" |
| # TODO(b/307975293): Expand tapas to take release arguments (and update hmm() usage). |
| local release="trunk_staging" |
| local variant="$(echo $* | xargs -n 1 echo | \grep -E '^(user|userdebug|eng)$' | xargs)" |
| local density="$(echo $* | xargs -n 1 echo | \grep -E '^(ldpi|mdpi|tvdpi|hdpi|xhdpi|xxhdpi|xxxhdpi|alldpi)$' | xargs)" |
| local keys="$(echo $* | xargs -n 1 echo | \grep -E '^(devkeys)$' | xargs)" |
| local apps="$(echo $* | xargs -n 1 echo | \grep -E -v '^(user|userdebug|eng|arm|x86|arm64|x86_64|ldpi|mdpi|tvdpi|hdpi|xhdpi|xxhdpi|xxxhdpi|alldpi|devkeys)$' | xargs)" |
| |
| |
| if [ "$showHelp" != "" ]; then |
| $(gettop)/build/make/tapasHelp.sh |
| return |
| fi |
| |
| if [ $(echo $arch | wc -w) -gt 1 ]; then |
| echo "tapas: Error: Multiple build archs supplied: $arch" |
| return |
| fi |
| if [ $(echo $release | wc -w) -gt 1 ]; then |
| echo "tapas: Error: Multiple build releases supplied: $release" |
| return |
| fi |
| if [ $(echo $variant | wc -w) -gt 1 ]; then |
| echo "tapas: Error: Multiple build variants supplied: $variant" |
| return |
| fi |
| if [ $(echo $density | wc -w) -gt 1 ]; then |
| echo "tapas: Error: Multiple densities supplied: $density" |
| return |
| fi |
| if [ $(echo $keys | wc -w) -gt 1 ]; then |
| echo "tapas: Error: Multiple keys supplied: $keys" |
| return |
| fi |
| |
| local product=aosp_arm |
| case $arch in |
| x86) product=aosp_x86;; |
| arm64) product=aosp_arm64;; |
| x86_64) product=aosp_x86_64;; |
| esac |
| if [ -n "$keys" ]; then |
| product=${product/aosp_/aosp_${keys}_} |
| fi; |
| |
| if [ -z "$variant" ]; then |
| variant=eng |
| fi |
| if [ -z "$apps" ]; then |
| apps=all |
| fi |
| if [ -z "$density" ]; then |
| density=alldpi |
| fi |
| |
| export TARGET_PRODUCT=$product |
| export TARGET_RELEASE=$release |
| export TARGET_BUILD_VARIANT=$variant |
| export TARGET_BUILD_DENSITY=$density |
| export TARGET_BUILD_TYPE=release |
| export TARGET_BUILD_APPS=$apps |
| |
| build_build_var_cache |
| set_stuff_for_environment |
| printconfig |
| destroy_build_var_cache |
| } |
| |
| # Configures the build to build unbundled Android modules (APEXes). |
| # Run banchan with one or more module names (from apex{} modules). |
| function banchan() |
| { |
| local showHelp="$(echo $* | xargs -n 1 echo | \grep -E '^(help)$' | xargs)" |
| local product="$(echo $* | xargs -n 1 echo | \grep -E '^(.*_)?(arm|x86|arm64|riscv64|x86_64|arm64only|x86_64only)$' | xargs)" |
| # TODO: Expand banchan to take release arguments (and update hmm() usage). |
| local release="trunk_staging" |
| local variant="$(echo $* | xargs -n 1 echo | \grep -E '^(user|userdebug|eng)$' | xargs)" |
| local apps="$(echo $* | xargs -n 1 echo | \grep -E -v '^(user|userdebug|eng|(.*_)?(arm|x86|arm64|riscv64|x86_64))$' | xargs)" |
| |
| if [ "$showHelp" != "" ]; then |
| $(gettop)/build/make/banchanHelp.sh |
| return |
| fi |
| |
| if [ -z "$product" ]; then |
| product=arm64 |
| elif [ $(echo $product | wc -w) -gt 1 ]; then |
| echo "banchan: Error: Multiple build archs or products supplied: $products" |
| return |
| fi |
| if [ $(echo $release | wc -w) -gt 1 ]; then |
| echo "banchan: Error: Multiple build releases supplied: $release" |
| return |
| fi |
| if [ $(echo $variant | wc -w) -gt 1 ]; then |
| echo "banchan: Error: Multiple build variants supplied: $variant" |
| return |
| fi |
| if [ -z "$apps" ]; then |
| echo "banchan: Error: No modules supplied" |
| return |
| fi |
| |
| case $product in |
| arm) product=module_arm;; |
| x86) product=module_x86;; |
| arm64) product=module_arm64;; |
| riscv64) product=module_riscv64;; |
| x86_64) product=module_x86_64;; |
| arm64only) product=module_arm64only;; |
| x86_64only) product=module_x86_64only;; |
| esac |
| if [ -z "$variant" ]; then |
| variant=eng |
| fi |
| |
| export TARGET_PRODUCT=$product |
| export TARGET_RELEASE=$release |
| export TARGET_BUILD_VARIANT=$variant |
| export TARGET_BUILD_DENSITY=alldpi |
| export TARGET_BUILD_TYPE=release |
| |
| # This setup currently uses TARGET_BUILD_APPS just like tapas, but the use |
| # case is different and it may diverge in the future. |
| export TARGET_BUILD_APPS=$apps |
| |
| build_build_var_cache |
| set_stuff_for_environment |
| printconfig |
| destroy_build_var_cache |
| } |
| |
| function croot() |
| { |
| local T=$(gettop) |
| if [ "$T" ]; then |
| if [ "$1" ]; then |
| \cd $(gettop)/$1 |
| else |
| \cd $(gettop) |
| fi |
| else |
| echo "Couldn't locate the top of the tree. Try setting TOP." |
| fi |
| } |
| |
| function _croot() |
| { |
| local T=$(gettop) |
| if [ "$T" ]; then |
| local cur="${COMP_WORDS[COMP_CWORD]}" |
| k=0 |
| for c in $(compgen -d ${T}/${cur}); do |
| COMPREPLY[k++]=${c#${T}/}/ |
| done |
| fi |
| } |
| |
| function cproj() |
| { |
| local TOPFILE=build/make/core/envsetup.mk |
| local HERE=$PWD |
| local T= |
| while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do |
| T=$PWD |
| if [ -f "$T/Android.mk" ]; then |
| \cd $T |
| return |
| fi |
| \cd .. |
| done |
| \cd $HERE |
| echo "can't find Android.mk" |
| } |
| |
| # Ensure that we're always using the adb in the tree. This works around the fact |
| # that bash caches $PATH lookups, so if you use adb before lunching/building the |
| # one in your tree, you'll continue to get /usr/bin/adb or whatever even after |
| # you have the one from your current tree on your path. Historically this would |
| # cause confusion because glinux had adb in /usr/bin/ by default, though that |
| # doesn't appear to be the case on my rodete hosts; it is however still the case |
| # that my Mac has /usr/local/bin/adb installed by default and on the default |
| # path. |
| function adb() { |
| # We need `command which` because zsh has a built-in `which` that's more |
| # like `type`. |
| local ADB=$(command which adb) |
| if [ -z "$ADB" ]; then |
| echo "Command adb not found; try lunch (and building) first?" |
| return 1 |
| fi |
| run_tool_with_logging "ADB" $ADB "${@}" |
| } |
| |
| function run_tool_with_logging() { |
| # Run commands in a subshell for us to handle forced terminations with a trap |
| # handler. |
| ( |
| local tool_tag="$1" |
| shift |
| local tool_binary="$1" |
| shift |
| |
| # If the logger is not configured, run the original command and return. |
| if [[ -z "${ANDROID_TOOL_LOGGER}" ]]; then |
| "${tool_binary}" "${@}" |
| return $? |
| fi |
| |
| # Otherwise, run the original command and call the logger when done. |
| local start_time |
| start_time=$(date +%s.%N) |
| local logger=${ANDROID_TOOL_LOGGER} |
| |
| # Install a trap to call the logger even when the process terminates abnormally. |
| # The logger is run in the background and its output suppressed to avoid |
| # interference with the user flow. |
| trap ' |
| exit_code=$?; |
| # Remove the trap to prevent duplicate log. |
| trap - EXIT; |
| "${logger}" \ |
| --tool_tag="${tool_tag}" \ |
| --start_timestamp="${start_time}" \ |
| --end_timestamp="$(date +%s.%N)" \ |
| --tool_args="$*" \ |
| --exit_code="${exit_code}" \ |
| ${ANDROID_TOOL_LOGGER_EXTRA_ARGS} \ |
| > /dev/null 2>&1 & |
| exit ${exit_code} |
| ' SIGINT SIGTERM SIGQUIT EXIT |
| |
| # Run the original command. |
| "${tool_binary}" "${@}" |
| ) |
| } |
| |
| # communicate with a running device or emulator, set up necessary state, |
| # and run the hat command. |
| function runhat() |
| { |
| # process standard adb options |
| local adbTarget="" |
| if [ "$1" = "-d" -o "$1" = "-e" ]; then |
| adbTarget=$1 |
| shift 1 |
| elif [ "$1" = "-s" ]; then |
| adbTarget="$1 $2" |
| shift 2 |
| fi |
| local adbOptions=${adbTarget} |
| #echo adbOptions = ${adbOptions} |
| |
| # runhat options |
| local targetPid=$1 |
| |
| if [ "$targetPid" = "" ]; then |
| echo "Usage: runhat [ -d | -e | -s serial ] target-pid" |
| return |
| fi |
| |
| # confirm hat is available |
| if [ -z $(which hat) ]; then |
| echo "hat is not available in this configuration." |
| return |
| fi |
| |
| # issue "am" command to cause the hprof dump |
| local devFile=/data/local/tmp/hprof-$targetPid |
| echo "Poking $targetPid and waiting for data..." |
| echo "Storing data at $devFile" |
| adb ${adbOptions} shell am dumpheap $targetPid $devFile |
| echo "Press enter when logcat shows \"hprof: heap dump completed\"" |
| echo -n "> " |
| read |
| |
| local localFile=/tmp/$$-hprof |
| |
| echo "Retrieving file $devFile..." |
| adb ${adbOptions} pull $devFile $localFile |
| |
| adb ${adbOptions} shell rm $devFile |
| |
| echo "Running hat on $localFile" |
| echo "View the output by pointing your browser at http://localhost:7000/" |
| echo "" |
| hat -JXmx512m $localFile |
| } |
| |
| function godir () { |
| if [[ -z "$1" ]]; then |
| echo "Usage: godir <regex>" |
| return |
| fi |
| local T=$(gettop) |
| local FILELIST |
| if [ ! "$OUT_DIR" = "" ]; then |
| mkdir -p $OUT_DIR |
| FILELIST=$OUT_DIR/filelist |
| else |
| FILELIST=$T/filelist |
| fi |
| if [[ ! -f $FILELIST ]]; then |
| echo -n "Creating index..." |
| (\cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > $FILELIST) |
| echo " Done" |
| echo "" |
| fi |
| local lines |
| lines=($(\grep "$1" $FILELIST | sed -e 's/\/[^/]*$//' | sort | uniq)) |
| if [[ ${#lines[@]} = 0 ]]; then |
| echo "Not found" |
| return |
| fi |
| local pathname |
| local choice |
| if [[ ${#lines[@]} > 1 ]]; then |
| while [[ -z "$pathname" ]]; do |
| local index=1 |
| local line |
| for line in ${lines[@]}; do |
| printf "%6s %s\n" "[$index]" $line |
| index=$(($index + 1)) |
| done |
| echo |
| echo -n "Select one: " |
| unset choice |
| read choice |
| if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then |
| echo "Invalid choice" |
| continue |
| fi |
| pathname=${lines[@]:$(($choice-1)):1} |
| done |
| else |
| pathname=${lines[@]:0:1} |
| fi |
| \cd $T/$pathname |
| } |
| |
| # Go to a specific module in the android tree, as cached in module-info.json. If any build change |
| # is made, and it should be reflected in the output, you should run 'refreshmod' first. |
| # Note: This function is in envsetup because changing the directory needs to happen in the current |
| # shell. All other functions that use module-info.json should be in build/soong/bin. |
| function gomod() { |
| if [[ $# -ne 1 ]]; then |
| echo "usage: gomod <module>" >&2 |
| return 1 |
| fi |
| |
| local path="$(pathmod $@)" |
| if [ -z "$path" ]; then |
| return 1 |
| fi |
| cd $path |
| } |
| |
| function _complete_android_module_names() { |
| local word=${COMP_WORDS[COMP_CWORD]} |
| COMPREPLY=( $(allmod | grep -E "^$word") ) |
| } |
| |
| function get_make_command() |
| { |
| # If we're in the top of an Android tree, use soong_ui.bash instead of make |
| if [ -f build/soong/soong_ui.bash ]; then |
| # Always use the real make if -C is passed in |
| for arg in "$@"; do |
| if [[ $arg == -C* ]]; then |
| echo command make |
| return |
| fi |
| done |
| echo build/soong/soong_ui.bash --make-mode |
| else |
| echo command make |
| fi |
| } |
| |
| function make() |
| { |
| _wrap_build $(get_make_command "$@") "$@" |
| } |
| |
| # Zsh needs bashcompinit called to support bash-style completion. |
| function enable_zsh_completion() { |
| # Don't override user's options if bash-style completion is already enabled. |
| if ! declare -f complete >/dev/null; then |
| autoload -U compinit && compinit |
| autoload -U bashcompinit && bashcompinit |
| fi |
| } |
| |
| function validate_current_shell() { |
| local current_sh="$(ps -o command -p $$)" |
| case "$current_sh" in |
| *bash*) |
| function check_type() { type -t "$1"; } |
| ;; |
| *zsh*) |
| function check_type() { type "$1"; } |
| enable_zsh_completion ;; |
| *) |
| echo -e "WARNING: Only bash and zsh are supported.\nUse of other shell would lead to erroneous results." |
| ;; |
| esac |
| } |
| |
| # Execute the contents of any vendorsetup.sh files we can find. |
| # Unless we find an allowed-vendorsetup_sh-files file, in which case we'll only |
| # load those. |
| # |
| # This allows loading only approved vendorsetup.sh files |
| function source_vendorsetup() { |
| unset VENDOR_PYTHONPATH |
| local T="$(gettop)" |
| allowed= |
| for f in $(cd "$T" && find -L device vendor product -maxdepth 4 -name 'allowed-vendorsetup_sh-files' 2>/dev/null | sort); do |
| if [ -n "$allowed" ]; then |
| echo "More than one 'allowed_vendorsetup_sh-files' file found, not including any vendorsetup.sh files:" |
| echo " $allowed" |
| echo " $f" |
| return |
| fi |
| allowed="$T/$f" |
| done |
| |
| allowed_files= |
| [ -n "$allowed" ] && allowed_files=$(cat "$allowed") |
| for dir in device vendor product; do |
| for f in $(cd "$T" && test -d $dir && \ |
| find -L $dir -maxdepth 4 -name 'vendorsetup.sh' 2>/dev/null | sort); do |
| |
| if [[ -z "$allowed" || "$allowed_files" =~ $f ]]; then |
| echo "including $f"; . "$T/$f" |
| else |
| echo "ignoring $f, not in $allowed" |
| fi |
| done |
| done |
| |
| if [[ "${PWD}" == /google/cog/* ]]; then |
| f="build/make/cogsetup.sh" |
| echo "including $f"; . "$T/$f" |
| fi |
| } |
| |
| function showcommands() { |
| local T=$(gettop) |
| if [[ -z "$TARGET_PRODUCT" ]]; then |
| >&2 echo "TARGET_PRODUCT not set. Run lunch." |
| return |
| fi |
| case $(uname -s) in |
| Darwin) |
| PREBUILT_NAME=darwin-x86 |
| ;; |
| Linux) |
| PREBUILT_NAME=linux-x86 |
| ;; |
| *) |
| >&2 echo Unknown host $(uname -s) |
| return |
| ;; |
| esac |
| OUT_DIR="$(_get_abs_build_var_cached OUT_DIR)" |
| if [[ "$1" == "--regenerate" ]]; then |
| shift 1 |
| NINJA_ARGS="-t commands $@" m |
| else |
| (cd $T && prebuilts/build-tools/$PREBUILT_NAME/bin/ninja \ |
| -f $OUT_DIR/combined-${TARGET_PRODUCT}.ninja \ |
| -t commands "$@") |
| fi |
| } |
| |
| # These functions used to be here but are now standalone scripts |
| # in build/soong/bin. Unset these for the time being so the real |
| # script is picked up. |
| # TODO: Remove this some time after a suitable delay (maybe 2025?) |
| unset allmod |
| unset aninja |
| unset cgrep |
| unset core |
| unset coredump_enable |
| unset coredump_setup |
| unset dirmods |
| unset get_build_var |
| unset get_abs_build_var |
| unset getlastscreenshot |
| unset getprebuilt |
| unset getscreenshotpath |
| unset getsdcardpath |
| unset gettargetarch |
| unset ggrep |
| unset gogrep |
| unset hmm |
| unset installmod |
| unset is64bit |
| unset isviewserverstarted |
| unset jgrep |
| unset jsongrep |
| unset key_back |
| unset key_home |
| unset key_menu |
| unset ktgrep |
| unset m |
| unset mangrep |
| unset mgrep |
| unset mm |
| unset mma |
| unset mmm |
| unset mmma |
| unset outmod |
| unset overrideflags |
| unset owngrep |
| unset pathmod |
| unset pez |
| unset pygrep |
| unset qpid |
| unset rcgrep |
| unset refreshmod |
| unset resgrep |
| unset rsgrep |
| unset sepgrep |
| unset sgrep |
| unset startviewserver |
| unset stopviewserver |
| unset systemstack |
| unset syswrite |
| unset tomlgrep |
| unset treegrep |
| |
| |
| validate_current_shell |
| set_global_paths |
| source_vendorsetup |
| addcompletions |
| |
| |