ApplicationInfo.java revision 9189cabb0b6c6c28232fe6f412b7ba7a37352a6a
1package android.content.pm; 2 3import android.os.Parcel; 4import android.os.Parcelable; 5import android.util.Printer; 6 7import java.text.Collator; 8import java.util.Comparator; 9 10/** 11 * Information you can retrieve about a particular application. This 12 * corresponds to information collected from the AndroidManifest.xml's 13 * <application> tag. 14 */ 15public class ApplicationInfo extends PackageItemInfo implements Parcelable { 16 17 /** 18 * Default task affinity of all activities in this application. See 19 * {@link ActivityInfo#taskAffinity} for more information. This comes 20 * from the "taskAffinity" attribute. 21 */ 22 public String taskAffinity; 23 24 /** 25 * Optional name of a permission required to be able to access this 26 * application's components. From the "permission" attribute. 27 */ 28 public String permission; 29 30 /** 31 * The name of the process this application should run in. From the 32 * "process" attribute or, if not set, the same as 33 * <var>packageName</var>. 34 */ 35 public String processName; 36 37 /** 38 * Class implementing the Application object. From the "class" 39 * attribute. 40 */ 41 public String className; 42 43 /** 44 * A style resource identifier (in the package's resources) of the 45 * description of an application. From the "description" attribute 46 * or, if not set, 0. 47 */ 48 public int descriptionRes; 49 50 /** 51 * A style resource identifier (in the package's resources) of the 52 * default visual theme of the application. From the "theme" attribute 53 * or, if not set, 0. 54 */ 55 public int theme; 56 57 /** 58 * Class implementing the Application's manage space 59 * functionality. From the "manageSpaceActivity" 60 * attribute. This is an optional attribute and will be null if 61 * applications don't specify it in their manifest 62 */ 63 public String manageSpaceActivityName; 64 65 /** 66 * Class implementing the Application's backup functionality. From 67 * the "backupAgent" attribute. This is an optional attribute and 68 * will be null if the application does not specify it in its manifest. 69 * 70 * <p>If android:allowBackup is set to false, this attribute is ignored. 71 * 72 * {@hide} 73 */ 74 public String backupAgentName; 75 76 /** 77 * Value for {@link #flags}: if set, this application is installed in the 78 * device's system image. 79 */ 80 public static final int FLAG_SYSTEM = 1<<0; 81 82 /** 83 * Value for {@link #flags}: set to true if this application would like to 84 * allow debugging of its 85 * code, even when installed on a non-development system. Comes 86 * from {@link android.R.styleable#AndroidManifestApplication_debuggable 87 * android:debuggable} of the <application> tag. 88 */ 89 public static final int FLAG_DEBUGGABLE = 1<<1; 90 91 /** 92 * Value for {@link #flags}: set to true if this application has code 93 * associated with it. Comes 94 * from {@link android.R.styleable#AndroidManifestApplication_hasCode 95 * android:hasCode} of the <application> tag. 96 */ 97 public static final int FLAG_HAS_CODE = 1<<2; 98 99 /** 100 * Value for {@link #flags}: set to true if this application is persistent. 101 * Comes from {@link android.R.styleable#AndroidManifestApplication_persistent 102 * android:persistent} of the <application> tag. 103 */ 104 public static final int FLAG_PERSISTENT = 1<<3; 105 106 /** 107 * Value for {@link #flags}: set to true if this application holds the 108 * {@link android.Manifest.permission#FACTORY_TEST} permission and the 109 * device is running in factory test mode. 110 */ 111 public static final int FLAG_FACTORY_TEST = 1<<4; 112 113 /** 114 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. 115 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowTaskReparenting 116 * android:allowTaskReparenting} of the <application> tag. 117 */ 118 public static final int FLAG_ALLOW_TASK_REPARENTING = 1<<5; 119 120 /** 121 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. 122 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowClearUserData 123 * android:allowClearUserData} of the <application> tag. 124 */ 125 public static final int FLAG_ALLOW_CLEAR_USER_DATA = 1<<6; 126 127 /** 128 * Value for {@link #flags}: this is set if this application has been 129 * install as an update to a built-in system application. 130 */ 131 public static final int FLAG_UPDATED_SYSTEM_APP = 1<<7; 132 133 /** 134 * Value for {@link #flags}: this is set of the application has set 135 * its android:targetSdkVersion to something >= the current SDK version. 136 */ 137 public static final int FLAG_TEST_ONLY = 1<<8; 138 139 /** 140 * Value for {@link #flags}: this is false if the application has set 141 * its android:allowBackup to false, true otherwise. 142 * 143 * {@hide} 144 */ 145 public static final int FLAG_ALLOW_BACKUP = 1<<10; 146 147 /** 148 * Flags associated with the application. Any combination of 149 * {@link #FLAG_SYSTEM}, {@link #FLAG_DEBUGGABLE}, {@link #FLAG_HAS_CODE}, 150 * {@link #FLAG_PERSISTENT}, {@link #FLAG_FACTORY_TEST}, and 151 * {@link #FLAG_ALLOW_TASK_REPARENTING} 152 * {@link #FLAG_ALLOW_CLEAR_USER_DATA}, {@link #FLAG_UPDATED_SYSTEM_APP}, 153 * {@link #FLAG_TEST_ONLY}. 154 */ 155 public int flags = 0; 156 157 /** 158 * Full path to the location of this package. 159 */ 160 public String sourceDir; 161 162 /** 163 * Full path to the location of the publicly available parts of this package (i.e. the resources 164 * and manifest). For non-forward-locked apps this will be the same as {@link #sourceDir). 165 */ 166 public String publicSourceDir; 167 168 /** 169 * Paths to all shared libraries this application is linked against. This 170 * field is only set if the {@link PackageManager#GET_SHARED_LIBRARY_FILES 171 * PackageManager.GET_SHARED_LIBRARY_FILES} flag was used when retrieving 172 * the structure. 173 */ 174 public String[] sharedLibraryFiles; 175 176 /** 177 * Full path to a directory assigned to the package for its persistent 178 * data. 179 */ 180 public String dataDir; 181 182 /** 183 * The kernel user-ID that has been assigned to this application; 184 * currently this is not a unique ID (multiple applications can have 185 * the same uid). 186 */ 187 public int uid; 188 189 /** 190 * The list of densities in DPI that application supprots. This 191 * field is only set if the {@link PackageManager#GET_SUPPORTS_DENSITIES} flag was 192 * used when retrieving the structure. 193 */ 194 public int[] supportsDensities; 195 196 /** 197 * True when the application's window can be expanded over default window 198 * size in target density (320x480 for 1.0 density, 480x720 for 1.5 density etc) 199 */ 200 public boolean expandable = false; 201 202 /** 203 * The minimum SDK version this application targets. It may run on earilier 204 * versions, but it knows how to work with any new behavior added at this 205 * version. Will be {@link android.os.Build.VERSION_CODES#CUR_DEVELOPMENT} 206 * if this is a development build and the app is targeting that. You should 207 * compare that this number is >= the SDK version number at which your 208 * behavior was introduced. 209 */ 210 public int targetSdkVersion; 211 212 /** 213 * When false, indicates that all components within this application are 214 * considered disabled, regardless of their individually set enabled status. 215 */ 216 public boolean enabled = true; 217 218 public void dump(Printer pw, String prefix) { 219 super.dumpFront(pw, prefix); 220 pw.println(prefix + "className=" + className); 221 pw.println(prefix + "permission=" + permission 222 + " uid=" + uid); 223 pw.println(prefix + "taskAffinity=" + taskAffinity); 224 pw.println(prefix + "theme=0x" + Integer.toHexString(theme)); 225 pw.println(prefix + "flags=0x" + Integer.toHexString(flags) 226 + " processName=" + processName); 227 pw.println(prefix + "sourceDir=" + sourceDir); 228 pw.println(prefix + "publicSourceDir=" + publicSourceDir); 229 pw.println(prefix + "sharedLibraryFiles=" + sharedLibraryFiles); 230 pw.println(prefix + "dataDir=" + dataDir); 231 pw.println(prefix + "targetSdkVersion=" + targetSdkVersion); 232 pw.println(prefix + "enabled=" + enabled); 233 pw.println(prefix + "manageSpaceActivityName="+manageSpaceActivityName); 234 pw.println(prefix + "description=0x"+Integer.toHexString(descriptionRes)); 235 pw.println(prefix + "supportsDensities=" + supportsDensities); 236 pw.println(prefix + "expandable=" + expandable); 237 super.dumpBack(pw, prefix); 238 } 239 240 public static class DisplayNameComparator 241 implements Comparator<ApplicationInfo> { 242 public DisplayNameComparator(PackageManager pm) { 243 mPM = pm; 244 } 245 246 public final int compare(ApplicationInfo aa, ApplicationInfo ab) { 247 CharSequence sa = mPM.getApplicationLabel(aa); 248 if (sa == null) { 249 sa = aa.packageName; 250 } 251 CharSequence sb = mPM.getApplicationLabel(ab); 252 if (sb == null) { 253 sb = ab.packageName; 254 } 255 256 return sCollator.compare(sa.toString(), sb.toString()); 257 } 258 259 private final Collator sCollator = Collator.getInstance(); 260 private PackageManager mPM; 261 } 262 263 public ApplicationInfo() { 264 } 265 266 public ApplicationInfo(ApplicationInfo orig) { 267 super(orig); 268 taskAffinity = orig.taskAffinity; 269 permission = orig.permission; 270 processName = orig.processName; 271 className = orig.className; 272 theme = orig.theme; 273 flags = orig.flags; 274 sourceDir = orig.sourceDir; 275 publicSourceDir = orig.publicSourceDir; 276 sharedLibraryFiles = orig.sharedLibraryFiles; 277 dataDir = orig.dataDir; 278 uid = orig.uid; 279 targetSdkVersion = orig.targetSdkVersion; 280 enabled = orig.enabled; 281 manageSpaceActivityName = orig.manageSpaceActivityName; 282 descriptionRes = orig.descriptionRes; 283 supportsDensities = orig.supportsDensities; 284 expandable = orig.expandable; 285 } 286 287 288 public String toString() { 289 return "ApplicationInfo{" 290 + Integer.toHexString(System.identityHashCode(this)) 291 + " " + packageName + "}"; 292 } 293 294 public int describeContents() { 295 return 0; 296 } 297 298 public void writeToParcel(Parcel dest, int parcelableFlags) { 299 super.writeToParcel(dest, parcelableFlags); 300 dest.writeString(taskAffinity); 301 dest.writeString(permission); 302 dest.writeString(processName); 303 dest.writeString(className); 304 dest.writeInt(theme); 305 dest.writeInt(flags); 306 dest.writeString(sourceDir); 307 dest.writeString(publicSourceDir); 308 dest.writeStringArray(sharedLibraryFiles); 309 dest.writeString(dataDir); 310 dest.writeInt(uid); 311 dest.writeInt(targetSdkVersion); 312 dest.writeInt(enabled ? 1 : 0); 313 dest.writeString(manageSpaceActivityName); 314 dest.writeString(backupAgentName); 315 dest.writeInt(descriptionRes); 316 dest.writeIntArray(supportsDensities); 317 dest.writeInt(expandable ? 1 : 0); 318 } 319 320 public static final Parcelable.Creator<ApplicationInfo> CREATOR 321 = new Parcelable.Creator<ApplicationInfo>() { 322 public ApplicationInfo createFromParcel(Parcel source) { 323 return new ApplicationInfo(source); 324 } 325 public ApplicationInfo[] newArray(int size) { 326 return new ApplicationInfo[size]; 327 } 328 }; 329 330 private ApplicationInfo(Parcel source) { 331 super(source); 332 taskAffinity = source.readString(); 333 permission = source.readString(); 334 processName = source.readString(); 335 className = source.readString(); 336 theme = source.readInt(); 337 flags = source.readInt(); 338 sourceDir = source.readString(); 339 publicSourceDir = source.readString(); 340 sharedLibraryFiles = source.readStringArray(); 341 dataDir = source.readString(); 342 uid = source.readInt(); 343 targetSdkVersion = source.readInt(); 344 enabled = source.readInt() != 0; 345 manageSpaceActivityName = source.readString(); 346 backupAgentName = source.readString(); 347 descriptionRes = source.readInt(); 348 supportsDensities = source.createIntArray(); 349 expandable = source.readInt() != 0; 350 } 351 352 /** 353 * Retrieve the textual description of the application. This 354 * will call back on the given PackageManager to load the description from 355 * the application. 356 * 357 * @param pm A PackageManager from which the label can be loaded; usually 358 * the PackageManager from which you originally retrieved this item. 359 * 360 * @return Returns a CharSequence containing the application's description. 361 * If there is no description, null is returned. 362 */ 363 public CharSequence loadDescription(PackageManager pm) { 364 if (descriptionRes != 0) { 365 CharSequence label = pm.getText(packageName, descriptionRes, null); 366 if (label != null) { 367 return label; 368 } 369 } 370 return null; 371 } 372} 373