1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.launcher2; 18 19 import android.content.ComponentName; 20 import android.content.ContentValues; 21 import android.content.Context; 22 import android.content.Intent; 23 import android.graphics.Bitmap; 24 import android.graphics.drawable.Drawable; 25 import android.util.Log; 26 27 import java.util.ArrayList; 28 29 /** 30 * Represents a launchable icon on the workspaces and in folders. 31 */ 32 class ShortcutInfo extends ItemInfo { 33 34 /** 35 * The application name. 36 */ 37 CharSequence title; 38 39 /** 40 * The intent used to start the application. 41 */ 42 Intent intent; 43 44 /** 45 * Indicates whether the icon comes from an application's resource (if false) 46 * or from a custom Bitmap (if true.) 47 */ 48 boolean customIcon; 49 50 /** 51 * Indicates whether we're using the default fallback icon instead of something from the 52 * app. 53 */ 54 boolean usingFallbackIcon; 55 56 /** 57 * Indicates whether the shortcut is on external storage and may go away at any time. 58 */ 59 boolean onExternalStorage; 60 61 /** 62 * If isShortcut=true and customIcon=false, this contains a reference to the 63 * shortcut icon as an application's resource. 64 */ 65 Intent.ShortcutIconResource iconResource; 66 67 /** 68 * The application icon. 69 */ 70 private Bitmap mIcon; 71 72 ShortcutInfo() { 73 itemType = LauncherSettings.BaseLauncherColumns.ITEM_TYPE_SHORTCUT; 74 } 75 76 public ShortcutInfo(ShortcutInfo info) { 77 super(info); 78 title = info.title.toString(); 79 intent = new Intent(info.intent); 80 if (info.iconResource != null) { 81 iconResource = new Intent.ShortcutIconResource(); 82 iconResource.packageName = info.iconResource.packageName; 83 iconResource.resourceName = info.iconResource.resourceName; 84 } 85 mIcon = info.mIcon; // TODO: should make a copy here. maybe we don't need this ctor at all 86 customIcon = info.customIcon; 87 } 88 89 /** TODO: Remove this. It's only called by ApplicationInfo.makeShortcut. */ 90 public ShortcutInfo(ApplicationInfo info) { 91 super(info); 92 title = info.title.toString(); 93 intent = new Intent(info.intent); 94 customIcon = false; 95 } 96 97 public void setIcon(Bitmap b) { 98 mIcon = b; 99 } 100 101 public Bitmap getIcon(IconCache iconCache) { 102 if (mIcon == null) { 103 mIcon = iconCache.getIcon(this.intent); 104 } 105 return mIcon; 106 } 107 108 /** 109 * Creates the application intent based on a component name and various launch flags. 110 * Sets {@link #itemType} to {@link LauncherSettings.BaseLauncherColumns#ITEM_TYPE_APPLICATION}. 111 * 112 * @param className the class name of the component representing the intent 113 * @param launchFlags the launch flags 114 */ 115 final void setActivity(ComponentName className, int launchFlags) { 116 intent = new Intent(Intent.ACTION_MAIN); 117 intent.addCategory(Intent.CATEGORY_LAUNCHER); 118 intent.setComponent(className); 119 intent.setFlags(launchFlags); 120 itemType = LauncherSettings.BaseLauncherColumns.ITEM_TYPE_APPLICATION; 121 } 122 123 @Override 124 void onAddToDatabase(ContentValues values) { 125 super.onAddToDatabase(values); 126 127 String titleStr = title != null ? title.toString() : null; 128 values.put(LauncherSettings.BaseLauncherColumns.TITLE, titleStr); 129 130 String uri = intent != null ? intent.toUri(0) : null; 131 values.put(LauncherSettings.BaseLauncherColumns.INTENT, uri); 132 133 if (customIcon) { 134 values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE, 135 LauncherSettings.BaseLauncherColumns.ICON_TYPE_BITMAP); 136 writeBitmap(values, mIcon); 137 } else { 138 if (onExternalStorage && !usingFallbackIcon) { 139 writeBitmap(values, mIcon); 140 } 141 values.put(LauncherSettings.BaseLauncherColumns.ICON_TYPE, 142 LauncherSettings.BaseLauncherColumns.ICON_TYPE_RESOURCE); 143 if (iconResource != null) { 144 values.put(LauncherSettings.BaseLauncherColumns.ICON_PACKAGE, 145 iconResource.packageName); 146 values.put(LauncherSettings.BaseLauncherColumns.ICON_RESOURCE, 147 iconResource.resourceName); 148 } 149 } 150 } 151 152 @Override 153 public String toString() { 154 return "ShortcutInfo(title=" + title.toString() + ")"; 155 } 156 157 @Override 158 void unbind() { 159 super.unbind(); 160 } 161 162 163 public static void dumpShortcutInfoList(String tag, String label, 164 ArrayList<ShortcutInfo> list) { 165 Log.d(tag, label + " size=" + list.size()); 166 for (ShortcutInfo info: list) { 167 Log.d(tag, " title=\"" + info.title + " icon=" + info.mIcon 168 + " customIcon=" + info.customIcon); 169 } 170 } 171 } 172 173