Kenny Root | 15a4d2f | 2010-03-11 18:20:12 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2007 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 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 17 | package android.content.pm; |
| 18 | |
Jeff Brown | 0733079 | 2010-03-30 19:57:08 -0700 | [diff] [blame] | 19 | import android.content.pm.PackageManager.NameNotFoundException; |
| 20 | import android.content.res.Resources; |
| 21 | import android.graphics.drawable.Drawable; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 22 | import android.os.Parcel; |
| 23 | import android.os.Parcelable; |
| 24 | import android.util.Printer; |
| 25 | |
| 26 | import java.text.Collator; |
| 27 | import java.util.Comparator; |
| 28 | |
| 29 | /** |
| 30 | * Information you can retrieve about a particular application. This |
| 31 | * corresponds to information collected from the AndroidManifest.xml's |
| 32 | * <application> tag. |
| 33 | */ |
| 34 | public class ApplicationInfo extends PackageItemInfo implements Parcelable { |
| 35 | |
| 36 | /** |
| 37 | * Default task affinity of all activities in this application. See |
| 38 | * {@link ActivityInfo#taskAffinity} for more information. This comes |
| 39 | * from the "taskAffinity" attribute. |
| 40 | */ |
| 41 | public String taskAffinity; |
| 42 | |
| 43 | /** |
| 44 | * Optional name of a permission required to be able to access this |
| 45 | * application's components. From the "permission" attribute. |
| 46 | */ |
| 47 | public String permission; |
| 48 | |
| 49 | /** |
| 50 | * The name of the process this application should run in. From the |
| 51 | * "process" attribute or, if not set, the same as |
| 52 | * <var>packageName</var>. |
| 53 | */ |
| 54 | public String processName; |
| 55 | |
| 56 | /** |
| 57 | * Class implementing the Application object. From the "class" |
| 58 | * attribute. |
| 59 | */ |
| 60 | public String className; |
| 61 | |
| 62 | /** |
| 63 | * A style resource identifier (in the package's resources) of the |
| 64 | * description of an application. From the "description" attribute |
| 65 | * or, if not set, 0. |
| 66 | */ |
| 67 | public int descriptionRes; |
| 68 | |
| 69 | /** |
| 70 | * A style resource identifier (in the package's resources) of the |
| 71 | * default visual theme of the application. From the "theme" attribute |
| 72 | * or, if not set, 0. |
| 73 | */ |
| 74 | public int theme; |
| 75 | |
| 76 | /** |
| 77 | * Class implementing the Application's manage space |
| 78 | * functionality. From the "manageSpaceActivity" |
| 79 | * attribute. This is an optional attribute and will be null if |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 80 | * applications don't specify it in their manifest |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 81 | */ |
| 82 | public String manageSpaceActivityName; |
| 83 | |
| 84 | /** |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 85 | * Class implementing the Application's backup functionality. From |
| 86 | * the "backupAgent" attribute. This is an optional attribute and |
| 87 | * will be null if the application does not specify it in its manifest. |
| 88 | * |
| 89 | * <p>If android:allowBackup is set to false, this attribute is ignored. |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 90 | */ |
| 91 | public String backupAgentName; |
Christopher Tate | 4a627c7 | 2011-04-01 14:43:32 -0700 | [diff] [blame] | 92 | |
| 93 | /** |
Adam Powell | 269248d | 2011-08-02 10:26:54 -0700 | [diff] [blame] | 94 | * The default extra UI options for activities in this application. |
| 95 | * Set from the {@link android.R.attr#uiOptions} attribute in the |
| 96 | * activity's manifest. |
| 97 | */ |
| 98 | public int uiOptions = 0; |
| 99 | |
| 100 | /** |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 101 | * Value for {@link #flags}: if set, this application is installed in the |
| 102 | * device's system image. |
| 103 | */ |
| 104 | public static final int FLAG_SYSTEM = 1<<0; |
| 105 | |
| 106 | /** |
| 107 | * Value for {@link #flags}: set to true if this application would like to |
| 108 | * allow debugging of its |
| 109 | * code, even when installed on a non-development system. Comes |
| 110 | * from {@link android.R.styleable#AndroidManifestApplication_debuggable |
| 111 | * android:debuggable} of the <application> tag. |
| 112 | */ |
| 113 | public static final int FLAG_DEBUGGABLE = 1<<1; |
| 114 | |
| 115 | /** |
| 116 | * Value for {@link #flags}: set to true if this application has code |
| 117 | * associated with it. Comes |
| 118 | * from {@link android.R.styleable#AndroidManifestApplication_hasCode |
| 119 | * android:hasCode} of the <application> tag. |
| 120 | */ |
| 121 | public static final int FLAG_HAS_CODE = 1<<2; |
| 122 | |
| 123 | /** |
| 124 | * Value for {@link #flags}: set to true if this application is persistent. |
| 125 | * Comes from {@link android.R.styleable#AndroidManifestApplication_persistent |
| 126 | * android:persistent} of the <application> tag. |
| 127 | */ |
| 128 | public static final int FLAG_PERSISTENT = 1<<3; |
| 129 | |
| 130 | /** |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 131 | * Value for {@link #flags}: set to true if this application holds the |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 132 | * {@link android.Manifest.permission#FACTORY_TEST} permission and the |
| 133 | * device is running in factory test mode. |
| 134 | */ |
| 135 | public static final int FLAG_FACTORY_TEST = 1<<4; |
| 136 | |
| 137 | /** |
| 138 | * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. |
| 139 | * Comes from {@link android.R.styleable#AndroidManifestApplication_allowTaskReparenting |
| 140 | * android:allowTaskReparenting} of the <application> tag. |
| 141 | */ |
| 142 | public static final int FLAG_ALLOW_TASK_REPARENTING = 1<<5; |
| 143 | |
| 144 | /** |
| 145 | * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. |
| 146 | * Comes from {@link android.R.styleable#AndroidManifestApplication_allowClearUserData |
| 147 | * android:allowClearUserData} of the <application> tag. |
| 148 | */ |
| 149 | public static final int FLAG_ALLOW_CLEAR_USER_DATA = 1<<6; |
| 150 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 151 | /** |
Dianne Hackborn | 851a541 | 2009-05-08 12:06:44 -0700 | [diff] [blame] | 152 | * Value for {@link #flags}: this is set if this application has been |
| 153 | * install as an update to a built-in system application. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 154 | */ |
| 155 | public static final int FLAG_UPDATED_SYSTEM_APP = 1<<7; |
Dianne Hackborn | 851a541 | 2009-05-08 12:06:44 -0700 | [diff] [blame] | 156 | |
| 157 | /** |
Dianne Hackborn | 7f20543 | 2009-07-28 00:13:47 -0700 | [diff] [blame] | 158 | * Value for {@link #flags}: this is set of the application has specified |
| 159 | * {@link android.R.styleable#AndroidManifestApplication_testOnly |
| 160 | * android:testOnly} to be true. |
Dianne Hackborn | 851a541 | 2009-05-08 12:06:44 -0700 | [diff] [blame] | 161 | */ |
Dianne Hackborn | a96cbb4 | 2009-05-13 15:06:13 -0700 | [diff] [blame] | 162 | public static final int FLAG_TEST_ONLY = 1<<8; |
Dianne Hackborn | ade3eca | 2009-05-11 18:54:45 -0700 | [diff] [blame] | 163 | |
| 164 | /** |
Dianne Hackborn | 5c1e00b | 2009-06-18 17:10:57 -0700 | [diff] [blame] | 165 | * Value for {@link #flags}: true when the application's window can be |
Dianne Hackborn | 723738c | 2009-06-25 19:48:04 -0700 | [diff] [blame] | 166 | * reduced in size for smaller screens. Corresponds to |
| 167 | * {@link android.R.styleable#AndroidManifestSupportsScreens_smallScreens |
| 168 | * android:smallScreens}. |
Dianne Hackborn | 5c1e00b | 2009-06-18 17:10:57 -0700 | [diff] [blame] | 169 | */ |
Dianne Hackborn | 723738c | 2009-06-25 19:48:04 -0700 | [diff] [blame] | 170 | public static final int FLAG_SUPPORTS_SMALL_SCREENS = 1<<9; |
| 171 | |
| 172 | /** |
| 173 | * Value for {@link #flags}: true when the application's window can be |
| 174 | * displayed on normal screens. Corresponds to |
| 175 | * {@link android.R.styleable#AndroidManifestSupportsScreens_normalScreens |
| 176 | * android:normalScreens}. |
| 177 | */ |
| 178 | public static final int FLAG_SUPPORTS_NORMAL_SCREENS = 1<<10; |
| 179 | |
| 180 | /** |
| 181 | * Value for {@link #flags}: true when the application's window can be |
| 182 | * increased in size for larger screens. Corresponds to |
| 183 | * {@link android.R.styleable#AndroidManifestSupportsScreens_largeScreens |
Dianne Hackborn | 22ec9ab | 2010-04-29 17:56:03 -0700 | [diff] [blame] | 184 | * android:largeScreens}. |
Dianne Hackborn | 723738c | 2009-06-25 19:48:04 -0700 | [diff] [blame] | 185 | */ |
| 186 | public static final int FLAG_SUPPORTS_LARGE_SCREENS = 1<<11; |
Dianne Hackborn | 5c1e00b | 2009-06-18 17:10:57 -0700 | [diff] [blame] | 187 | |
| 188 | /** |
Dianne Hackborn | c4db95c | 2009-07-21 17:46:02 -0700 | [diff] [blame] | 189 | * Value for {@link #flags}: true when the application knows how to adjust |
| 190 | * its UI for different screen sizes. Corresponds to |
| 191 | * {@link android.R.styleable#AndroidManifestSupportsScreens_resizeable |
| 192 | * android:resizeable}. |
| 193 | */ |
| 194 | public static final int FLAG_RESIZEABLE_FOR_SCREENS = 1<<12; |
| 195 | |
| 196 | /** |
Dianne Hackborn | 11b822d | 2009-07-21 20:03:02 -0700 | [diff] [blame] | 197 | * Value for {@link #flags}: true when the application knows how to |
| 198 | * accomodate different screen densities. Corresponds to |
| 199 | * {@link android.R.styleable#AndroidManifestSupportsScreens_anyDensity |
| 200 | * android:anyDensity}. |
| 201 | */ |
| 202 | public static final int FLAG_SUPPORTS_SCREEN_DENSITIES = 1<<13; |
| 203 | |
| 204 | /** |
Ben Cheng | 23085b7 | 2010-02-08 16:06:32 -0800 | [diff] [blame] | 205 | * Value for {@link #flags}: set to true if this application would like to |
| 206 | * request the VM to operate under the safe mode. Comes from |
Ben Cheng | ef3f5dd | 2010-03-29 15:47:26 -0700 | [diff] [blame] | 207 | * {@link android.R.styleable#AndroidManifestApplication_vmSafeMode |
| 208 | * android:vmSafeMode} of the <application> tag. |
Ben Cheng | 23085b7 | 2010-02-08 16:06:32 -0800 | [diff] [blame] | 209 | */ |
| 210 | public static final int FLAG_VM_SAFE_MODE = 1<<14; |
| 211 | |
| 212 | /** |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 213 | * Value for {@link #flags}: set to <code>false</code> if the application does not wish |
| 214 | * to permit any OS-driven backups of its data; <code>true</code> otherwise. |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 215 | * |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 216 | * <p>Comes from the |
| 217 | * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} |
| 218 | * attribute of the <application> tag. |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 219 | */ |
Ben Cheng | 23085b7 | 2010-02-08 16:06:32 -0800 | [diff] [blame] | 220 | public static final int FLAG_ALLOW_BACKUP = 1<<15; |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 221 | |
| 222 | /** |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 223 | * Value for {@link #flags}: set to <code>false</code> if the application must be kept |
| 224 | * in memory following a full-system restore operation; <code>true</code> otherwise. |
| 225 | * Ordinarily, during a full system restore operation each application is shut down |
| 226 | * following execution of its agent's onRestore() method. Setting this attribute to |
| 227 | * <code>false</code> prevents this. Most applications will not need to set this attribute. |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 228 | * |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 229 | * <p>If |
| 230 | * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} |
| 231 | * is set to <code>false</code> or no |
| 232 | * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent} |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 233 | * is specified, this flag will be ignored. |
| 234 | * |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 235 | * <p>Comes from the |
| 236 | * {@link android.R.styleable#AndroidManifestApplication_killAfterRestore android:killAfterRestore} |
| 237 | * attribute of the <application> tag. |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 238 | */ |
Ben Cheng | 23085b7 | 2010-02-08 16:06:32 -0800 | [diff] [blame] | 239 | public static final int FLAG_KILL_AFTER_RESTORE = 1<<16; |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 240 | |
| 241 | /** |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 242 | * Value for {@link #flags}: Set to <code>true</code> if the application's backup |
| 243 | * agent claims to be able to handle restore data even "from the future," |
| 244 | * i.e. from versions of the application with a versionCode greater than |
| 245 | * the one currently installed on the device. <i>Use with caution!</i> By default |
| 246 | * this attribute is <code>false</code> and the Backup Manager will ensure that data |
| 247 | * from "future" versions of the application are never supplied during a restore operation. |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 248 | * |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 249 | * <p>If |
| 250 | * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} |
| 251 | * is set to <code>false</code> or no |
| 252 | * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent} |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 253 | * is specified, this flag will be ignored. |
| 254 | * |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 255 | * <p>Comes from the |
| 256 | * {@link android.R.styleable#AndroidManifestApplication_restoreAnyVersion android:restoreAnyVersion} |
| 257 | * attribute of the <application> tag. |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 258 | */ |
Christopher Tate | 3de55bc | 2010-03-12 17:28:08 -0800 | [diff] [blame] | 259 | public static final int FLAG_RESTORE_ANY_VERSION = 1<<17; |
Christopher Tate | 5e1ab33 | 2009-09-01 20:32:49 -0700 | [diff] [blame] | 260 | |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 261 | /** |
Dianne Hackborn | 3202d38 | 2010-04-26 17:51:34 -0700 | [diff] [blame] | 262 | * Value for {@link #flags}: Set to true if the application is |
| 263 | * currently installed on external/removable/unprotected storage. Such |
| 264 | * applications may not be available if their storage is not currently |
| 265 | * mounted. When the storage it is on is not available, it will look like |
| 266 | * the application has been uninstalled (its .apk is no longer available) |
| 267 | * but its persistent data is not removed. |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 268 | */ |
Dianne Hackborn | 94c567e | 2010-04-26 18:13:10 -0700 | [diff] [blame] | 269 | public static final int FLAG_EXTERNAL_STORAGE = 1<<18; |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 270 | |
| 271 | /** |
Dianne Hackborn | 14cee9f | 2010-04-23 17:51:26 -0700 | [diff] [blame] | 272 | * Value for {@link #flags}: true when the application's window can be |
| 273 | * increased in size for extra large screens. Corresponds to |
| 274 | * {@link android.R.styleable#AndroidManifestSupportsScreens_xlargeScreens |
Dianne Hackborn | 22ec9ab | 2010-04-29 17:56:03 -0700 | [diff] [blame] | 275 | * android:xlargeScreens}. |
Dianne Hackborn | 14cee9f | 2010-04-23 17:51:26 -0700 | [diff] [blame] | 276 | */ |
| 277 | public static final int FLAG_SUPPORTS_XLARGE_SCREENS = 1<<19; |
| 278 | |
| 279 | /** |
Dianne Hackborn | 3b81bc1 | 2011-01-15 11:50:52 -0800 | [diff] [blame] | 280 | * Value for {@link #flags}: true when the application has requested a |
| 281 | * large heap for its processes. Corresponds to |
| 282 | * {@link android.R.styleable#AndroidManifestApplication_largeHeap |
| 283 | * android:largeHeap}. |
Jason parks | a3cdaa5 | 2011-01-13 14:15:43 -0600 | [diff] [blame] | 284 | */ |
Dianne Hackborn | 3b81bc1 | 2011-01-15 11:50:52 -0800 | [diff] [blame] | 285 | public static final int FLAG_LARGE_HEAP = 1<<20; |
Jason parks | a3cdaa5 | 2011-01-13 14:15:43 -0600 | [diff] [blame] | 286 | |
| 287 | /** |
Dianne Hackborn | e7f9721 | 2011-02-24 14:40:20 -0800 | [diff] [blame] | 288 | * Value for {@link #flags}: true if this application's package is in |
| 289 | * the stopped state. |
| 290 | */ |
| 291 | public static final int FLAG_STOPPED = 1<<21; |
| 292 | |
| 293 | /** |
Fabrice Di Meglio | 59dfce8 | 2012-04-02 16:17:20 -0700 | [diff] [blame] | 294 | * Value for {@link #flags}: true when the application is willing to support |
| 295 | * RTL (right to left). All activities will inherit this value. |
| 296 | * |
| 297 | * Set from the {@link android.R.attr#supportsRtl} attribute in the |
| 298 | * activity's manifest. |
| 299 | * |
| 300 | * Default value is false (no support for RTL). |
| 301 | */ |
| 302 | public static final int FLAG_SUPPORTS_RTL = 1<<22; |
| 303 | |
| 304 | /** |
Dianne Hackborn | 7767eac | 2012-08-23 18:25:40 -0700 | [diff] [blame] | 305 | * Value for {@link #flags}: true if the application is currently |
| 306 | * installed for the calling user. |
| 307 | */ |
| 308 | public static final int FLAG_INSTALLED = 1<<23; |
| 309 | |
| 310 | /** |
Dianne Hackborn | 5e03e2c | 2012-09-06 14:21:19 -0700 | [diff] [blame] | 311 | * Value for {@link #flags}: true if the application only has its |
| 312 | * data installed; the application package itself does not currently |
| 313 | * exist on the device. |
| 314 | */ |
| 315 | public static final int FLAG_IS_DATA_ONLY = 1<<24; |
| 316 | |
| 317 | /** |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 318 | * Value for {@link #flags}: Set to true if the application has been |
| 319 | * installed using the forward lock option. |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 320 | * |
Dianne Hackborn | 75e616e | 2011-01-16 13:31:24 -0800 | [diff] [blame] | 321 | * NOTE: DO NOT CHANGE THIS VALUE! It is saved in packages.xml. |
| 322 | * |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 323 | * {@hide} |
| 324 | */ |
Dianne Hackborn | 75e616e | 2011-01-16 13:31:24 -0800 | [diff] [blame] | 325 | public static final int FLAG_FORWARD_LOCK = 1<<29; |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 326 | |
| 327 | /** |
Dianne Hackborn | 02486b1 | 2010-08-26 14:18:37 -0700 | [diff] [blame] | 328 | * Value for {@link #flags}: set to <code>true</code> if the application |
| 329 | * has reported that it is heavy-weight, and thus can not participate in |
| 330 | * the normal application lifecycle. |
| 331 | * |
| 332 | * <p>Comes from the |
Dianne Hackborn | 54e570f | 2010-10-04 18:32:32 -0700 | [diff] [blame] | 333 | * {@link android.R.styleable#AndroidManifestApplication_cantSaveState android:cantSaveState} |
Dianne Hackborn | 02486b1 | 2010-08-26 14:18:37 -0700 | [diff] [blame] | 334 | * attribute of the <application> tag. |
| 335 | * |
| 336 | * {@hide} |
| 337 | */ |
Dianne Hackborn | 75e616e | 2011-01-16 13:31:24 -0800 | [diff] [blame] | 338 | public static final int FLAG_CANT_SAVE_STATE = 1<<28; |
Dianne Hackborn | 02486b1 | 2010-08-26 14:18:37 -0700 | [diff] [blame] | 339 | |
| 340 | /** |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 341 | * Flags associated with the application. Any combination of |
| 342 | * {@link #FLAG_SYSTEM}, {@link #FLAG_DEBUGGABLE}, {@link #FLAG_HAS_CODE}, |
| 343 | * {@link #FLAG_PERSISTENT}, {@link #FLAG_FACTORY_TEST}, and |
| 344 | * {@link #FLAG_ALLOW_TASK_REPARENTING} |
Dianne Hackborn | 851a541 | 2009-05-08 12:06:44 -0700 | [diff] [blame] | 345 | * {@link #FLAG_ALLOW_CLEAR_USER_DATA}, {@link #FLAG_UPDATED_SYSTEM_APP}, |
Dianne Hackborn | 723738c | 2009-06-25 19:48:04 -0700 | [diff] [blame] | 346 | * {@link #FLAG_TEST_ONLY}, {@link #FLAG_SUPPORTS_SMALL_SCREENS}, |
| 347 | * {@link #FLAG_SUPPORTS_NORMAL_SCREENS}, |
Dianne Hackborn | 14cee9f | 2010-04-23 17:51:26 -0700 | [diff] [blame] | 348 | * {@link #FLAG_SUPPORTS_LARGE_SCREENS}, {@link #FLAG_SUPPORTS_XLARGE_SCREENS}, |
| 349 | * {@link #FLAG_RESIZEABLE_FOR_SCREENS}, |
Dianne Hackborn | 7767eac | 2012-08-23 18:25:40 -0700 | [diff] [blame] | 350 | * {@link #FLAG_SUPPORTS_SCREEN_DENSITIES}, {@link #FLAG_VM_SAFE_MODE}, |
| 351 | * {@link #FLAG_INSTALLED}. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 352 | */ |
| 353 | public int flags = 0; |
| 354 | |
| 355 | /** |
Dianne Hackborn | df6e980 | 2011-05-26 14:20:23 -0700 | [diff] [blame] | 356 | * The required smallest screen width the application can run on. If 0, |
| 357 | * nothing has been specified. Comes from |
| 358 | * {@link android.R.styleable#AndroidManifestSupportsScreens_requiresSmallestWidthDp |
| 359 | * android:requiresSmallestWidthDp} attribute of the <supports-screens> tag. |
| 360 | */ |
| 361 | public int requiresSmallestWidthDp = 0; |
| 362 | |
| 363 | /** |
| 364 | * The maximum smallest screen width the application is designed for. If 0, |
| 365 | * nothing has been specified. Comes from |
| 366 | * {@link android.R.styleable#AndroidManifestSupportsScreens_compatibleWidthLimitDp |
| 367 | * android:compatibleWidthLimitDp} attribute of the <supports-screens> tag. |
| 368 | */ |
| 369 | public int compatibleWidthLimitDp = 0; |
| 370 | |
| 371 | /** |
Dianne Hackborn | 2762ff3 | 2011-06-01 21:27:05 -0700 | [diff] [blame] | 372 | * The maximum smallest screen width the application will work on. If 0, |
| 373 | * nothing has been specified. Comes from |
| 374 | * {@link android.R.styleable#AndroidManifestSupportsScreens_largestWidthLimitDp |
| 375 | * android:largestWidthLimitDp} attribute of the <supports-screens> tag. |
| 376 | */ |
| 377 | public int largestWidthLimitDp = 0; |
| 378 | |
| 379 | /** |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 380 | * Full path to the location of this package. |
| 381 | */ |
| 382 | public String sourceDir; |
| 383 | |
| 384 | /** |
Kenny Root | d1ab016 | 2010-01-21 17:27:14 -0800 | [diff] [blame] | 385 | * Full path to the location of the publicly available parts of this |
| 386 | * package (i.e. the primary resource package and manifest). For |
| 387 | * non-forward-locked apps this will be the same as {@link #sourceDir). |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 388 | */ |
| 389 | public String publicSourceDir; |
| 390 | |
| 391 | /** |
Kenny Root | d1ab016 | 2010-01-21 17:27:14 -0800 | [diff] [blame] | 392 | * Full paths to the locations of extra resource packages this application |
| 393 | * uses. This field is only used if there are extra resource packages, |
| 394 | * otherwise it is null. |
Kenny Root | ace5a3f | 2010-02-05 12:59:28 -0800 | [diff] [blame] | 395 | * |
| 396 | * {@hide} |
Kenny Root | d1ab016 | 2010-01-21 17:27:14 -0800 | [diff] [blame] | 397 | */ |
| 398 | public String[] resourceDirs; |
| 399 | |
| 400 | /** |
Robert Craig | 0f40dc9 | 2013-03-25 06:33:03 -0400 | [diff] [blame^] | 401 | * String retrieved from the seinfo tag found in selinux policy. This value |
| 402 | * is useful in setting an SELinux security context on the process as well |
| 403 | * as its data directory. |
| 404 | * |
| 405 | * {@hide} |
| 406 | */ |
| 407 | public String seinfo; |
| 408 | |
| 409 | /** |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 410 | * Paths to all shared libraries this application is linked against. This |
| 411 | * field is only set if the {@link PackageManager#GET_SHARED_LIBRARY_FILES |
| 412 | * PackageManager.GET_SHARED_LIBRARY_FILES} flag was used when retrieving |
| 413 | * the structure. |
| 414 | */ |
| 415 | public String[] sharedLibraryFiles; |
| 416 | |
| 417 | /** |
| 418 | * Full path to a directory assigned to the package for its persistent |
| 419 | * data. |
| 420 | */ |
| 421 | public String dataDir; |
Kenny Root | 85387d7 | 2010-08-26 10:13:11 -0700 | [diff] [blame] | 422 | |
| 423 | /** |
| 424 | * Full path to the directory where native JNI libraries are stored. |
Kenny Root | 85387d7 | 2010-08-26 10:13:11 -0700 | [diff] [blame] | 425 | */ |
| 426 | public String nativeLibraryDir; |
| 427 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 428 | /** |
| 429 | * The kernel user-ID that has been assigned to this application; |
| 430 | * currently this is not a unique ID (multiple applications can have |
| 431 | * the same uid). |
| 432 | */ |
| 433 | public int uid; |
| 434 | |
Mitsuru Oshima | 8d11267 | 2009-04-27 12:01:23 -0700 | [diff] [blame] | 435 | /** |
Dianne Hackborn | 3b3e145 | 2009-09-24 19:22:12 -0700 | [diff] [blame] | 436 | * The minimum SDK version this application targets. It may run on earlier |
Dianne Hackborn | a96cbb4 | 2009-05-13 15:06:13 -0700 | [diff] [blame] | 437 | * versions, but it knows how to work with any new behavior added at this |
| 438 | * version. Will be {@link android.os.Build.VERSION_CODES#CUR_DEVELOPMENT} |
| 439 | * if this is a development build and the app is targeting that. You should |
| 440 | * compare that this number is >= the SDK version number at which your |
| 441 | * behavior was introduced. |
| 442 | */ |
| 443 | public int targetSdkVersion; |
| 444 | |
| 445 | /** |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 446 | * When false, indicates that all components within this application are |
| 447 | * considered disabled, regardless of their individually set enabled status. |
| 448 | */ |
| 449 | public boolean enabled = true; |
| 450 | |
Dianne Hackborn | 54e570f | 2010-10-04 18:32:32 -0700 | [diff] [blame] | 451 | /** |
Dianne Hackborn | 0ac3031 | 2011-06-17 14:49:23 -0700 | [diff] [blame] | 452 | * For convenient access to the current enabled setting of this app. |
| 453 | * @hide |
| 454 | */ |
| 455 | public int enabledSetting = PackageManager.COMPONENT_ENABLED_STATE_DEFAULT; |
| 456 | |
| 457 | /** |
Dianne Hackborn | 54e570f | 2010-10-04 18:32:32 -0700 | [diff] [blame] | 458 | * For convenient access to package's install location. |
| 459 | * @hide |
| 460 | */ |
| 461 | public int installLocation = PackageInfo.INSTALL_LOCATION_UNSPECIFIED; |
| 462 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 463 | public void dump(Printer pw, String prefix) { |
| 464 | super.dumpFront(pw, prefix); |
Dianne Hackborn | 12527f9 | 2009-11-11 17:39:50 -0800 | [diff] [blame] | 465 | if (className != null) { |
| 466 | pw.println(prefix + "className=" + className); |
| 467 | } |
| 468 | if (permission != null) { |
| 469 | pw.println(prefix + "permission=" + permission); |
| 470 | } |
Dianne Hackborn | 39792d2 | 2010-08-19 18:01:52 -0700 | [diff] [blame] | 471 | pw.println(prefix + "processName=" + processName); |
| 472 | pw.println(prefix + "taskAffinity=" + taskAffinity); |
| 473 | pw.println(prefix + "uid=" + uid + " flags=0x" + Integer.toHexString(flags) |
| 474 | + " theme=0x" + Integer.toHexString(theme)); |
Dianne Hackborn | df6e980 | 2011-05-26 14:20:23 -0700 | [diff] [blame] | 475 | pw.println(prefix + "requiresSmallestWidthDp=" + requiresSmallestWidthDp |
Dianne Hackborn | 2762ff3 | 2011-06-01 21:27:05 -0700 | [diff] [blame] | 476 | + " compatibleWidthLimitDp=" + compatibleWidthLimitDp |
| 477 | + " largestWidthLimitDp=" + largestWidthLimitDp); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 478 | pw.println(prefix + "sourceDir=" + sourceDir); |
Dianne Hackborn | 817c247 | 2010-10-05 14:40:22 -0700 | [diff] [blame] | 479 | if (sourceDir == null) { |
| 480 | if (publicSourceDir != null) { |
| 481 | pw.println(prefix + "publicSourceDir=" + publicSourceDir); |
| 482 | } |
| 483 | } else if (!sourceDir.equals(publicSourceDir)) { |
Dianne Hackborn | 39792d2 | 2010-08-19 18:01:52 -0700 | [diff] [blame] | 484 | pw.println(prefix + "publicSourceDir=" + publicSourceDir); |
| 485 | } |
| 486 | if (resourceDirs != null) { |
| 487 | pw.println(prefix + "resourceDirs=" + resourceDirs); |
| 488 | } |
Robert Craig | 0f40dc9 | 2013-03-25 06:33:03 -0400 | [diff] [blame^] | 489 | if (seinfo != null) { |
| 490 | pw.println(prefix + "seinfo=" + seinfo); |
| 491 | } |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 492 | pw.println(prefix + "dataDir=" + dataDir); |
Dianne Hackborn | 12527f9 | 2009-11-11 17:39:50 -0800 | [diff] [blame] | 493 | if (sharedLibraryFiles != null) { |
| 494 | pw.println(prefix + "sharedLibraryFiles=" + sharedLibraryFiles); |
| 495 | } |
| 496 | pw.println(prefix + "enabled=" + enabled + " targetSdkVersion=" + targetSdkVersion); |
| 497 | if (manageSpaceActivityName != null) { |
| 498 | pw.println(prefix + "manageSpaceActivityName="+manageSpaceActivityName); |
| 499 | } |
| 500 | if (descriptionRes != 0) { |
| 501 | pw.println(prefix + "description=0x"+Integer.toHexString(descriptionRes)); |
| 502 | } |
Adam Powell | 269248d | 2011-08-02 10:26:54 -0700 | [diff] [blame] | 503 | if (uiOptions != 0) { |
| 504 | pw.println(prefix + "uiOptions=0x" + Integer.toHexString(uiOptions)); |
| 505 | } |
Fabrice Di Meglio | 59dfce8 | 2012-04-02 16:17:20 -0700 | [diff] [blame] | 506 | pw.println(prefix + "supportsRtl=" + (hasRtlSupport() ? "true" : "false")); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 507 | super.dumpBack(pw, prefix); |
| 508 | } |
Fabrice Di Meglio | 59dfce8 | 2012-04-02 16:17:20 -0700 | [diff] [blame] | 509 | |
| 510 | /** |
| 511 | * @return true if "supportsRtl" has been set to true in the AndroidManifest |
| 512 | * @hide |
| 513 | */ |
| 514 | public boolean hasRtlSupport() { |
| 515 | return (flags & FLAG_SUPPORTS_RTL) == FLAG_SUPPORTS_RTL; |
| 516 | } |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 517 | |
| 518 | public static class DisplayNameComparator |
| 519 | implements Comparator<ApplicationInfo> { |
| 520 | public DisplayNameComparator(PackageManager pm) { |
| 521 | mPM = pm; |
| 522 | } |
| 523 | |
| 524 | public final int compare(ApplicationInfo aa, ApplicationInfo ab) { |
| 525 | CharSequence sa = mPM.getApplicationLabel(aa); |
| 526 | if (sa == null) { |
| 527 | sa = aa.packageName; |
| 528 | } |
| 529 | CharSequence sb = mPM.getApplicationLabel(ab); |
| 530 | if (sb == null) { |
| 531 | sb = ab.packageName; |
| 532 | } |
| 533 | |
| 534 | return sCollator.compare(sa.toString(), sb.toString()); |
| 535 | } |
| 536 | |
| 537 | private final Collator sCollator = Collator.getInstance(); |
| 538 | private PackageManager mPM; |
| 539 | } |
| 540 | |
| 541 | public ApplicationInfo() { |
| 542 | } |
| 543 | |
| 544 | public ApplicationInfo(ApplicationInfo orig) { |
| 545 | super(orig); |
| 546 | taskAffinity = orig.taskAffinity; |
| 547 | permission = orig.permission; |
| 548 | processName = orig.processName; |
| 549 | className = orig.className; |
| 550 | theme = orig.theme; |
| 551 | flags = orig.flags; |
Dianne Hackborn | df6e980 | 2011-05-26 14:20:23 -0700 | [diff] [blame] | 552 | requiresSmallestWidthDp = orig.requiresSmallestWidthDp; |
| 553 | compatibleWidthLimitDp = orig.compatibleWidthLimitDp; |
Dianne Hackborn | 2762ff3 | 2011-06-01 21:27:05 -0700 | [diff] [blame] | 554 | largestWidthLimitDp = orig.largestWidthLimitDp; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 555 | sourceDir = orig.sourceDir; |
| 556 | publicSourceDir = orig.publicSourceDir; |
Kenny Root | 85387d7 | 2010-08-26 10:13:11 -0700 | [diff] [blame] | 557 | nativeLibraryDir = orig.nativeLibraryDir; |
Kenny Root | d1ab016 | 2010-01-21 17:27:14 -0800 | [diff] [blame] | 558 | resourceDirs = orig.resourceDirs; |
Robert Craig | 0f40dc9 | 2013-03-25 06:33:03 -0400 | [diff] [blame^] | 559 | seinfo = orig.seinfo; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 560 | sharedLibraryFiles = orig.sharedLibraryFiles; |
| 561 | dataDir = orig.dataDir; |
| 562 | uid = orig.uid; |
Dianne Hackborn | a96cbb4 | 2009-05-13 15:06:13 -0700 | [diff] [blame] | 563 | targetSdkVersion = orig.targetSdkVersion; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 564 | enabled = orig.enabled; |
Dianne Hackborn | 0ac3031 | 2011-06-17 14:49:23 -0700 | [diff] [blame] | 565 | enabledSetting = orig.enabledSetting; |
Dianne Hackborn | 54e570f | 2010-10-04 18:32:32 -0700 | [diff] [blame] | 566 | installLocation = orig.installLocation; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 567 | manageSpaceActivityName = orig.manageSpaceActivityName; |
| 568 | descriptionRes = orig.descriptionRes; |
Adam Powell | 269248d | 2011-08-02 10:26:54 -0700 | [diff] [blame] | 569 | uiOptions = orig.uiOptions; |
Christopher Tate | bcb0255 | 2012-10-16 17:14:34 -0700 | [diff] [blame] | 570 | backupAgentName = orig.backupAgentName; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 571 | } |
| 572 | |
| 573 | |
| 574 | public String toString() { |
| 575 | return "ApplicationInfo{" |
| 576 | + Integer.toHexString(System.identityHashCode(this)) |
| 577 | + " " + packageName + "}"; |
| 578 | } |
| 579 | |
| 580 | public int describeContents() { |
| 581 | return 0; |
| 582 | } |
| 583 | |
| 584 | public void writeToParcel(Parcel dest, int parcelableFlags) { |
| 585 | super.writeToParcel(dest, parcelableFlags); |
| 586 | dest.writeString(taskAffinity); |
| 587 | dest.writeString(permission); |
| 588 | dest.writeString(processName); |
| 589 | dest.writeString(className); |
| 590 | dest.writeInt(theme); |
| 591 | dest.writeInt(flags); |
Dianne Hackborn | df6e980 | 2011-05-26 14:20:23 -0700 | [diff] [blame] | 592 | dest.writeInt(requiresSmallestWidthDp); |
| 593 | dest.writeInt(compatibleWidthLimitDp); |
Dianne Hackborn | 2762ff3 | 2011-06-01 21:27:05 -0700 | [diff] [blame] | 594 | dest.writeInt(largestWidthLimitDp); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 595 | dest.writeString(sourceDir); |
| 596 | dest.writeString(publicSourceDir); |
Kenny Root | 85387d7 | 2010-08-26 10:13:11 -0700 | [diff] [blame] | 597 | dest.writeString(nativeLibraryDir); |
Kenny Root | d1ab016 | 2010-01-21 17:27:14 -0800 | [diff] [blame] | 598 | dest.writeStringArray(resourceDirs); |
Robert Craig | 0f40dc9 | 2013-03-25 06:33:03 -0400 | [diff] [blame^] | 599 | dest.writeString(seinfo); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 600 | dest.writeStringArray(sharedLibraryFiles); |
| 601 | dest.writeString(dataDir); |
| 602 | dest.writeInt(uid); |
Dianne Hackborn | a96cbb4 | 2009-05-13 15:06:13 -0700 | [diff] [blame] | 603 | dest.writeInt(targetSdkVersion); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 604 | dest.writeInt(enabled ? 1 : 0); |
Dianne Hackborn | 0ac3031 | 2011-06-17 14:49:23 -0700 | [diff] [blame] | 605 | dest.writeInt(enabledSetting); |
Dianne Hackborn | 54e570f | 2010-10-04 18:32:32 -0700 | [diff] [blame] | 606 | dest.writeInt(installLocation); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 607 | dest.writeString(manageSpaceActivityName); |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 608 | dest.writeString(backupAgentName); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 609 | dest.writeInt(descriptionRes); |
Adam Powell | 269248d | 2011-08-02 10:26:54 -0700 | [diff] [blame] | 610 | dest.writeInt(uiOptions); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 611 | } |
| 612 | |
| 613 | public static final Parcelable.Creator<ApplicationInfo> CREATOR |
| 614 | = new Parcelable.Creator<ApplicationInfo>() { |
| 615 | public ApplicationInfo createFromParcel(Parcel source) { |
| 616 | return new ApplicationInfo(source); |
| 617 | } |
| 618 | public ApplicationInfo[] newArray(int size) { |
| 619 | return new ApplicationInfo[size]; |
| 620 | } |
| 621 | }; |
| 622 | |
| 623 | private ApplicationInfo(Parcel source) { |
| 624 | super(source); |
| 625 | taskAffinity = source.readString(); |
| 626 | permission = source.readString(); |
| 627 | processName = source.readString(); |
| 628 | className = source.readString(); |
| 629 | theme = source.readInt(); |
| 630 | flags = source.readInt(); |
Dianne Hackborn | df6e980 | 2011-05-26 14:20:23 -0700 | [diff] [blame] | 631 | requiresSmallestWidthDp = source.readInt(); |
| 632 | compatibleWidthLimitDp = source.readInt(); |
Dianne Hackborn | 2762ff3 | 2011-06-01 21:27:05 -0700 | [diff] [blame] | 633 | largestWidthLimitDp = source.readInt(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 634 | sourceDir = source.readString(); |
| 635 | publicSourceDir = source.readString(); |
Kenny Root | 85387d7 | 2010-08-26 10:13:11 -0700 | [diff] [blame] | 636 | nativeLibraryDir = source.readString(); |
Kenny Root | d1ab016 | 2010-01-21 17:27:14 -0800 | [diff] [blame] | 637 | resourceDirs = source.readStringArray(); |
Robert Craig | 0f40dc9 | 2013-03-25 06:33:03 -0400 | [diff] [blame^] | 638 | seinfo = source.readString(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 639 | sharedLibraryFiles = source.readStringArray(); |
| 640 | dataDir = source.readString(); |
| 641 | uid = source.readInt(); |
Dianne Hackborn | a96cbb4 | 2009-05-13 15:06:13 -0700 | [diff] [blame] | 642 | targetSdkVersion = source.readInt(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 643 | enabled = source.readInt() != 0; |
Dianne Hackborn | 0ac3031 | 2011-06-17 14:49:23 -0700 | [diff] [blame] | 644 | enabledSetting = source.readInt(); |
Dianne Hackborn | 54e570f | 2010-10-04 18:32:32 -0700 | [diff] [blame] | 645 | installLocation = source.readInt(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 646 | manageSpaceActivityName = source.readString(); |
Christopher Tate | 181fafa | 2009-05-14 11:12:14 -0700 | [diff] [blame] | 647 | backupAgentName = source.readString(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 648 | descriptionRes = source.readInt(); |
Adam Powell | 269248d | 2011-08-02 10:26:54 -0700 | [diff] [blame] | 649 | uiOptions = source.readInt(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 650 | } |
Mitsuru Oshima | 8d11267 | 2009-04-27 12:01:23 -0700 | [diff] [blame] | 651 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 652 | /** |
| 653 | * Retrieve the textual description of the application. This |
| 654 | * will call back on the given PackageManager to load the description from |
| 655 | * the application. |
| 656 | * |
| 657 | * @param pm A PackageManager from which the label can be loaded; usually |
| 658 | * the PackageManager from which you originally retrieved this item. |
| 659 | * |
| 660 | * @return Returns a CharSequence containing the application's description. |
| 661 | * If there is no description, null is returned. |
| 662 | */ |
| 663 | public CharSequence loadDescription(PackageManager pm) { |
| 664 | if (descriptionRes != 0) { |
Jeff Brown | 0733079 | 2010-03-30 19:57:08 -0700 | [diff] [blame] | 665 | CharSequence label = pm.getText(packageName, descriptionRes, this); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 666 | if (label != null) { |
| 667 | return label; |
| 668 | } |
| 669 | } |
| 670 | return null; |
| 671 | } |
Mitsuru Oshima | e5fb328 | 2009-06-09 21:16:08 -0700 | [diff] [blame] | 672 | |
| 673 | /** |
| 674 | * Disable compatibility mode |
| 675 | * |
| 676 | * @hide |
| 677 | */ |
| 678 | public void disableCompatibilityMode() { |
Mitsuru Oshima | 69fff4a | 2009-07-21 09:51:05 -0700 | [diff] [blame] | 679 | flags |= (FLAG_SUPPORTS_LARGE_SCREENS | FLAG_SUPPORTS_NORMAL_SCREENS | |
Dianne Hackborn | 11b822d | 2009-07-21 20:03:02 -0700 | [diff] [blame] | 680 | FLAG_SUPPORTS_SMALL_SCREENS | FLAG_RESIZEABLE_FOR_SCREENS | |
Dianne Hackborn | 14cee9f | 2010-04-23 17:51:26 -0700 | [diff] [blame] | 681 | FLAG_SUPPORTS_SCREEN_DENSITIES | FLAG_SUPPORTS_XLARGE_SCREENS); |
Mitsuru Oshima | e5fb328 | 2009-06-09 21:16:08 -0700 | [diff] [blame] | 682 | } |
Jeff Brown | 0733079 | 2010-03-30 19:57:08 -0700 | [diff] [blame] | 683 | |
| 684 | /** |
| 685 | * @hide |
| 686 | */ |
| 687 | @Override protected Drawable loadDefaultIcon(PackageManager pm) { |
| 688 | if ((flags & FLAG_EXTERNAL_STORAGE) != 0 |
| 689 | && isPackageUnavailable(pm)) { |
| 690 | return Resources.getSystem().getDrawable( |
| 691 | com.android.internal.R.drawable.sym_app_on_sd_unavailable_icon); |
| 692 | } |
| 693 | return pm.getDefaultActivityIcon(); |
| 694 | } |
| 695 | |
| 696 | private boolean isPackageUnavailable(PackageManager pm) { |
| 697 | try { |
| 698 | return pm.getPackageInfo(packageName, 0) == null; |
| 699 | } catch (NameNotFoundException ex) { |
| 700 | return true; |
| 701 | } |
| 702 | } |
| 703 | |
| 704 | /** |
| 705 | * @hide |
| 706 | */ |
| 707 | @Override protected ApplicationInfo getApplicationInfo() { |
| 708 | return this; |
| 709 | } |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 710 | } |