Java tutorial
/* Copyright 2013 Sebastin Katzer Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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 http://www.apache.org/licenses/LICENSE-2.0 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 de.appplant.cordova.plugin.background; import android.annotation.SuppressLint; import android.annotation.TargetApi; import android.app.Activity; import android.app.ActivityManager; import android.app.ActivityManager.AppTask; import android.app.AlertDialog; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.pm.PackageManager; import android.net.Uri; import android.os.Build; import android.os.PowerManager; import android.view.View; import org.apache.cordova.CallbackContext; import org.apache.cordova.CordovaPlugin; import org.apache.cordova.PluginResult; import org.apache.cordova.PluginResult.Status; import org.json.JSONArray; import org.json.JSONObject; import java.util.Arrays; import java.util.List; import static android.R.string.cancel; import static android.R.string.ok; import static android.R.style.Theme_DeviceDefault_Light_Dialog; import static android.content.Context.ACTIVITY_SERVICE; import static android.content.Context.POWER_SERVICE; import static android.content.pm.PackageManager.MATCH_DEFAULT_ONLY; import static android.os.Build.VERSION.SDK_INT; import static android.os.Build.VERSION_CODES.M; import static android.provider.Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS; import static android.view.WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON; import static android.view.WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD; import static android.view.WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED; import static android.view.WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON; /** * Implements extended functions around the main purpose * of infinite execution in the background. */ public class BackgroundModeExt extends CordovaPlugin { // To keep the device awake private PowerManager.WakeLock wakeLock; /** * Executes the request. * * @param action The action to execute. * @param args The exec() arguments. * @param callback The callback context used when * calling back into JavaScript. * * @return Returning false results in a "MethodNotFound" error. */ @Override public boolean execute(String action, JSONArray args, CallbackContext callback) { boolean validAction = true; switch (action) { case "battery": disableBatteryOptimizations(); break; case "webview": disableWebViewOptimizations(); break; case "appstart": openAppStart(args.opt(0)); break; case "background": moveToBackground(); break; case "foreground": moveToForeground(); break; case "tasklist": excludeFromTaskList(); break; case "dimmed": isDimmed(callback); break; case "wakeup": wakeup(); break; case "unlock": wakeup(); unlock(); break; default: validAction = false; } if (validAction) { callback.success(); } else { callback.error("Invalid action: " + action); } return validAction; } /** * Moves the app to the background. */ private void moveToBackground() { Intent intent = new Intent(Intent.ACTION_MAIN); intent.addCategory(Intent.CATEGORY_HOME); getApp().startActivity(intent); } /** * Moves the app to the foreground. */ private void moveToForeground() { Activity app = getApp(); Intent intent = getLaunchIntent(); intent.addFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT | Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP); clearScreenAndKeyguardFlags(); app.startActivity(intent); } /** * Enable GPS position tracking while in background. */ private void disableWebViewOptimizations() { Thread thread = new Thread() { public void run() { try { Thread.sleep(1000); getApp().runOnUiThread(() -> { View view = webView.getEngine().getView(); try { Class.forName("org.crosswalk.engine.XWalkCordovaView").getMethod("onShow").invoke(view); } catch (Exception e) { view.dispatchWindowVisibilityChanged(View.VISIBLE); } }); } catch (InterruptedException e) { // do nothing } } }; thread.start(); } /** * Disables battery optimizations for the app. * Requires permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS to function. */ @SuppressLint("BatteryLife") private void disableBatteryOptimizations() { Activity activity = cordova.getActivity(); Intent intent = new Intent(); String pkgName = activity.getPackageName(); PowerManager pm = (PowerManager) getService(POWER_SERVICE); if (SDK_INT < M) return; if (pm.isIgnoringBatteryOptimizations(pkgName)) return; intent.setAction(ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS); intent.setData(Uri.parse("package:" + pkgName)); cordova.getActivity().startActivity(intent); } /** * Opens the system settings dialog where the user can tweak or turn off any * custom app start settings added by the manufacturer if available. * * @param arg Text and title for the dialog or false to skip the dialog. */ private void openAppStart(Object arg) { Activity activity = cordova.getActivity(); PackageManager pm = activity.getPackageManager(); for (Intent intent : getAppStartIntents()) { if (pm.resolveActivity(intent, MATCH_DEFAULT_ONLY) != null) { JSONObject spec = (arg instanceof JSONObject) ? (JSONObject) arg : null; intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); if (arg instanceof Boolean && !((Boolean) arg)) { activity.startActivity(intent); break; } AlertDialog.Builder dialog = new AlertDialog.Builder(activity, Theme_DeviceDefault_Light_Dialog); dialog.setPositiveButton(ok, (o, d) -> activity.startActivity(intent)); dialog.setNegativeButton(cancel, (o, d) -> { }); dialog.setCancelable(true); if (spec != null && spec.has("title")) { dialog.setTitle(spec.optString("title")); } if (spec != null && spec.has("text")) { dialog.setMessage(spec.optString("text")); } else { dialog.setMessage("missing text"); } activity.runOnUiThread(dialog::show); break; } } } /** * Excludes the app from the recent tasks list. */ @TargetApi(Build.VERSION_CODES.LOLLIPOP) private void excludeFromTaskList() { ActivityManager am = (ActivityManager) getService(ACTIVITY_SERVICE); if (am == null || SDK_INT < 21) return; List<AppTask> tasks = am.getAppTasks(); if (tasks == null || tasks.isEmpty()) return; tasks.get(0).setExcludeFromRecents(true); } /** * Invokes the callback with information if the screen is on. * * @param callback The callback to invoke. */ @SuppressWarnings("deprecation") private void isDimmed(CallbackContext callback) { boolean status = isDimmed(); PluginResult res = new PluginResult(Status.OK, status); callback.sendPluginResult(res); } /** * Returns if the screen is active. */ @SuppressWarnings("deprecation") private boolean isDimmed() { PowerManager pm = (PowerManager) getService(POWER_SERVICE); if (SDK_INT < 20) { return !pm.isScreenOn(); } return !pm.isInteractive(); } /** * Wakes up the device if the screen isn't still on. */ private void wakeup() { try { acquireWakeLock(); } catch (Exception e) { releaseWakeLock(); } } /** * Unlocks the device even with password protection. */ private void unlock() { addSreenAndKeyguardFlags(); getApp().startActivity(getLaunchIntent()); } /** * Acquires a wake lock to wake up the device. */ @SuppressWarnings("deprecation") private void acquireWakeLock() { PowerManager pm = (PowerManager) getService(POWER_SERVICE); releaseWakeLock(); if (!isDimmed()) return; int level = PowerManager.SCREEN_DIM_WAKE_LOCK | PowerManager.ACQUIRE_CAUSES_WAKEUP; wakeLock = pm.newWakeLock(level, "backgroundmode:wakelock"); wakeLock.setReferenceCounted(false); wakeLock.acquire(1000); } /** * Releases the previously acquire wake lock. */ private void releaseWakeLock() { if (wakeLock != null && wakeLock.isHeld()) { wakeLock.release(); wakeLock = null; } } /** * Adds required flags to the window to unlock/wakeup the device. */ private void addSreenAndKeyguardFlags() { getApp().runOnUiThread(() -> getApp().getWindow().addFlags(FLAG_ALLOW_LOCK_WHILE_SCREEN_ON | FLAG_SHOW_WHEN_LOCKED | FLAG_TURN_SCREEN_ON | FLAG_DISMISS_KEYGUARD)); } /** * Clears required flags to the window to unlock/wakeup the device. */ private void clearScreenAndKeyguardFlags() { getApp().runOnUiThread(() -> getApp().getWindow().clearFlags(FLAG_ALLOW_LOCK_WHILE_SCREEN_ON | FLAG_SHOW_WHEN_LOCKED | FLAG_TURN_SCREEN_ON | FLAG_DISMISS_KEYGUARD)); } /** * Removes required flags to the window to unlock/wakeup the device. */ static void clearKeyguardFlags(Activity app) { app.runOnUiThread(() -> app.getWindow().clearFlags(FLAG_DISMISS_KEYGUARD)); } /** * Returns the activity referenced by cordova. */ Activity getApp() { return cordova.getActivity(); } /** * Gets the launch intent for the main activity. */ private Intent getLaunchIntent() { Context app = getApp().getApplicationContext(); String pkgName = app.getPackageName(); return app.getPackageManager().getLaunchIntentForPackage(pkgName); } /** * Get the requested system service by name. * * @param name The name of the service. */ private Object getService(String name) { return getApp().getSystemService(name); } /** * Returns list of all possible intents to present the app start settings. */ private List<Intent> getAppStartIntents() { return Arrays.asList( new Intent().setComponent(new ComponentName("com.miui.securitycenter", "com.miui.permcenter.autostart.AutoStartManagementActivity")), new Intent().setComponent(new ComponentName("com.letv.android.letvsafe", "com.letv.android.letvsafe.AutobootManageActivity")), new Intent().setComponent(new ComponentName("com.huawei.systemmanager", "com.huawei.systemmanager.appcontrol.activity.StartupAppControlActivity")), new Intent().setComponent(new ComponentName("com.huawei.systemmanager", "com.huawei.systemmanager.optimize.process.ProtectActivity")), new Intent().setComponent(new ComponentName("com.coloros.safecenter", "com.coloros.safecenter.permission.startup.StartupAppListActivity")), new Intent().setComponent(new ComponentName("com.coloros.safecenter", "com.coloros.safecenter.startupapp.StartupAppListActivity")), new Intent().setComponent(new ComponentName("com.oppo.safe", "com.oppo.safe.permission.startup.StartupAppListActivity")), new Intent().setComponent(new ComponentName("com.iqoo.secure", "com.iqoo.secure.ui.phoneoptimize.AddWhiteListActivity")), new Intent().setComponent( new ComponentName("com.iqoo.secure", "com.iqoo.secure.ui.phoneoptimize.BgStartUpManager")), new Intent().setComponent(new ComponentName("com.vivo.permissionmanager", "com.vivo.permissionmanager.activity.BgStartUpManagerActivity")), new Intent().setComponent(new ComponentName("com.asus.mobilemanager", "com.asus.mobilemanager.autostart.AutoStartActivity")), new Intent() .setComponent(new ComponentName("com.asus.mobilemanager", "com.asus.mobilemanager.entry.FunctionActivity")) .setData(android.net.Uri.parse("mobilemanager://function/entry/AutoStart")), new Intent().setAction("com.letv.android.permissionautoboot"), new Intent().setComponent(new ComponentName("com.samsung.android.sm_cn", "com.samsung.android.sm.ui.ram.AutoRunActivity")), new Intent().setComponent(ComponentName.unflattenFromString("com.iqoo.secure/.MainActivity")), new Intent().setComponent( ComponentName.unflattenFromString("com.meizu.safe/.permission.SmartBGActivity")), new Intent().setComponent(new ComponentName("com.yulong.android.coolsafe", ".ui.activity.autorun.AutoRunListActivity")), new Intent().setComponent(new ComponentName("cn.nubia.security2", "cn.nubia.security.appmanage.selfstart.ui.SelfStartActivity")), new Intent().setComponent(new ComponentName("com.zui.safecenter", "com.lenovo.safecenter.MainTab.LeSafeMainActivity"))); } }