#!/bin/bash # # Copyright (c) 2012 The Chromium Authors. All rights reserved. # Use of this source code is governed by a BSD-style license that can be # found in the LICENSE file. # # A collection of functions useful for maintaining android devices # Run an adb command on all connected device in parallel. # Usage: adb_all command line to eval. Quoting is optional. # # Examples: # adb_all install Chrome.apk # adb_all 'shell cat /path/to/file' # adb_all() { if [[ $# == 0 ]]; then echo "Usage: adb_all . Quoting is optional." echo "Example: adb_all install Chrome.apk" return 1 fi local DEVICES=$(adb_get_devices -b) local NUM_DEVICES=$(echo $DEVICES | wc -w) if (( $NUM_DEVICES > 1 )); then echo "Looping over $NUM_DEVICES devices" fi _adb_multi "$DEVICES" "$*" } # Run a command on each connected device. Quoting the command is suggested but # not required. The script setups up variable DEVICE to correspond to the # current serial number. Intended for complex one_liners that don't work in # adb_all # Usage: adb_device_loop 'command line to eval' adb_device_loop() { if [[ $# == 0 ]]; then echo "Intended for more complex one-liners that cannot be done with" \ "adb_all." echo 'Usage: adb_device_loop "echo $DEVICE: $(adb root &&' \ 'adb shell cat /data/local.prop)"' return 1 fi local DEVICES=$(adb_get_devices) if [[ -z $DEVICES ]]; then return fi # Do not change DEVICE variable name - part of api for DEVICE in $DEVICES; do DEV_TYPE=$(adb -s $DEVICE shell getprop ro.product.device | sed 's/\r//') echo "Running on $DEVICE ($DEV_TYPE)" ANDROID_SERIAL=$DEVICE eval "$*" done } # Erases data from any devices visible on adb. To preserve a device, # disconnect it or: # 1) Reboot it into fastboot with 'adb reboot bootloader' # 2) Run wipe_all_devices to wipe remaining devices # 3) Restore device it with 'fastboot reboot' # # Usage: wipe_all_devices [-f] # wipe_all_devices() { if [[ -z $(which adb) || -z $(which fastboot) ]]; then echo "aborting: adb and fastboot not in path" return 1 elif ! $(groups | grep -q 'plugdev'); then echo "If fastboot fails, run: 'sudo adduser $(whoami) plugdev'" fi local DEVICES=$(adb_get_devices -b) if [[ $1 != '-f' ]]; then echo "This will ERASE ALL DATA from $(echo $DEVICES | wc -w) device." read -p "Hit enter to continue" fi _adb_multi "$DEVICES" "reboot bootloader" # Subshell to isolate job list ( for DEVICE in $DEVICES; do fastboot_erase $DEVICE & done wait ) # Reboot devices together for DEVICE in $DEVICES; do fastboot -s $DEVICE reboot done } # Wipe a device in fastboot. # Usage fastboot_erase [serial] fastboot_erase() { if [[ -n $1 ]]; then echo "Wiping $1" local SERIAL="-s $1" else if [ -z $(fastboot devices) ]; then echo "No devices in fastboot, aborting." echo "Check out wipe_all_devices to see if sufficient" echo "You can put a device in fastboot using adb reboot bootloader" return 1 fi local SERIAL="" fi fastboot $SERIAL erase cache fastboot $SERIAL erase userdata } # Get list of devices connected via adb # Args: -b block until adb detects a device adb_get_devices() { local DEVICES="$(adb devices | grep 'device$')" if [[ -z $DEVICES && $1 == '-b' ]]; then echo '- waiting for device -' >&2 local DEVICES="$(adb wait-for-device devices | grep 'device$')" fi echo "$DEVICES" | awk -vORS=' ' '{print $1}' | sed 's/ $/\n/' } ################################################### ## HELPER FUNCTIONS ################################################### # Run an adb command in parallel over a device list _adb_multi() { local DEVICES=$1 local ADB_ARGS=$2 ( for DEVICE in $DEVICES; do adb -s $DEVICE $ADB_ARGS & done wait ) }