io.appium.settings 3.0.1 → 3.3.0

package/README.md

@@ -1,7 +1,5 @@
 # Settings
 
-[![Greenkeeper badge](https://badges.greenkeeper.io/appium/io.appium.settings.svg)](https://greenkeeper.io/)
-
 Toggle settings in Android device or emulator.
 
 A small and simple Android application that deals with the system settings. Then the application shuts down.
@@ -171,7 +169,7 @@ adb shell ime set io.appium.settings/.UnicodeIME
 This action allows to retrieve the text content of the current clipboard
 as base64-encoded string.
 An empty string is returned if the clipboard cannot be retrieved
-or the clipboard is empty. 
+or the clipboard is empty.
 Remember, that since Android Q the clipboard content can only be retrieved if
 the requester application is set as the default IME in the system:
 
@@ -186,8 +184,8 @@ adb shell ime set com.google.android.inputmethod.latin/com.android.inputmethod.l
 ## Notifications
 
 Since version 2.16.0 Appium Settings supports retrieval of system notifications.
-You need to manually switch the corresponding security switcher next to `Appium Settings` 
-application name in `Settings->Notification Access` (the path to this page under Settings 
+You need to manually switch the corresponding security switcher next to `Appium Settings`
+application name in `Settings->Notification Access` (the path to this page under Settings
 may vary depending on Android version and the device model)
 in order to make this feature available. The next step would be to send the following broadcast command:
 ```bash
@@ -196,7 +194,7 @@ $ adb shell am broadcast -a io.appium.settings.notifications
 The notifications listener service is running in the background and collects
 all the active and newly created notifications into the internal buffer with maximum
 size of `100`. The collected data (e.g. the properties and texts of each notification)
-is returned as JSON-formatted string. An error description string is returned instead if the 
+is returned as JSON-formatted string. An error description string is returned instead if the
 notifications list cannot be retrieved.
 The example of the resulting data:
 ```json
@@ -234,6 +232,54 @@ and https://developer.android.com/reference/android/app/Notification.html
 for more information on available notification properties and their values.
 
 
+## SMS
+
+Since version 3.1 Appium Settings supports retrieval of SMS messages.
+Make sure the corresponding permission has been granted to the app
+in order to make this feature available. The next step would be to send
+the following broadcast command:
+```bash
+$ adb shell am broadcast -a io.appium.settings.sms.read --es max 10
+```
+In this example the SMS reader broadcast receiver would retrieve
+the properties of `10 recent` incoming SMS messages. By default the limit
+is set to `100`. The collected data (e.g. the properties and texts of each SMS)
+is returned as JSON-formatted string. An error description string is returned instead if the
+SMS list cannot be retrieved.
+The example of the resulting data:
+```json
+{
+  "items":[
+    {
+      "id":"2",
+      "address":"+123456789",
+      "person":null,
+      "date":"1581936422203",
+      "read":"0",
+      "status":"-1",
+      "type":"1",
+      "subject":null,
+      "body":"\"text message2\"",
+      "serviceCenter":null
+    },
+    {
+      "id":"1",
+      "address":"+123456789",
+      "person":null,
+      "date":"1581936382740",
+      "read":"0",
+      "status":"-1",
+      "type":"1",
+      "subject":null,
+      "body":"\"text message\"",
+      "serviceCenter":null
+    }
+  ],
+  "total":2
+}
+```
+
+
 ## Notes:
 
 * You have to specify the receiver class if the app has never been executed before:

package/app/build.gradle

@@ -7,8 +7,8 @@ android {
     defaultConfig {
         minSdkVersion 18
         targetSdkVersion 28
-        versionCode 25
-        versionName "3.0.1"
+        versionCode 29
+        versionName "3.3.0"
         applicationId "io.appium.settings"
     }
 

package/app/src/main/AndroidManifest.xml

@@ -24,6 +24,7 @@
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
     <uses-permission android:name="android.permission.BLUETOOTH" />
     <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
+    <uses-permission android:name="android.permission.READ_SMS" />
 
     <uses-feature android:name="android.hardware.wifi" />
 
@@ -128,5 +129,8 @@
         <receiver android:name=".receivers.UnpairBluetoothDevicesReceiver"
             android:exported="true"
             tools:ignore="ExportedReceiver" />
+        <receiver android:name=".receivers.SmsReader"
+                  android:exported="true"
+                  tools:ignore="ExportedReceiver" />
     </application>
 </manifest>

package/app/src/main/java/io/appium/settings/LocationService.java

@@ -50,6 +50,7 @@ public class LocationService extends Service {
     private static final String LONGITUDE_PARAMETER_KEY = "longitude";
     private static final String LATITUDE_PARAMETER_KEY = "latitude";
     private static final String ALTITUDE_PARAMETER_KEY = "altitude";
+    private static final String SPEED_PARAMETER_KEY = "speed";
 
     private static final long UPDATE_INTERVAL_MS = 2000L;
 
@@ -85,7 +86,6 @@ public class LocationService extends Service {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
             finishForegroundSetup();
         }
-        Log.i(TAG, "INTENT " + intent.getExtras());
 
         handleIntent(intent);
 
@@ -104,7 +104,9 @@ public class LocationService extends Service {
         if (intent == null) {
             return;
         }
-        // update the locationFactory also if the service is already running to mock
+        Log.i(TAG, "INTENT " + intent.getExtras());
+
+        // update the locationFactory also if the service is already running to mock.
         updateMockLocationFactory(intent);
         scheduleLocationUpdate();
     }
@@ -196,6 +198,17 @@ public class LocationService extends Service {
             Log.e(TAG, String.format("altitude should be a valid number. '%s' is given instead",
                     intent.getStringExtra(ALTITUDE_PARAMETER_KEY)));
         }
+        try {
+            if (intent.hasExtra(SPEED_PARAMETER_KEY)) {
+                float speed = Float.valueOf(intent.getStringExtra(SPEED_PARAMETER_KEY));
+
+                locationFactory.setLocation(latitude, longitude, altitude, speed);
+                return;
+            }
+        } catch (NumberFormatException e) {
+            Log.e(TAG, String.format("speed should be a valid number larger then 0.0. '%s' is given instead",
+                    intent.getStringExtra(SPEED_PARAMETER_KEY)));
+        }
 
         locationFactory.setLocation(latitude, longitude, altitude);
     }

package/app/src/main/java/io/appium/settings/Settings.java

@@ -35,6 +35,7 @@ import io.appium.settings.receivers.HasAction;
 import io.appium.settings.receivers.LocaleSettingReceiver;
 import io.appium.settings.receivers.LocationInfoReceiver;
 import io.appium.settings.receivers.NotificationsReceiver;
+import io.appium.settings.receivers.SmsReader;
 import io.appium.settings.receivers.UnpairBluetoothDevicesReceiver;
 import io.appium.settings.receivers.WiFiConnectionSettingReceiver;
 
@@ -59,6 +60,7 @@ public class Settings extends Activity {
         receiverClasses.add(BluetoothConnectionSettingReceiver.class);
         receiverClasses.add(UnpairBluetoothDevicesReceiver.class);
         receiverClasses.add(NotificationsReceiver.class);
+        receiverClasses.add(SmsReader.class);
         registerSettingsReceivers(receiverClasses);
 
         // https://developer.android.com/about/versions/oreo/background-location-limits

package/app/src/main/java/io/appium/settings/handlers/LocaleSettingHandler.java

@@ -67,6 +67,7 @@ public class LocaleSettingHandler extends AbstractSettingHandler {
         f.setBoolean(config, true);
 
         config.locale = locale;
+        config.setLayoutDirection(locale);
 
         Method methodUpdateConfiguration = activityManagerNativeClass.getMethod("updateConfiguration", Configuration.class);
         methodUpdateConfiguration.setAccessible(true);

package/app/src/main/java/io/appium/settings/location/LocationFactory.java

@@ -25,6 +25,8 @@ public class LocationFactory {
     private double latitude;
     private double longitude;
     private double altitude;
+    private float speed;
+    private boolean hasSpeed = false;
 
 
     public synchronized Location createLocation(String providerName, float accuracy) {
@@ -34,7 +36,9 @@ public class LocationFactory {
         l.setLatitude(latitude);
         l.setLongitude(longitude);
         l.setAltitude(altitude);
-        l.setSpeed(0);
+        if (hasSpeed) {
+            l.setSpeed(speed);
+        }
         l.setBearing(0);
 
         l.setTime(System.currentTimeMillis());
@@ -44,9 +48,16 @@ public class LocationFactory {
         return l;
     }
 
+    public synchronized void setLocation(double latitude, double longitude, double altitude, float speed) {
+        this.setLocation(latitude, longitude, altitude);
+        this.speed = speed;
+        this.hasSpeed = true;
+    }
+
     public synchronized void setLocation(double latitude, double longitude, double altitude) {
         this.latitude = latitude;
         this.longitude = longitude;
         this.altitude = altitude;
+        this.hasSpeed = false;
     }
 }

package/app/src/main/java/io/appium/settings/receivers/LocationInfoReceiver.java

@@ -45,7 +45,7 @@ public class LocationInfoReceiver extends BroadcastReceiver
         if (location != null) {
             setResultCode(Activity.RESULT_OK);
             // Decimal separator is a dot
-            setResultData(String.format(Locale.US, "%.5f %.5f %.5f",
+            setResultData(String.format(Locale.US, "%.7f %.7f %.7f",
                     location.getLatitude(), location.getLongitude(), location.getAltitude()));
         } else {
             setResultCode(Activity.RESULT_CANCELED);

package/app/src/main/java/io/appium/settings/receivers/SmsReader.java

@@ -0,0 +1,113 @@
+/*
+  Copyright 2012-present Appium Committers
+  <p>
+  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
+  <p>
+  http://www.apache.org/licenses/LICENSE-2.0
+  <p>
+  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.
+ */
+
+package io.appium.settings.receivers;
+
+import android.app.Activity;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.database.Cursor;
+import android.net.Uri;
+import android.util.Log;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import static io.appium.settings.helpers.Utils.formatJsonNull;
+
+public class SmsReader extends BroadcastReceiver implements HasAction {
+    private static final String TAG = SmsReader.class.getSimpleName();
+    private static final Uri INCOMING_SMS = Uri.parse("content://sms/inbox");
+    private static final String ACTION = "io.appium.settings.sms.read";
+    private static final int MAX_ITEMS = 100;
+    private static final String MAX_ITEMS_SETTING_NAME = "max";
+    private static final String[][] SMS_INFO_MAPPING = new String[][]{
+            {"_id", "id"},
+            {"address", "address"},
+            {"person", "person"},
+            {"date", "date"},
+            {"read", "read"},
+            {"status", "status"},
+            {"type", "type"},
+            {"subject", "subject"},
+            {"body", "body"},
+            {"service_center", "serviceCenter"}
+    };
+
+    private JSONObject listSms(Context context, int maxCount) throws JSONException {
+        Cursor cursor = context.getContentResolver().query(INCOMING_SMS,
+                null, null, null, "date desc");
+        //noinspection TryFinallyCanBeTryWithResources
+        try {
+            JSONArray items = new JSONArray();
+            if (cursor != null && cursor.moveToFirst()) {
+                do {
+                    JSONObject item = new JSONObject();
+                    for (String[] entry : SMS_INFO_MAPPING) {
+                        int columnIndex = cursor.getColumnIndex(entry[0]);
+                        if (columnIndex >= 0) {
+                            item.put(entry[1], formatJsonNull(cursor.getString(columnIndex)));
+                        }
+                    }
+                    items.put(item);
+                } while (cursor.moveToNext() && items.length() < maxCount);
+            }
+            JSONObject result = new JSONObject();
+            result.put("items", items);
+            result.put("total", cursor == null ? 0 : cursor.getCount());
+            return result;
+        } finally {
+            if (cursor != null) {
+                cursor.close();
+            }
+        }
+    }
+
+    /**
+     * Responds to broadcast requests like
+     * am broadcast -a io.appium.settings.sms.read --es max 10
+     * with the list of the recent SMS messages formatted as JSON
+     */
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        int maxItems = MAX_ITEMS;
+        if (intent.hasExtra(MAX_ITEMS_SETTING_NAME)) {
+            try {
+                maxItems = Integer.parseInt(intent.getStringExtra(MAX_ITEMS_SETTING_NAME));
+            } catch (NumberFormatException e) {
+                e.printStackTrace();
+            }
+        }
+        Log.d(TAG, String.format("Getting the recent %s SMS messages", maxItems));
+        String output;
+        try {
+            output = listSms(context, maxItems).toString();
+        } catch (Exception e) {
+            e.printStackTrace();
+            output = "Appium Settings helper is unable to list SMS messages. " +
+                    "Check the logcat output for more details.";
+            Log.e(TAG, output);
+        }
+        setResultCode(Activity.RESULT_OK);
+        setResultData(output);
+    }
+
+    @Override
+    public String getAction() {
+        return ACTION;
+    }
+}

package/app/src/main/java/io/appium/settings/receivers/UnpairBluetoothDevicesReceiver.java

@@ -69,9 +69,10 @@ public class UnpairBluetoothDevicesReceiver extends BroadcastReceiver implements
         }
     }
 
-    private void unpairBluetoothDevice(BluetoothDevice device) throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
-        //noinspection JavaReflectionMemberAccess,ConstantConditions,ConfusingArgumentToVarargsMethod
-        device.getClass().getMethod("removeBond", null).invoke(device, null);
+    private void unpairBluetoothDevice(BluetoothDevice device)
+            throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
+        //noinspection JavaReflectionMemberAccess
+        device.getClass().getMethod("removeBond").invoke(device);
     }
 
     @Override

package/build.gradle

@@ -5,7 +5,7 @@ buildscript {
         jcenter()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.5.3'
+        classpath 'com.android.tools.build:gradle:4.0.2'
     }
 }
 

package/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
-#Thu Dec 19 12:41:17 CET 2019
+#Tue May 19 12:07:24 CEST 2020
 distributionBase=GRADLE_USER_HOME
-distributionUrl=https\://services.gradle.org/distributions/gradle-5.4.1-all.zip
 distributionPath=wrapper/dists
-zipStorePath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.4.1-all.zip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "io.appium.settings",
-  "version": "3.0.1",
+  "version": "3.3.0",
   "description": "App for dealing with Android settings",
   "main": "index.js",
   "scripts": {