Rename and adjust descriptions for all scripts in Mobile device management - Android

Author: adrianbartyczak

README.md

@@ -63,7 +63,7 @@ Solutions for managing X11
 
 Solutions for managing mobile devices
 
-* [Watch for and print X and Y tap coordinates on an Android device screen.](scripts/mobile_device_management-android/hardware_management/getmobilescreentappos)
+* [Watch the X and Y screen tap positions of an Android device.](scripts/mobile_device_management-android/hardware_management/watchandroiddevscreentappos)
 * [Mount and unmount an MTP device.](scripts/mobile_device_management-generic/mounting/mntmtp)
 
 ## Text manipulation

scripts/mobile_device_management-android/README.md

@@ -3,15 +3,15 @@
 
 ## Application management
 
-* [sendsms](application_management/sendsms): Send an sms using an Android device.
+* [sendtextmesgviaandroiddev](application_management/sendtextmesgviaandroiddev): Send a text message via an Android device.
 
 ## Data retrieval
 
-* [getmobilecontactinfo](data_retrieval/getmobilecontactinfo): Get contact info from an Android device.
+* [getcontactinfofromandroiddev](data_retrieval/getcontactinfofromandroiddev): Get information of a contact from an Android device.
 
 ## Hardware management
 
-* [getmobilescreentappos](hardware_management/getmobilescreentappos): Watch for and print X and Y tap coordinates on an Android device screen.
-* [turnmobilescreenoff](hardware_management/turnmobilescreenoff): Turn an Android device screen off if on.
-* [turnmobilescreenon](hardware_management/turnmobilescreenon): Turn an Android device screen on if off.
+* [watchandroiddevscreentappos](hardware_management/watchandroiddevscreentappos): Watch the X and Y screen tap positions of an Android device.
+* [turnandroiddevscreenoff](hardware_management/turnandroiddevscreenoff): Turn an Android device screen off.
+* [turnandroiddevscreenon](hardware_management/turnandroiddevscreenon): Turn an Android device screen on.
 

scripts/mobile_device_management-android/application_management/sendsms

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# 
+# File:
+#   sendtextmesgviaandroiddev
+# 
+# Description:
+#   Send a test message via an Android device.
+# 
+# Usage:
+#   sendtextmesgviaandroiddev <phone_number> <message>
+# 
+#       <message>: may contain "\n" for newlines
+# 
+# Notes:
+#   If the message fails to send and simply opens up the thread of the contact
+#   of whom the message is being sent to, click the back button from the thread.
+# 
+
+if [ "$#" -lt 2 ]; then
+  echo 'sendtextmesgviaandroiddev: invalid number of arguments' 1>&2
+  exit 1
+fi
+
+readonly PHONE_NUMBER="${1}"
+shift
+readonly MESSAGE="$(echo "${@}" | sed 's/\\n/${NL}/g')"
+
+# Screen must be on for an sms to be sent using this method.
+isScreenOn="$(adb -d shell 'dumpsys power' | grep mScreenOn)"
+
+# Exit if no device was found.
+if [ $? -eq 1 ]; then
+  exit
+fi
+
+if [[ "${isScreenOn##*=}" = *'false'* ]]; then
+  adb -d shell 'input keyevent KEYCODE_POWER;'
+fi
+
+adb -d shell "NL=$'\n' ; am start -a android.intent.action.SENDTO -d \
+    sms:${PHONE_NUMBER} --es sms_body \"${MESSAGE}\" --ez exit_on_sent true; \
+    input keyevent 66" >/dev/null
+

scripts/mobile_device_management-android/application_management/sendtextmesgviaandroiddev

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# 
+# File:
+#   getcontactinfofromandroiddev
+# 
+# Description:
+#   Get information of a contact from an Android device.
+# 
+# Usage:
+#   getcontactinfofromandroiddev <contact_phone_number_or_name>
+# 
+
+if [ "$#" -eq 0 ]; then
+  echo 'getcontactinfofromandroiddev: contact phone number or name required' \
+      1>&2
+  exit 1
+fi
+
+adb -d shell content query --uri \
+    content://com.android.contacts/data/phones/filter/"${@}" | tr ',' '\n'
+

scripts/mobile_device_management-android/data_retrieval/getcontactinfofromandroiddev

@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
 # 
 # File:
-#   turnmobilescreenoff
+#   turnandroiddevscreenoff
 # 
 # Description:
-#   Turn an Android device screen off if on.
+#   Turn an Android device screen off.
 # 
 
 readonly IS_SCREEN_ON="$(adb -d shell 'dumpsys power' | grep mScreenOn)"

scripts/mobile_device_management-android/data_retrieval/getmobilecontactinfo

@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
 # 
 # File:
-#   turnmobilescreenon
+#   turnandroiddevscreenon
 # 
 # Description:
-#   Turn an Android device screen on if off.
+#   Turn an Android device screen on,
 # 
 
 readonly IS_SCREEN_ON="$(adb -d shell 'dumpsys power' | grep mScreenOn)"

…/hardware_management/turnmobilescreenoff …dware_management/turnandroiddevscreenoffscripts/mobile_device_management-android/hardware_management/turnmobilescreenoff renamed to scripts/mobile_device_management-android/hardware_management/turnandroiddevscreenoff scripts/mobile_device_management-android/hardware_management/turnmobilescreenoff renamed to scripts/mobile_device_management-android/hardware_management/turnandroiddevscreenoff

@@ -1,18 +1,18 @@
 #!/usr/bin/env bash
 # 
 # File:
-#   getmobilescreentappos
+#   watchandroiddevscreentappos
 # 
 # Description:
-#   Watch for and print X and Y tap coordinates on an Android device screen.
+#   Watch the X and Y screen tap positions of an Android device.
 # 
 # Supplemental feature:
-#   Output is converted from hexidecimal to decimal for easy readability.
+#   Output is converted from hexidecimal to decimal.
 # 
 # Usage:
-#   getmobilescreentappos [seconds]
+#   watchandroiddevscreentappos [seconds]
 # 
-#   [seconds]: (optional) number of seconds to watch for tap events
+#       [seconds]: (optional) number of seconds to watch for tap events
 # 
 
 # ======= CONFIGURATIONS ==============