src/com/android/launcher3/ShortcutInfo.java - platform/packages/apps/Launcher3 - Git at Google

 /*
  * 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.LauncherSettings.Favorites;
 import com.android.launcher3.compat.LauncherActivityInfoCompat;
 import com.android.launcher3.compat.UserHandleCompat;
 import com.android.launcher3.compat.UserManagerCompat;

 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.)
      * TODO: remove this flag
      */
     public boolean customIcon;

     /**
      * Indicates whether we're using the default fallback icon instead of something from the
      * app.
      */
     boolean usingFallbackIcon;

     /**
      * Indicates whether we're using a low res icon
      */
     boolean usingLowResIcon;

     /**
      * If isShortcut=true and customIcon=false, this contains a reference to the
      * shortcut icon as an application's resource.
      */
     public 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}.
      */
     public 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 = Utilities.trim(title);
         this.contentDescription = contentDescription;
         mIcon = icon;
         this.user = user;
     }

     public ShortcutInfo(Context context, ShortcutInfo info) {
         super(info);
         title = Utilities.trim(info.title);
         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 = Utilities.trim(info.title);
         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) {
         if (itemType == Favorites.ITEM_TYPE_APPLICATION) {
             iconCache.getTitleAndIcon(this, promisedIntent != null ? promisedIntent : intent, user,
                     shouldUseLowResIcon());
         }
     }

     @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);
         values.put(LauncherSettings.Favorites.RESTORED, status);

         if (customIcon) {
             values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE,
                     LauncherSettings.BaseLauncherColumns.ICON_TYPE_BITMAP);
             writeBitmap(values, mIcon);
         } else {
             if (!usingFallbackIcon) {
                 writeBitmap(values, mIcon);
             }
             if (iconResource != null) {
                 values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE,
                         LauncherSettings.BaseLauncherColumns.ICON_TYPE_RESOURCE);
                 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;
     }

     public boolean shouldUseLowResIcon() {
         return usingLowResIcon && container >= 0 && rank >= FolderIcon.NUM_ITEMS_IN_PREVIEW;
     }

     public static ShortcutInfo fromActivityInfo(LauncherActivityInfoCompat info, Context context) {
         final ShortcutInfo shortcut = new ShortcutInfo();
         shortcut.user = info.getUser();
         shortcut.title = Utilities.trim(info.getLabel());
         shortcut.contentDescription = UserManagerCompat.getInstance(context)
                 .getBadgedLabelForUser(info.getLabel(), info.getUser());
         shortcut.customIcon = false;
         shortcut.intent = AppInfo.makeLaunchIntent(context, info, info.getUser());
         shortcut.itemType = LauncherSettings.Favorites.ITEM_TYPE_APPLICATION;
         shortcut.flags = AppInfo.initFlags(info);
         shortcut.firstInstallTime = info.getFirstInstallTime();
         return shortcut;
     }
 }
	/*
	* 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.LauncherSettings.Favorites;
	import com.android.launcher3.compat.LauncherActivityInfoCompat;
	import com.android.launcher3.compat.UserHandleCompat;
	import com.android.launcher3.compat.UserManagerCompat;

	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.)
	* TODO: remove this flag
	*/
	public boolean customIcon;

	/**
	* Indicates whether we're using the default fallback icon instead of something from the
	* app.
	*/
	boolean usingFallbackIcon;

	/**
	* Indicates whether we're using a low res icon
	*/
	boolean usingLowResIcon;

	/**
	* If isShortcut=true and customIcon=false, this contains a reference to the
	* shortcut icon as an application's resource.
	*/
	public 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}.
	*/
	public 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 = Utilities.trim(title);
	this.contentDescription = contentDescription;
	mIcon = icon;
	this.user = user;
	}

	public ShortcutInfo(Context context, ShortcutInfo info) {
	super(info);
	title = Utilities.trim(info.title);
	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 = Utilities.trim(info.title);
	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) {
	if (itemType == Favorites.ITEM_TYPE_APPLICATION) {
	iconCache.getTitleAndIcon(this, promisedIntent != null ? promisedIntent : intent, user,
	shouldUseLowResIcon());
	}
	}

	@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);
	values.put(LauncherSettings.Favorites.RESTORED, status);

	if (customIcon) {
	values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE,
	LauncherSettings.BaseLauncherColumns.ICON_TYPE_BITMAP);
	writeBitmap(values, mIcon);
	} else {
	if (!usingFallbackIcon) {
	writeBitmap(values, mIcon);
	}
	if (iconResource != null) {
	values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE,
	LauncherSettings.BaseLauncherColumns.ICON_TYPE_RESOURCE);
	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;
	}

	public boolean shouldUseLowResIcon() {
	return usingLowResIcon && container >= 0 && rank >= FolderIcon.NUM_ITEMS_IN_PREVIEW;
	}

	public static ShortcutInfo fromActivityInfo(LauncherActivityInfoCompat info, Context context) {
	final ShortcutInfo shortcut = new ShortcutInfo();
	shortcut.user = info.getUser();
	shortcut.title = Utilities.trim(info.getLabel());
	shortcut.contentDescription = UserManagerCompat.getInstance(context)
	.getBadgedLabelForUser(info.getLabel(), info.getUser());
	shortcut.customIcon = false;
	shortcut.intent = AppInfo.makeLaunchIntent(context, info, info.getUser());
	shortcut.itemType = LauncherSettings.Favorites.ITEM_TYPE_APPLICATION;
	shortcut.flags = AppInfo.initFlags(info);
	shortcut.firstInstallTime = info.getFirstInstallTime();
	return shortcut;
	}
	}