| /* |
| * 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.ComponentName; |
| import android.content.ContentValues; |
| import android.content.Context; |
| import android.content.Intent; |
| import android.graphics.Bitmap; |
| import android.util.Log; |
| |
| import com.android.launcher3.compat.UserHandleCompat; |
| |
| import java.util.ArrayList; |
| import java.util.Arrays; |
| |
| /** |
| * Represents a launchable icon on the workspaces and in folders. |
| */ |
| public class ShortcutInfo extends ItemInfo { |
| |
| public static final int DEFAULT = 0; |
| |
| /** |
| * The shortcut was restored from a backup and it not ready to be used. This is automatically |
| * set during backup/restore |
| */ |
| public static final int FLAG_RESTORED_ICON = 1; |
| |
| /** |
| * The icon was added as an auto-install app, and is not ready to be used. This flag can't |
| * be present along with {@link #FLAG_RESTORED_ICON}, and is set during default layout |
| * parsing. |
| */ |
| public static final int FLAG_AUTOINTALL_ICON = 2; //0B10; |
| |
| /** |
| * The icon is being installed. If {@link FLAG_RESTORED_ICON} or {@link FLAG_AUTOINTALL_ICON} |
| * is set, then the icon is either being installed or is in a broken state. |
| */ |
| public static final int FLAG_INSTALL_SESSION_ACTIVE = 4; // 0B100; |
| |
| /** |
| * Indicates that the widget restore has started. |
| */ |
| public static final int FLAG_RESTORE_STARTED = 8; //0B1000; |
| |
| /** |
| * Indicates if it represents a common type mentioned in {@link CommonAppTypeParser}. |
| * Upto 15 different types supported. |
| */ |
| public static final int FLAG_RESTORED_APP_TYPE = 0B0011110000; |
| |
| /** |
| * The intent used to start the application. |
| */ |
| Intent intent; |
| |
| /** |
| * Indicates whether the icon comes from an application's resource (if false) |
| * or from a custom Bitmap (if true.) |
| */ |
| boolean customIcon; |
| |
| /** |
| * Indicates whether we're using the default fallback icon instead of something from the |
| * app. |
| */ |
| boolean usingFallbackIcon; |
| |
| /** |
| * If isShortcut=true and customIcon=false, this contains a reference to the |
| * shortcut icon as an application's resource. |
| */ |
| Intent.ShortcutIconResource iconResource; |
| |
| /** |
| * The application icon. |
| */ |
| private Bitmap mIcon; |
| |
| /** |
| * Indicates that the icon is disabled due to safe mode restrictions. |
| */ |
| public static final int FLAG_DISABLED_SAFEMODE = 1; |
| |
| /** |
| * Indicates that the icon is disabled as the app is not available. |
| */ |
| public static final int FLAG_DISABLED_NOT_AVAILABLE = 2; |
| |
| /** |
| * Could be disabled, if the the app is installed but unavailable (eg. in safe mode or when |
| * sd-card is not available). |
| */ |
| int isDisabled = DEFAULT; |
| |
| int status; |
| |
| /** |
| * The installation progress [0-100] of the package that this shortcut represents. |
| */ |
| private int mInstallProgress; |
| |
| /** |
| * Refer {@link AppInfo#firstInstallTime}. |
| */ |
| long firstInstallTime; |
| |
| /** |
| * TODO move this to {@link status} |
| */ |
| int flags = 0; |
| |
| /** |
| * If this shortcut is a placeholder, then intent will be a market intent for the package, and |
| * this will hold the original intent from the database. Otherwise, null. |
| * Refer {@link #FLAG_RESTORE_PENDING}, {@link #FLAG_INSTALL_PENDING} |
| */ |
| Intent promisedIntent; |
| |
| ShortcutInfo() { |
| itemType = LauncherSettings.BaseLauncherColumns.ITEM_TYPE_SHORTCUT; |
| } |
| |
| public Intent getIntent() { |
| return intent; |
| } |
| |
| ShortcutInfo(Intent intent, CharSequence title, CharSequence contentDescription, |
| Bitmap icon, UserHandleCompat user) { |
| this(); |
| this.intent = intent; |
| this.title = title; |
| this.contentDescription = contentDescription; |
| mIcon = icon; |
| this.user = user; |
| } |
| |
| public ShortcutInfo(Context context, ShortcutInfo info) { |
| super(info); |
| title = info.title.toString(); |
| intent = new Intent(info.intent); |
| if (info.iconResource != null) { |
| iconResource = new Intent.ShortcutIconResource(); |
| iconResource.packageName = info.iconResource.packageName; |
| iconResource.resourceName = info.iconResource.resourceName; |
| } |
| mIcon = info.mIcon; // TODO: should make a copy here. maybe we don't need this ctor at all |
| customIcon = info.customIcon; |
| flags = info.flags; |
| firstInstallTime = info.firstInstallTime; |
| user = info.user; |
| status = info.status; |
| } |
| |
| /** TODO: Remove this. It's only called by ApplicationInfo.makeShortcut. */ |
| public ShortcutInfo(AppInfo info) { |
| super(info); |
| title = info.title.toString(); |
| intent = new Intent(info.intent); |
| customIcon = false; |
| flags = info.flags; |
| firstInstallTime = info.firstInstallTime; |
| } |
| |
| public void setIcon(Bitmap b) { |
| mIcon = b; |
| } |
| |
| public Bitmap getIcon(IconCache iconCache) { |
| if (mIcon == null) { |
| updateIcon(iconCache); |
| } |
| return mIcon; |
| } |
| |
| public void updateIcon(IconCache iconCache) { |
| mIcon = iconCache.getIcon(promisedIntent != null ? promisedIntent : intent, user); |
| usingFallbackIcon = iconCache.isDefaultIcon(mIcon, user); |
| } |
| |
| @Override |
| void onAddToDatabase(Context context, ContentValues values) { |
| super.onAddToDatabase(context, values); |
| |
| String titleStr = title != null ? title.toString() : null; |
| values.put(LauncherSettings.BaseLauncherColumns.TITLE, titleStr); |
| |
| String uri = promisedIntent != null ? promisedIntent.toUri(0) |
| : (intent != null ? intent.toUri(0) : null); |
| values.put(LauncherSettings.BaseLauncherColumns.INTENT, uri); |
| |
| if (customIcon) { |
| values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE, |
| LauncherSettings.BaseLauncherColumns.ICON_TYPE_BITMAP); |
| writeBitmap(values, mIcon); |
| } else { |
| if (!usingFallbackIcon) { |
| writeBitmap(values, mIcon); |
| } |
| values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE, |
| LauncherSettings.BaseLauncherColumns.ICON_TYPE_RESOURCE); |
| if (iconResource != null) { |
| values.put(LauncherSettings.BaseLauncherColumns.ICON_PACKAGE, |
| iconResource.packageName); |
| values.put(LauncherSettings.BaseLauncherColumns.ICON_RESOURCE, |
| iconResource.resourceName); |
| } |
| } |
| } |
| |
| @Override |
| public String toString() { |
| return "ShortcutInfo(title=" + title + "intent=" + intent + "id=" + this.id |
| + " type=" + this.itemType + " container=" + this.container + " screen=" + screenId |
| + " cellX=" + cellX + " cellY=" + cellY + " spanX=" + spanX + " spanY=" + spanY |
| + " dropPos=" + Arrays.toString(dropPos) + " user=" + user + ")"; |
| } |
| |
| public static void dumpShortcutInfoList(String tag, String label, |
| ArrayList<ShortcutInfo> list) { |
| Log.d(tag, label + " size=" + list.size()); |
| for (ShortcutInfo info: list) { |
| Log.d(tag, " title=\"" + info.title + " icon=" + info.mIcon |
| + " customIcon=" + info.customIcon); |
| } |
| } |
| |
| public ComponentName getTargetComponent() { |
| return promisedIntent != null ? promisedIntent.getComponent() : intent.getComponent(); |
| } |
| |
| public boolean hasStatusFlag(int flag) { |
| return (status & flag) != 0; |
| } |
| |
| |
| public final boolean isPromise() { |
| return hasStatusFlag(FLAG_RESTORED_ICON | FLAG_AUTOINTALL_ICON); |
| } |
| |
| public int getInstallProgress() { |
| return mInstallProgress; |
| } |
| |
| public void setInstallProgress(int progress) { |
| mInstallProgress = progress; |
| status |= FLAG_INSTALL_SESSION_ACTIVE; |
| } |
| } |
| |