/* * Copyright (C) 2008 The Android Open Source Project * * 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 * * 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 com.android.launcher3; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.content.SharedPreferences; import android.content.pm.ActivityInfo; import android.content.pm.PackageManager; import android.graphics.Bitmap; import android.graphics.BitmapFactory; import android.text.TextUtils; import android.util.Base64; import android.util.Log; import com.android.launcher3.compat.LauncherActivityInfoCompat; import com.android.launcher3.compat.LauncherAppsCompat; import com.android.launcher3.compat.UserHandleCompat; import com.android.launcher3.compat.UserManagerCompat; import com.android.launcher3.shortcuts.DeepShortcutManager; import com.android.launcher3.shortcuts.ShortcutInfoCompat; import com.android.launcher3.shortcuts.ShortcutKey; import com.android.launcher3.util.PackageManagerHelper; import com.android.launcher3.util.Preconditions; import com.android.launcher3.util.Provider; import com.android.launcher3.util.Thunk; import org.json.JSONException; import org.json.JSONObject; import org.json.JSONStringer; import java.net.URISyntaxException; import java.util.ArrayList; import java.util.Arrays; import java.util.HashSet; import java.util.Iterator; import java.util.List; import java.util.Set; public class InstallShortcutReceiver extends BroadcastReceiver { private static final String TAG = "InstallShortcutReceiver"; private static final boolean DBG = false; private static final String ACTION_INSTALL_SHORTCUT = "com.android.launcher.action.INSTALL_SHORTCUT"; private static final String LAUNCH_INTENT_KEY = "intent.launch"; private static final String NAME_KEY = "name"; private static final String ICON_KEY = "icon"; private static final String ICON_RESOURCE_NAME_KEY = "iconResource"; private static final String ICON_RESOURCE_PACKAGE_NAME_KEY = "iconResourcePackage"; private static final String APP_SHORTCUT_TYPE_KEY = "isAppShortcut"; private static final String DEEPSHORTCUT_TYPE_KEY = "isDeepShortcut"; private static final String USER_HANDLE_KEY = "userHandle"; // The set of shortcuts that are pending install private static final String APPS_PENDING_INSTALL = "apps_to_install"; public static final int NEW_SHORTCUT_BOUNCE_DURATION = 450; public static final int NEW_SHORTCUT_STAGGER_DELAY = 85; private static final Object sLock = new Object(); private static void addToInstallQueue( SharedPreferences sharedPrefs, PendingInstallShortcutInfo info) { synchronized(sLock) { String encoded = info.encodeToString(); if (encoded != null) { Set strings = sharedPrefs.getStringSet(APPS_PENDING_INSTALL, null); strings = (strings != null) ? new HashSet<>(strings) : new HashSet(1); strings.add(encoded); sharedPrefs.edit().putStringSet(APPS_PENDING_INSTALL, strings).apply(); } } } public static void removeFromInstallQueue(Context context, HashSet packageNames, UserHandleCompat user) { if (packageNames.isEmpty()) { return; } SharedPreferences sp = Utilities.getPrefs(context); synchronized(sLock) { Set strings = sp.getStringSet(APPS_PENDING_INSTALL, null); if (DBG) { Log.d(TAG, "APPS_PENDING_INSTALL: " + strings + ", removing packages: " + packageNames); } if (Utilities.isEmpty(strings)) { return; } Set newStrings = new HashSet<>(strings); Iterator newStringsIter = newStrings.iterator(); while (newStringsIter.hasNext()) { String encoded = newStringsIter.next(); try { Decoder decoder = new Decoder(encoded, context); if (packageNames.contains(getIntentPackage(decoder.launcherIntent)) && user.equals(decoder.user)) { newStringsIter.remove(); } } catch (JSONException | URISyntaxException e) { Log.d(TAG, "Exception reading shortcut to add: " + e); newStringsIter.remove(); } } sp.edit().putStringSet(APPS_PENDING_INSTALL, newStrings).apply(); } } private static ArrayList getAndClearInstallQueue(Context context) { SharedPreferences sharedPrefs = Utilities.getPrefs(context); synchronized(sLock) { ArrayList infos = new ArrayList<>(); Set strings = sharedPrefs.getStringSet(APPS_PENDING_INSTALL, null); if (DBG) Log.d(TAG, "Getting and clearing APPS_PENDING_INSTALL: " + strings); if (strings == null) { return infos; } for (String encoded : strings) { PendingInstallShortcutInfo info = decode(encoded, context); if (info != null) { infos.add(info); } } sharedPrefs.edit().putStringSet(APPS_PENDING_INSTALL, new HashSet()).apply(); return infos; } } // Determines whether to defer installing shortcuts immediately until // processAllPendingInstalls() is called. private static boolean mUseInstallQueue = false; public void onReceive(Context context, Intent data) { if (!ACTION_INSTALL_SHORTCUT.equals(data.getAction())) { return; } PendingInstallShortcutInfo info = createPendingInfo(context, data); if (info != null) { if (!info.isLauncherActivity()) { // Since its a custom shortcut, verify that it is safe to launch. if (!PackageManagerHelper.hasPermissionForActivity( context, info.launchIntent, null)) { // Target cannot be launched, or requires some special permission to launch Log.e(TAG, "Ignoring malicious intent " + info.launchIntent.toUri(0)); return; } } queuePendingShortcutInfo(info, context); } } /** * @return true is the extra is either null or is of type {@param type} */ private static boolean isValidExtraType(Intent intent, String key, Class type) { Object extra = intent.getParcelableExtra(key); return extra == null || type.isInstance(extra); } /** * Verifies the intent and creates a {@link PendingInstallShortcutInfo} */ private static PendingInstallShortcutInfo createPendingInfo(Context context, Intent data) { if (!isValidExtraType(data, Intent.EXTRA_SHORTCUT_INTENT, Intent.class) || !(isValidExtraType(data, Intent.EXTRA_SHORTCUT_ICON_RESOURCE, Intent.ShortcutIconResource.class)) || !(isValidExtraType(data, Intent.EXTRA_SHORTCUT_ICON, Bitmap.class))) { if (DBG) Log.e(TAG, "Invalid install shortcut intent"); return null; } PendingInstallShortcutInfo info = new PendingInstallShortcutInfo( data, UserHandleCompat.myUserHandle(), context); if (info.launchIntent == null || info.label == null) { if (DBG) Log.e(TAG, "Invalid install shortcut intent"); return null; } return convertToLauncherActivityIfPossible(info); } public static ShortcutInfo fromShortcutIntent(Context context, Intent data) { PendingInstallShortcutInfo info = createPendingInfo(context, data); return info == null ? null : info.getShortcutInfo(); } public static void queueShortcut(ShortcutInfoCompat info, Context context) { queuePendingShortcutInfo(new PendingInstallShortcutInfo(info, context), context); } public static HashSet getPendingShortcuts(Context context) { HashSet result = new HashSet<>(); Set strings = Utilities.getPrefs(context).getStringSet(APPS_PENDING_INSTALL, null); if (Utilities.isEmpty(strings)) { return result; } for (String encoded : strings) { try { Decoder decoder = new Decoder(encoded, context); if (decoder.optBoolean(DEEPSHORTCUT_TYPE_KEY)) { result.add(ShortcutKey.fromIntent(decoder.launcherIntent, decoder.user)); } } catch (JSONException | URISyntaxException e) { Log.d(TAG, "Exception reading shortcut to add: " + e); } } return result; } private static void queuePendingShortcutInfo(PendingInstallShortcutInfo info, Context context) { // Queue the item up for adding if launcher has not loaded properly yet LauncherAppState app = LauncherAppState.getInstance(); boolean launcherNotLoaded = app.getModel().getCallback() == null; addToInstallQueue(Utilities.getPrefs(context), info); if (!mUseInstallQueue && !launcherNotLoaded) { flushInstallQueue(context); } } static void enableInstallQueue() { mUseInstallQueue = true; } static void disableAndFlushInstallQueue(Context context) { mUseInstallQueue = false; flushInstallQueue(context); } static void flushInstallQueue(Context context) { ArrayList items = getAndClearInstallQueue(context); if (!items.isEmpty()) { LauncherAppState.getInstance().getModel().addAndBindAddedWorkspaceItems( new LazyShortcutsProvider(context.getApplicationContext(), items)); } } /** * Ensures that we have a valid, non-null name. If the provided name is null, we will return * the application name instead. */ @Thunk static CharSequence ensureValidName(Context context, Intent intent, CharSequence name) { if (name == null) { try { PackageManager pm = context.getPackageManager(); ActivityInfo info = pm.getActivityInfo(intent.getComponent(), 0); name = info.loadLabel(pm); } catch (PackageManager.NameNotFoundException nnfe) { return ""; } } return name; } private static class PendingInstallShortcutInfo { final LauncherActivityInfoCompat activityInfo; final ShortcutInfoCompat shortcutInfo; final Intent data; final Context mContext; final Intent launchIntent; final String label; final UserHandleCompat user; /** * Initializes a PendingInstallShortcutInfo received from a different app. */ public PendingInstallShortcutInfo(Intent data, UserHandleCompat user, Context context) { this.data = data; this.user = user; mContext = context; launchIntent = data.getParcelableExtra(Intent.EXTRA_SHORTCUT_INTENT); label = data.getStringExtra(Intent.EXTRA_SHORTCUT_NAME); activityInfo = null; shortcutInfo = null; } /** * Initializes a PendingInstallShortcutInfo to represent a launcher target. */ public PendingInstallShortcutInfo(LauncherActivityInfoCompat info, Context context) { this.data = null; mContext = context; activityInfo = info; shortcutInfo = null; user = info.getUser(); launchIntent = AppInfo.makeLaunchIntent(context, info, user); label = info.getLabel().toString(); } /** * Initializes a PendingInstallShortcutInfo to represent a launcher target. */ public PendingInstallShortcutInfo(ShortcutInfoCompat info, Context context) { this.data = null; shortcutInfo = info; mContext = context; activityInfo = null; user = info.getUserHandle(); launchIntent = info.makeIntent(context); label = info.getShortLabel().toString(); } public String encodeToString() { try { if (activityInfo != null) { // If it a launcher target, we only need component name, and user to // recreate this. return new JSONStringer() .object() .key(LAUNCH_INTENT_KEY).value(launchIntent.toUri(0)) .key(APP_SHORTCUT_TYPE_KEY).value(true) .key(USER_HANDLE_KEY).value(UserManagerCompat.getInstance(mContext) .getSerialNumberForUser(user)) .endObject().toString(); } else if (shortcutInfo != null) { // If it a launcher target, we only need component name, and user to // recreate this. return new JSONStringer() .object() .key(LAUNCH_INTENT_KEY).value(launchIntent.toUri(0)) .key(DEEPSHORTCUT_TYPE_KEY).value(true) .key(USER_HANDLE_KEY).value(UserManagerCompat.getInstance(mContext) .getSerialNumberForUser(user)) .endObject().toString(); } if (launchIntent.getAction() == null) { launchIntent.setAction(Intent.ACTION_VIEW); } else if (launchIntent.getAction().equals(Intent.ACTION_MAIN) && launchIntent.getCategories() != null && launchIntent.getCategories().contains(Intent.CATEGORY_LAUNCHER)) { launchIntent.addFlags( Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED); } // This name is only used for comparisons and notifications, so fall back to activity // name if not supplied String name = ensureValidName(mContext, launchIntent, label).toString(); Bitmap icon = data.getParcelableExtra(Intent.EXTRA_SHORTCUT_ICON); Intent.ShortcutIconResource iconResource = data.getParcelableExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE); // Only encode the parameters which are supported by the API. JSONStringer json = new JSONStringer() .object() .key(LAUNCH_INTENT_KEY).value(launchIntent.toUri(0)) .key(NAME_KEY).value(name); if (icon != null) { byte[] iconByteArray = Utilities.flattenBitmap(icon); json = json.key(ICON_KEY).value( Base64.encodeToString( iconByteArray, 0, iconByteArray.length, Base64.DEFAULT)); } if (iconResource != null) { json = json.key(ICON_RESOURCE_NAME_KEY).value(iconResource.resourceName); json = json.key(ICON_RESOURCE_PACKAGE_NAME_KEY) .value(iconResource.packageName); } return json.endObject().toString(); } catch (JSONException e) { Log.d(TAG, "Exception when adding shortcut: " + e); return null; } } public ShortcutInfo getShortcutInfo() { if (activityInfo != null) { return new ShortcutInfo(activityInfo, mContext); } else if (shortcutInfo != null) { return new ShortcutInfo(shortcutInfo, mContext); } else { return LauncherAppState.getInstance().getModel().infoFromShortcutIntent(mContext, data); } } public boolean isLauncherActivity() { return activityInfo != null; } } private static String getIntentPackage(Intent intent) { return intent.getComponent() == null ? intent.getPackage() : intent.getComponent().getPackageName(); } private static PendingInstallShortcutInfo decode(String encoded, Context context) { try { Decoder decoder = new Decoder(encoded, context); if (decoder.optBoolean(APP_SHORTCUT_TYPE_KEY)) { LauncherActivityInfoCompat info = LauncherAppsCompat.getInstance(context) .resolveActivity(decoder.launcherIntent, decoder.user); return info == null ? null : new PendingInstallShortcutInfo(info, context); } else if (decoder.optBoolean(DEEPSHORTCUT_TYPE_KEY)) { DeepShortcutManager sm = DeepShortcutManager.getInstance(context); List si = sm.queryForFullDetails( decoder.launcherIntent.getPackage(), Arrays.asList(ShortcutInfoCompat.EXTRA_SHORTCUT_ID), decoder.user); if (si.isEmpty()) { return null; } else { return new PendingInstallShortcutInfo(si.get(0), context); } } Intent data = new Intent(); data.putExtra(Intent.EXTRA_SHORTCUT_INTENT, decoder.launcherIntent); data.putExtra(Intent.EXTRA_SHORTCUT_NAME, decoder.getString(NAME_KEY)); String iconBase64 = decoder.optString(ICON_KEY); String iconResourceName = decoder.optString(ICON_RESOURCE_NAME_KEY); String iconResourcePackageName = decoder.optString(ICON_RESOURCE_PACKAGE_NAME_KEY); if (iconBase64 != null && !iconBase64.isEmpty()) { byte[] iconArray = Base64.decode(iconBase64, Base64.DEFAULT); Bitmap b = BitmapFactory.decodeByteArray(iconArray, 0, iconArray.length); data.putExtra(Intent.EXTRA_SHORTCUT_ICON, b); } else if (iconResourceName != null && !iconResourceName.isEmpty()) { Intent.ShortcutIconResource iconResource = new Intent.ShortcutIconResource(); iconResource.resourceName = iconResourceName; iconResource.packageName = iconResourcePackageName; data.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, iconResource); } return new PendingInstallShortcutInfo(data, decoder.user, context); } catch (JSONException | URISyntaxException e) { Log.d(TAG, "Exception reading shortcut to add: " + e); } return null; } private static class Decoder extends JSONObject { public final Intent launcherIntent; public final UserHandleCompat user; private Decoder(String encoded, Context context) throws JSONException, URISyntaxException { super(encoded); launcherIntent = Intent.parseUri(getString(LAUNCH_INTENT_KEY), 0); user = has(USER_HANDLE_KEY) ? UserManagerCompat.getInstance(context) .getUserForSerialNumber(getLong(USER_HANDLE_KEY)) : UserHandleCompat.myUserHandle(); if (user == null) { throw new JSONException("Invalid user"); } } } /** * Tries to create a new PendingInstallShortcutInfo which represents the same target, * but is an app target and not a shortcut. * @return the newly created info or the original one. */ private static PendingInstallShortcutInfo convertToLauncherActivityIfPossible( PendingInstallShortcutInfo original) { if (original.isLauncherActivity()) { // Already an activity target return original; } if (!Utilities.isLauncherAppTarget(original.launchIntent)) { return original; } LauncherActivityInfoCompat info = LauncherAppsCompat.getInstance(original.mContext) .resolveActivity(original.launchIntent, original.user); if (info == null) { return original; } // Ignore any conflicts in the label name, as that can change based on locale. return new PendingInstallShortcutInfo(info, original.mContext); } private static class LazyShortcutsProvider extends Provider> { private final Context mContext; private final ArrayList mPendingItems; public LazyShortcutsProvider(Context context, ArrayList items) { mContext = context; mPendingItems = items; } /** * This must be called on the background thread as this requires multiple calls to * packageManager and icon cache. */ @Override public ArrayList get() { Preconditions.assertNonUiThread(); ArrayList installQueue = new ArrayList<>(); LauncherAppsCompat launcherApps = LauncherAppsCompat.getInstance(mContext); for (PendingInstallShortcutInfo pendingInfo : mPendingItems) { // If the intent specifies a package, make sure the package exists String packageName = getIntentPackage(pendingInfo.launchIntent); if (!TextUtils.isEmpty(packageName) && !launcherApps.isPackageEnabledForProfile( packageName, pendingInfo.user)) { if (DBG) Log.d(TAG, "Ignoring shortcut for absent package: " + pendingInfo.launchIntent); continue; } // Generate a shortcut info to add into the model installQueue.add(pendingInfo.getShortcutInfo()); } return installQueue; } } }