io.appium.settings 4.2.0 → 4.2.1

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

@@ -1,31 +0,0 @@
-/*
-  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.location;
-
-import android.location.Location;
-
-public interface MockLocationProvider {
-
-    void setLocation(Location location);
-
-    void enable();
-
-    void disable();
-
-    String getProviderName();
-
-}

package/app/src/main/java/io/appium/settings/notifications/StoredNotification.java

@@ -1,103 +0,0 @@
-/*
-  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.notifications;
-
-import android.os.Build;
-import android.os.Bundle;
-import android.service.notification.StatusBarNotification;
-import org.json.JSONException;
-import org.json.JSONObject;
-
-import static io.appium.settings.helpers.Utils.formatJsonNull;
-import static io.appium.settings.helpers.Utils.toNullableString;
-
-public class StoredNotification {
-    private final StatusBarNotification sbn;
-    private boolean isRemoved = false;
-
-    public StoredNotification(StatusBarNotification sbn) {
-        this.sbn = sbn;
-    }
-
-    public StatusBarNotification getNotification() {
-        return sbn;
-    }
-
-    private void storeCharSequenceProperty(JSONObject dst, String name, String propertyName,
-                                           Bundle extras) throws JSONException {
-        CharSequence value = extras.getCharSequence(propertyName);
-        dst.put(name, formatJsonNull(toNullableString(value)));
-    }
-
-    public JSONObject toJson() throws JSONException {
-        JSONObject result = new JSONObject();
-        result.put("packageName", formatJsonNull(sbn.getPackageName()));
-        result.put("isClearable", sbn.isClearable());
-        result.put("isOngoing", sbn.isOngoing());
-        result.put("id", sbn.getId());
-        result.put("tag", formatJsonNull(sbn.getTag()));
-        result.put("postTime", sbn.getPostTime());
-        result.put("isRemoved", isRemoved());
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
-            JSONObject notification = new JSONObject();
-            Bundle extras = sbn.getNotification().extras;
-            storeCharSequenceProperty(notification, "title", "android.title", extras);
-            storeCharSequenceProperty(notification, "bigTitle", "android.title.big", extras);
-            storeCharSequenceProperty(notification, "text", "android.text", extras);
-            storeCharSequenceProperty(notification, "bigText", "android.bigText", extras);
-            storeCharSequenceProperty(notification, "tickerText", "android.tickerText", extras);
-            storeCharSequenceProperty(notification, "subText", "android.subText", extras);
-            storeCharSequenceProperty(notification, "infoText", "android.infoText", extras);
-            storeCharSequenceProperty(notification, "template", "android.template", extras);
-            result.put("notification", notification);
-        } else {
-            result.put("notification", JSONObject.NULL);
-        }
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
-            result.put("isGroup", sbn.isGroup());
-        } else {
-            result.put("isGroup", false);
-        }
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
-            result.put("userHandle", sbn.getUser().hashCode());
-            result.put("groupKey", formatJsonNull(sbn.getGroupKey()));
-        } else {
-            //noinspection deprecation
-            result.put("userHandle", sbn.getUserId());
-            result.put("groupKey", JSONObject.NULL);
-        }
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
-            result.put("overrideGroupKey", formatJsonNull(sbn.getOverrideGroupKey()));
-        } else {
-            result.put("overrideGroupKey", JSONObject.NULL);
-        }
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT_WATCH) {
-            result.put("key", formatJsonNull(sbn.getKey()));
-        } else {
-            result.put("key", JSONObject.NULL);
-        }
-        return result;
-    }
-
-    public boolean isRemoved() {
-        return isRemoved;
-    }
-
-    public void setRemoved(boolean removed) {
-        this.isRemoved = removed;
-    }
-}

package/app/src/main/java/io/appium/settings/notifications/StoredNotifications.java

@@ -1,50 +0,0 @@
-/*
-  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.notifications;
-
-import org.json.JSONArray;
-import org.json.JSONException;
-
-import java.util.Collections;
-import java.util.LinkedList;
-import java.util.List;
-
-public class StoredNotifications {
-    private List<StoredNotification> notifications = Collections.emptyList();
-
-    private StoredNotifications() {}
-
-    private static StoredNotifications instance = null;
-    public static synchronized StoredNotifications getInstance() {
-        if (instance == null) {
-            instance = new StoredNotifications();
-        }
-        return instance;
-    }
-
-    public void bindNotificationsBuffer(List<StoredNotification> notifications) {
-        this.notifications = notifications;
-    }
-
-    public JSONArray getNotifications() throws JSONException {
-        JSONArray result = new JSONArray();
-        for (StoredNotification sn: new LinkedList<>(notifications)) {
-            result.put(sn.toJson());
-        }
-        return result;
-    }
-}

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

@@ -1,62 +0,0 @@
-/*
-  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.util.Log;
-
-import java.util.Arrays;
-import java.util.List;
-
-import io.appium.settings.handlers.AbstractSettingHandler;
-
-public abstract class AbstractSettingReceiver extends BroadcastReceiver {
-    private static final String TAG = AbstractSettingReceiver.class.getSimpleName();
-
-    private static final String COMMAND = "setstatus";
-    private static final String COMMAND_ENABLE = "enable";
-    private static final String COMMAND_DISABLE = "disable";
-
-    // am broadcast -a io.appium.settings.[wifi|data_connection|animation|bluetooth] --es setstatus [enable|disable]
-    @Override
-    public void onReceive(Context context, Intent intent) {
-        String command = intent.getStringExtra(COMMAND);
-        List<String> supportedCommands = Arrays.asList(COMMAND_ENABLE, COMMAND_DISABLE);
-        if (!supportedCommands.contains(command)) {
-            Log.e(TAG, String.format("Cannot identify the command [%s]", command));
-            setResultCode(Activity.RESULT_CANCELED);
-            return;
-        }
-        boolean isSuccessful;
-        AbstractSettingHandler handler = getHandler(context);
-        if (handler == null) {
-            setResultCode(Activity.RESULT_CANCELED);
-            return;
-        }
-        if (command.equals(COMMAND_ENABLE)) {
-            isSuccessful = handler.enable();
-        } else {
-            isSuccessful = handler.disable();
-        }
-        setResultCode(isSuccessful ? Activity.RESULT_OK : Activity.RESULT_CANCELED);
-    }
-
-    protected abstract AbstractSettingHandler getHandler(Context context);
-}

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

@@ -1,40 +0,0 @@
-/*
-  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.content.Context;
-
-import io.appium.settings.handlers.AnimationSettingHandler;
-
-/**
-* am broadcast -a io.appium.settings.animation --es setstatus [enable|disable]
-*/
-public class AnimationSettingReceiver extends AbstractSettingReceiver
-    implements HasAction{
-
-    private static final String ACTION = "io.appium.settings.animation";
-
-    @Override
-    protected AnimationSettingHandler getHandler(Context context) {
-        return new AnimationSettingHandler(context);
-    }
-
-    @Override
-    public String getAction() {
-        return ACTION;
-    }
-}

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

@@ -1,49 +0,0 @@
-/*
-  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.bluetooth.BluetoothAdapter;
-import android.content.Context;
-import android.util.Log;
-
-import io.appium.settings.handlers.BluetoothConnectionSettingHandler;
-
-/**
- * am broadcast -a io.appium.settings.bluetooth --es setstatus [enable|disable]
- */
-public class BluetoothConnectionSettingReceiver extends AbstractSettingReceiver
-        implements HasAction {
-    private static final String TAG = BluetoothConnectionSettingReceiver.class.getSimpleName();
-    private static final String ACTION = "io.appium.settings.bluetooth";
-
-    @Override
-    protected BluetoothConnectionSettingHandler getHandler(Context context) {
-        BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
-        if (bluetoothAdapter == null) {
-            String errorMessage = "No default bluetooth adapter found";
-            Log.e(TAG, errorMessage);
-            setResultData(errorMessage);
-            return null;
-        }
-        return new BluetoothConnectionSettingHandler(context, bluetoothAdapter);
-    }
-
-    @Override
-    public String getAction() {
-        return ACTION;
-    }
-}

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

@@ -1,91 +0,0 @@
-/*
-  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.ClipData;
-import android.content.ClipboardManager;
-import android.content.Context;
-import android.content.Intent;
-import android.util.Base64;
-import android.util.Log;
-
-import java.io.UnsupportedEncodingException;
-
-public class ClipboardReceiver extends BroadcastReceiver implements HasAction {
-    private static final String TAG = ClipboardReceiver.class.getSimpleName();
-
-    private static final String ACTION = "io.appium.settings.clipboard.get";
-
-    private static String charSequenceToString(CharSequence input) {
-        return input == null ? "" : input.toString();
-    }
-
-    private String getClipboardText(Context context) {
-        final ClipboardManager cm = (ClipboardManager) context
-                .getSystemService(Context.CLIPBOARD_SERVICE);
-        if (cm == null) {
-            Log.e(TAG, "Cannot get an instance of ClipboardManager");
-            return null;
-        }
-        if (!cm.hasPrimaryClip()) {
-            return "";
-        }
-        final ClipData cd = cm.getPrimaryClip();
-        if (cd == null || cd.getItemCount() == 0) {
-            return "";
-        }
-        return charSequenceToString(cd.getItemAt(0).coerceToText(context));
-    }
-
-    /**
-     * Responds to broadcast requests like
-     * am broadcast -a io.appium.settings.clipboard.get
-     * with the base64-encoded current clipboard text content
-     * or an empty string if no content has been received
-     */
-    @Override
-    public void onReceive(Context context, Intent intent) {
-        Log.d(TAG, "Getting current clipboard content");
-        final String clipboardContent = getClipboardText(context);
-        if (clipboardContent == null) {
-            setResultCode(Activity.RESULT_CANCELED);
-            setResultData("");
-            return;
-        }
-
-        try {
-            // TODO: Use StandardCharsets.UTF_8 after the minimum supported API version
-            // TODO: is bumped above 18
-            //noinspection CharsetObjectCanBeUsed
-            String clipboardContentBase64 = Base64.encodeToString(
-                    clipboardContent.getBytes("UTF-8"), Base64.DEFAULT);
-            setResultCode(Activity.RESULT_OK);
-            setResultData(clipboardContentBase64);
-        } catch (UnsupportedEncodingException e) {
-            e.printStackTrace();
-            setResultCode(Activity.RESULT_CANCELED);
-            setResultData("");
-        }
-    }
-
-    @Override
-    public String getAction() {
-        return ACTION;
-    }
-}

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

@@ -1,40 +0,0 @@
-/*
-  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.content.Context;
-
-import io.appium.settings.handlers.DataConnectionSettingHandler;
-
-/**
- * am broadcast -a io.appium.settings.data_connection --es setstatus [enable|disable]
- */
-public class DataConnectionSettingReceiver extends AbstractSettingReceiver
-        implements HasAction {
-
-    private static final String ACTION = "io.appium.settings.data_connection";
-
-    @Override
-    protected DataConnectionSettingHandler getHandler(Context context) {
-        return new DataConnectionSettingHandler(context);
-    }
-
-    @Override
-    public String getAction() {
-        return ACTION;
-    }
-}

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

@@ -1,21 +0,0 @@
-/*
-  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;
-
-public interface HasAction {
-    String getAction();
-}

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

@@ -1,127 +0,0 @@
-/*
-  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 static org.apache.commons.lang3.StringUtils.isBlank;
-
-import android.app.Activity;
-import android.content.BroadcastReceiver;
-import android.content.Context;
-import android.content.Intent;
-import android.util.Log;
-
-import org.apache.commons.lang3.LocaleUtils;
-
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Locale;
-
-import io.appium.settings.handlers.LocaleSettingHandler;
-
-public class LocaleSettingReceiver extends BroadcastReceiver implements HasAction {
-    private static final String TAG = LocaleSettingReceiver.class.getSimpleName();
-
-    private static final String LANG = "lang";
-    private static final String COUNTRY = "country";
-    private static final String SCRIPT = "script";
-
-    private static final String ACTION = "io.appium.settings.locale";
-
-    // am broadcast -a io.appium.settings.locale --es lang ja --es country JP
-    @Override
-    public void onReceive(Context context, Intent intent) {
-        String language = intent.getStringExtra(LANG);
-        String country = intent.getStringExtra(COUNTRY);
-        if (language == null || country == null) {
-            Log.w(TAG, "It is required to provide both language and country, for example: " +
-                    "am broadcast -a io.appium.settings.locale --es lang ja --es country JP");
-            Log.i(TAG, "Set en-US by default.");
-            language = "en";
-            country= "US";
-        }
-        // Expect https://developer.android.com/reference/java/util/Locale.html#Locale(java.lang.String,%20java.lang.String) format.
-        Locale locale = new Locale(language, country);
-        String script = intent.getStringExtra(SCRIPT);
-        if (script != null) {
-            if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP) {
-                locale = new Locale.Builder().setLocale(locale).setScript(script).build();
-            } else {
-                Log.w(TAG, String.format("Script value '%s' is ignored as " +
-                        "setting of it is not supported by the current Android version", script));
-            }
-        }
-        if (!LocaleUtils.isAvailableLocale(locale)) {
-            List<Locale> approximateMatchesLc = matchLocales(language, country);
-            if (!approximateMatchesLc.isEmpty() && isBlank(script)) {
-                Log.i(TAG, String.format(
-                        "The locale %s is not known. Selecting the closest known one %s instead",
-                        locale, approximateMatchesLc.get(0))
-                );
-                locale = approximateMatchesLc.get(0);
-            } else {
-                List<Locale> approximateMatchesL = matchLocales(language);
-                if (approximateMatchesL.isEmpty()) {
-                    Log.e(TAG, String.format(
-                            "The locale %s is not known. Only the following locales are available: %s",
-                            locale, LocaleUtils.availableLocaleList())
-                    );
-                } else {
-                    Log.e(TAG, String.format(
-                            "The locale %s is not known. " +
-                                    "The following locales are available for the %s language: %s" +
-                                    "The following locales are available altogether: %s",
-                            locale, language, approximateMatchesL, LocaleUtils.availableLocaleList())
-                    );
-                }
-                setResultCode(Activity.RESULT_CANCELED);
-                setResultData(String.format("The locale %s is not known", locale));
-                return;
-            }
-        }
-
-        new LocaleSettingHandler(context).setLocale(locale);
-        Log.i(TAG, String.format("Set locale: %s", locale));
-        setResultCode(Activity.RESULT_OK);
-        setResultData(locale.toString());
-    }
-
-    @Override
-    public String getAction() {
-        return ACTION;
-    }
-
-    private static List<Locale> matchLocales(String language) {
-        List<Locale> matches = new ArrayList<>();
-        for (Locale locale: LocaleUtils.availableLocaleList()) {
-            if (locale.getLanguage().equalsIgnoreCase(language)) {
-                matches.add(locale);
-            }
-        }
-        return matches;
-    }
-
-    private static List<Locale> matchLocales(String language, String country) {
-        List<Locale> matches = new ArrayList<>();
-        for (Locale locale: LocaleUtils.availableLocaleList()) {
-            if (locale.getLanguage().equalsIgnoreCase(language)
-                    && locale.getCountry().equalsIgnoreCase(country)) {
-                matches.add(locale);
-            }
-        }
-        return matches;
-    }
-}