build/android/adb_device_functions.sh

#!/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 <adb command>.  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
  )
}