readme.md

This script allows running an adb command (deeplinks, specifically) dynamically - i.e. ask for which device to send a command to if there are multiple devices found. Companion blog post for usage is 🔗 here.

A more flexibile version of this script (that makes it easily reusable for multiple ADB commands) is here.

2023-09-04:

• Add instructions for explicit intents when sending the command

2023-09-21:

• Filter out unauthorised devices

adb_deeplink.sh

#!/bin/zsh

function get_devices() {
  all_devices=$(command adb devices)
  
  # Drop the title
  all_devices=${all_devices#"List of devices attached"}

  # Drop any unauthorised devices (i.e. USB debugging disabled or authorisations revoked)
  valid_devices=$(echo $all_devices | grep -v "([[:alnum:]-]+[[:space:]]+unauthorized$)" | grep -oE "([[:alnum:]-]+[[:space:]]+device$)")

  # Find how many valid devices we have
  num_matches=$(echo $valid_devices | wc -l)

  # If there are multiple, ask for which device to send the command to
  if [[ $num_matches -gt 1 ]]; then
    deeplink_with_multiple
  # Otherwise just send the ADB command
  else
    # To send an EXPLICIT INTENT, add your package name at the end:
    # command adb -s $serial_number shell am start -W -a android.intent.action.VIEW -d \"$URL\" your.package.name
    command adb shell am start -W -a android.intent.action.VIEW -d \"$URL\"
  fi

}

function deeplink_with_multiple {
  # Display device serial numbers
  find_matches=$(echo $valid_devices | egrep -io "([[:alnum:]-]+[[:space:]]+device$)" | awk '{print NR " - " $1}')
  printf "Multiple devices found:\n%s\n" "$find_matches"

  # Present chooser
  echo -n "Select device: "
  read -r selected_device

  # Send the ADB command with the serial number
  serial_number=$(echo $find_matches | egrep "${selected_device} - (.*)" | awk '{print $3}')

  # To send an EXPLICIT INTENT, add your package name at the end:
  # command adb -s $serial_number shell am start -W -a android.intent.action.VIEW -d \"$URL\" your.package.name
  command adb -s $serial_number shell am start -W -a android.intent.action.VIEW -d \"$URL\"
}

URL=$1
get_devices