ApplicationInfo.java revision 01a959d60a2c5f04ab240513a853d7845b3a309e
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 17package android.content.pm; 18 19import android.content.pm.PackageManager.NameNotFoundException; 20import android.content.res.Resources; 21import android.graphics.drawable.Drawable; 22import android.os.Parcel; 23import android.os.Parcelable; 24import android.util.Printer; 25 26import com.android.internal.util.ArrayUtils; 27 28import java.text.Collator; 29import java.util.Arrays; 30import java.util.Comparator; 31import java.util.Objects; 32 33/** 34 * Information you can retrieve about a particular application. This 35 * corresponds to information collected from the AndroidManifest.xml's 36 * <application> tag. 37 */ 38public class ApplicationInfo extends PackageItemInfo implements Parcelable { 39 40 /** 41 * Default task affinity of all activities in this application. See 42 * {@link ActivityInfo#taskAffinity} for more information. This comes 43 * from the "taskAffinity" attribute. 44 */ 45 public String taskAffinity; 46 47 /** 48 * Optional name of a permission required to be able to access this 49 * application's components. From the "permission" attribute. 50 */ 51 public String permission; 52 53 /** 54 * The name of the process this application should run in. From the 55 * "process" attribute or, if not set, the same as 56 * <var>packageName</var>. 57 */ 58 public String processName; 59 60 /** 61 * Class implementing the Application object. From the "class" 62 * attribute. 63 */ 64 public String className; 65 66 /** 67 * A style resource identifier (in the package's resources) of the 68 * description of an application. From the "description" attribute 69 * or, if not set, 0. 70 */ 71 public int descriptionRes; 72 73 /** 74 * A style resource identifier (in the package's resources) of the 75 * default visual theme of the application. From the "theme" attribute 76 * or, if not set, 0. 77 */ 78 public int theme; 79 80 /** 81 * Class implementing the Application's manage space 82 * functionality. From the "manageSpaceActivity" 83 * attribute. This is an optional attribute and will be null if 84 * applications don't specify it in their manifest 85 */ 86 public String manageSpaceActivityName; 87 88 /** 89 * Class implementing the Application's backup functionality. From 90 * the "backupAgent" attribute. This is an optional attribute and 91 * will be null if the application does not specify it in its manifest. 92 * 93 * <p>If android:allowBackup is set to false, this attribute is ignored. 94 */ 95 public String backupAgentName; 96 97 /** 98 * The default extra UI options for activities in this application. 99 * Set from the {@link android.R.attr#uiOptions} attribute in the 100 * activity's manifest. 101 */ 102 public int uiOptions = 0; 103 104 /** 105 * Value for {@link #flags}: if set, this application is installed in the 106 * device's system image. 107 */ 108 public static final int FLAG_SYSTEM = 1<<0; 109 110 /** 111 * Value for {@link #flags}: set to true if this application would like to 112 * allow debugging of its 113 * code, even when installed on a non-development system. Comes 114 * from {@link android.R.styleable#AndroidManifestApplication_debuggable 115 * android:debuggable} of the <application> tag. 116 */ 117 public static final int FLAG_DEBUGGABLE = 1<<1; 118 119 /** 120 * Value for {@link #flags}: set to true if this application has code 121 * associated with it. Comes 122 * from {@link android.R.styleable#AndroidManifestApplication_hasCode 123 * android:hasCode} of the <application> tag. 124 */ 125 public static final int FLAG_HAS_CODE = 1<<2; 126 127 /** 128 * Value for {@link #flags}: set to true if this application is persistent. 129 * Comes from {@link android.R.styleable#AndroidManifestApplication_persistent 130 * android:persistent} of the <application> tag. 131 */ 132 public static final int FLAG_PERSISTENT = 1<<3; 133 134 /** 135 * Value for {@link #flags}: set to true if this application holds the 136 * {@link android.Manifest.permission#FACTORY_TEST} permission and the 137 * device is running in factory test mode. 138 */ 139 public static final int FLAG_FACTORY_TEST = 1<<4; 140 141 /** 142 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. 143 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowTaskReparenting 144 * android:allowTaskReparenting} of the <application> tag. 145 */ 146 public static final int FLAG_ALLOW_TASK_REPARENTING = 1<<5; 147 148 /** 149 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. 150 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowClearUserData 151 * android:allowClearUserData} of the <application> tag. 152 */ 153 public static final int FLAG_ALLOW_CLEAR_USER_DATA = 1<<6; 154 155 /** 156 * Value for {@link #flags}: this is set if this application has been 157 * install as an update to a built-in system application. 158 */ 159 public static final int FLAG_UPDATED_SYSTEM_APP = 1<<7; 160 161 /** 162 * Value for {@link #flags}: this is set of the application has specified 163 * {@link android.R.styleable#AndroidManifestApplication_testOnly 164 * android:testOnly} to be true. 165 */ 166 public static final int FLAG_TEST_ONLY = 1<<8; 167 168 /** 169 * Value for {@link #flags}: true when the application's window can be 170 * reduced in size for smaller screens. Corresponds to 171 * {@link android.R.styleable#AndroidManifestSupportsScreens_smallScreens 172 * android:smallScreens}. 173 */ 174 public static final int FLAG_SUPPORTS_SMALL_SCREENS = 1<<9; 175 176 /** 177 * Value for {@link #flags}: true when the application's window can be 178 * displayed on normal screens. Corresponds to 179 * {@link android.R.styleable#AndroidManifestSupportsScreens_normalScreens 180 * android:normalScreens}. 181 */ 182 public static final int FLAG_SUPPORTS_NORMAL_SCREENS = 1<<10; 183 184 /** 185 * Value for {@link #flags}: true when the application's window can be 186 * increased in size for larger screens. Corresponds to 187 * {@link android.R.styleable#AndroidManifestSupportsScreens_largeScreens 188 * android:largeScreens}. 189 */ 190 public static final int FLAG_SUPPORTS_LARGE_SCREENS = 1<<11; 191 192 /** 193 * Value for {@link #flags}: true when the application knows how to adjust 194 * its UI for different screen sizes. Corresponds to 195 * {@link android.R.styleable#AndroidManifestSupportsScreens_resizeable 196 * android:resizeable}. 197 */ 198 public static final int FLAG_RESIZEABLE_FOR_SCREENS = 1<<12; 199 200 /** 201 * Value for {@link #flags}: true when the application knows how to 202 * accomodate different screen densities. Corresponds to 203 * {@link android.R.styleable#AndroidManifestSupportsScreens_anyDensity 204 * android:anyDensity}. 205 */ 206 public static final int FLAG_SUPPORTS_SCREEN_DENSITIES = 1<<13; 207 208 /** 209 * Value for {@link #flags}: set to true if this application would like to 210 * request the VM to operate under the safe mode. Comes from 211 * {@link android.R.styleable#AndroidManifestApplication_vmSafeMode 212 * android:vmSafeMode} of the <application> tag. 213 */ 214 public static final int FLAG_VM_SAFE_MODE = 1<<14; 215 216 /** 217 * Value for {@link #flags}: set to <code>false</code> if the application does not wish 218 * to permit any OS-driven backups of its data; <code>true</code> otherwise. 219 * 220 * <p>Comes from the 221 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} 222 * attribute of the <application> tag. 223 */ 224 public static final int FLAG_ALLOW_BACKUP = 1<<15; 225 226 /** 227 * Value for {@link #flags}: set to <code>false</code> if the application must be kept 228 * in memory following a full-system restore operation; <code>true</code> otherwise. 229 * Ordinarily, during a full system restore operation each application is shut down 230 * following execution of its agent's onRestore() method. Setting this attribute to 231 * <code>false</code> prevents this. Most applications will not need to set this attribute. 232 * 233 * <p>If 234 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} 235 * is set to <code>false</code> or no 236 * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent} 237 * is specified, this flag will be ignored. 238 * 239 * <p>Comes from the 240 * {@link android.R.styleable#AndroidManifestApplication_killAfterRestore android:killAfterRestore} 241 * attribute of the <application> tag. 242 */ 243 public static final int FLAG_KILL_AFTER_RESTORE = 1<<16; 244 245 /** 246 * Value for {@link #flags}: Set to <code>true</code> if the application's backup 247 * agent claims to be able to handle restore data even "from the future," 248 * i.e. from versions of the application with a versionCode greater than 249 * the one currently installed on the device. <i>Use with caution!</i> By default 250 * this attribute is <code>false</code> and the Backup Manager will ensure that data 251 * from "future" versions of the application are never supplied during a restore operation. 252 * 253 * <p>If 254 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} 255 * is set to <code>false</code> or no 256 * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent} 257 * is specified, this flag will be ignored. 258 * 259 * <p>Comes from the 260 * {@link android.R.styleable#AndroidManifestApplication_restoreAnyVersion android:restoreAnyVersion} 261 * attribute of the <application> tag. 262 */ 263 public static final int FLAG_RESTORE_ANY_VERSION = 1<<17; 264 265 /** 266 * Value for {@link #flags}: Set to true if the application is 267 * currently installed on external/removable/unprotected storage. Such 268 * applications may not be available if their storage is not currently 269 * mounted. When the storage it is on is not available, it will look like 270 * the application has been uninstalled (its .apk is no longer available) 271 * but its persistent data is not removed. 272 */ 273 public static final int FLAG_EXTERNAL_STORAGE = 1<<18; 274 275 /** 276 * Value for {@link #flags}: true when the application's window can be 277 * increased in size for extra large screens. Corresponds to 278 * {@link android.R.styleable#AndroidManifestSupportsScreens_xlargeScreens 279 * android:xlargeScreens}. 280 */ 281 public static final int FLAG_SUPPORTS_XLARGE_SCREENS = 1<<19; 282 283 /** 284 * Value for {@link #flags}: true when the application has requested a 285 * large heap for its processes. Corresponds to 286 * {@link android.R.styleable#AndroidManifestApplication_largeHeap 287 * android:largeHeap}. 288 */ 289 public static final int FLAG_LARGE_HEAP = 1<<20; 290 291 /** 292 * Value for {@link #flags}: true if this application's package is in 293 * the stopped state. 294 */ 295 public static final int FLAG_STOPPED = 1<<21; 296 297 /** 298 * Value for {@link #flags}: true when the application is willing to support 299 * RTL (right to left). All activities will inherit this value. 300 * 301 * Set from the {@link android.R.attr#supportsRtl} attribute in the 302 * activity's manifest. 303 * 304 * Default value is false (no support for RTL). 305 */ 306 public static final int FLAG_SUPPORTS_RTL = 1<<22; 307 308 /** 309 * Value for {@link #flags}: true if the application is currently 310 * installed for the calling user. 311 */ 312 public static final int FLAG_INSTALLED = 1<<23; 313 314 /** 315 * Value for {@link #flags}: true if the application only has its 316 * data installed; the application package itself does not currently 317 * exist on the device. 318 */ 319 public static final int FLAG_IS_DATA_ONLY = 1<<24; 320 321 /** 322 * Value for {@link #flags}: true if the application was declared to be a game, or 323 * false if it is a non-game application. 324 */ 325 public static final int FLAG_IS_GAME = 1<<25; 326 327 /** 328 * Value for {@link #flags}: {@code true} if the application asks that only 329 * full-data streaming backups of its data be performed even though it defines 330 * a {@link android.app.backup.BackupAgent BackupAgent}, which normally 331 * indicates that the app will manage its backed-up data via incremental 332 * key/value updates. 333 */ 334 public static final int FLAG_FULL_BACKUP_ONLY = 1<<26; 335 336 /** 337 * Value for {@link #flags}: {@code true} if the application may use cleartext network traffic 338 * (e.g., HTTP rather than HTTPS; WebSockets rather than WebSockets Secure; XMPP, IMAP, STMP 339 * without STARTTLS or TLS). If {@code false}, the app declares that it does not intend to use 340 * cleartext network traffic, in which case platform components (e.g., HTTP stacks, 341 * {@code WebView}, {@code MediaPlayer}) will refuse app's requests to use cleartext traffic. 342 * Third-party libraries are encouraged to honor this flag as well. 343 * 344 * @hide 345 */ 346 public static final int FLAG_USES_CLEARTEXT_TRAFFIC = 1<<27; 347 348 /** 349 * Value for {@link #flags}: true if code from this application will need to be 350 * loaded into other applications' processes. On devices that support multiple 351 * instruction sets, this implies the code might be loaded into a process that's 352 * using any of the devices supported instruction sets. 353 * 354 * <p> The system might treat such applications specially, for eg., by 355 * extracting the application's native libraries for all supported instruction 356 * sets or by compiling the application's dex code for all supported instruction 357 * sets. 358 */ 359 public static final int FLAG_MULTIARCH = 1 << 31; 360 361 /** 362 * Flags associated with the application. Any combination of 363 * {@link #FLAG_SYSTEM}, {@link #FLAG_DEBUGGABLE}, {@link #FLAG_HAS_CODE}, 364 * {@link #FLAG_PERSISTENT}, {@link #FLAG_FACTORY_TEST}, and 365 * {@link #FLAG_ALLOW_TASK_REPARENTING} 366 * {@link #FLAG_ALLOW_CLEAR_USER_DATA}, {@link #FLAG_UPDATED_SYSTEM_APP}, 367 * {@link #FLAG_TEST_ONLY}, {@link #FLAG_SUPPORTS_SMALL_SCREENS}, 368 * {@link #FLAG_SUPPORTS_NORMAL_SCREENS}, 369 * {@link #FLAG_SUPPORTS_LARGE_SCREENS}, {@link #FLAG_SUPPORTS_XLARGE_SCREENS}, 370 * {@link #FLAG_RESIZEABLE_FOR_SCREENS}, 371 * {@link #FLAG_SUPPORTS_SCREEN_DENSITIES}, {@link #FLAG_VM_SAFE_MODE}, 372 * {@link #FLAG_ALLOW_BACKUP}, {@link #FLAG_KILL_AFTER_RESTORE}, 373 * {@link #FLAG_RESTORE_ANY_VERSION}, {@link #FLAG_EXTERNAL_STORAGE}, 374 * {@link #FLAG_LARGE_HEAP}, {@link #FLAG_STOPPED}, 375 * {@link #FLAG_SUPPORTS_RTL}, {@link #FLAG_INSTALLED}, 376 * {@link #FLAG_IS_DATA_ONLY}, {@link #FLAG_IS_GAME}, 377 * {@link #FLAG_FULL_BACKUP_ONLY}, {@link #FLAG_MULTIARCH}. 378 */ 379 public int flags = 0; 380 381 /** 382 * Value for {@link #privateFlags}: true if the application is hidden via restrictions and for 383 * most purposes is considered as not installed. 384 * {@hide} 385 */ 386 public static final int PRIVATE_FLAG_HIDDEN = 1<<0; 387 388 /** 389 * Value for {@link #privateFlags}: set to <code>true</code> if the application 390 * has reported that it is heavy-weight, and thus can not participate in 391 * the normal application lifecycle. 392 * 393 * <p>Comes from the 394 * android.R.styleable#AndroidManifestApplication_cantSaveState 395 * attribute of the <application> tag. 396 * 397 * {@hide} 398 */ 399 public static final int PRIVATE_FLAG_CANT_SAVE_STATE = 1<<1; 400 401 /** 402 * Value for {@link #privateFlags}: Set to true if the application has been 403 * installed using the forward lock option. 404 * 405 * NOTE: DO NOT CHANGE THIS VALUE! It is saved in packages.xml. 406 * 407 * {@hide} 408 */ 409 public static final int PRIVATE_FLAG_FORWARD_LOCK = 1<<2; 410 411 /** 412 * Value for {@link #privateFlags}: set to {@code true} if the application 413 * is permitted to hold privileged permissions. 414 * 415 * {@hide} 416 */ 417 public static final int PRIVATE_FLAG_PRIVILEGED = 1<<3; 418 419 /** 420 * Private/hidden flags. See {@code PRIVATE_FLAG_...} constants. 421 * {@hide} 422 */ 423 public int privateFlags; 424 425 /** 426 * The required smallest screen width the application can run on. If 0, 427 * nothing has been specified. Comes from 428 * {@link android.R.styleable#AndroidManifestSupportsScreens_requiresSmallestWidthDp 429 * android:requiresSmallestWidthDp} attribute of the <supports-screens> tag. 430 */ 431 public int requiresSmallestWidthDp = 0; 432 433 /** 434 * The maximum smallest screen width the application is designed for. If 0, 435 * nothing has been specified. Comes from 436 * {@link android.R.styleable#AndroidManifestSupportsScreens_compatibleWidthLimitDp 437 * android:compatibleWidthLimitDp} attribute of the <supports-screens> tag. 438 */ 439 public int compatibleWidthLimitDp = 0; 440 441 /** 442 * The maximum smallest screen width the application will work on. If 0, 443 * nothing has been specified. Comes from 444 * {@link android.R.styleable#AndroidManifestSupportsScreens_largestWidthLimitDp 445 * android:largestWidthLimitDp} attribute of the <supports-screens> tag. 446 */ 447 public int largestWidthLimitDp = 0; 448 449 /** {@hide} */ 450 public String scanSourceDir; 451 /** {@hide} */ 452 public String scanPublicSourceDir; 453 454 /** 455 * Full path to the base APK for this application. 456 */ 457 public String sourceDir; 458 459 /** 460 * Full path to the publicly available parts of {@link #sourceDir}, 461 * including resources and manifest. This may be different from 462 * {@link #sourceDir} if an application is forward locked. 463 */ 464 public String publicSourceDir; 465 466 /** 467 * Full paths to zero or more split APKs that, when combined with the base 468 * APK defined in {@link #sourceDir}, form a complete application. 469 */ 470 public String[] splitSourceDirs; 471 472 /** 473 * Full path to the publicly available parts of {@link #splitSourceDirs}, 474 * including resources and manifest. This may be different from 475 * {@link #splitSourceDirs} if an application is forward locked. 476 */ 477 public String[] splitPublicSourceDirs; 478 479 /** 480 * Full paths to the locations of extra resource packages this application 481 * uses. This field is only used if there are extra resource packages, 482 * otherwise it is null. 483 * 484 * {@hide} 485 */ 486 public String[] resourceDirs; 487 488 /** 489 * String retrieved from the seinfo tag found in selinux policy. This value 490 * is useful in setting an SELinux security context on the process as well 491 * as its data directory. 492 * 493 * {@hide} 494 */ 495 public String seinfo; 496 497 /** 498 * Paths to all shared libraries this application is linked against. This 499 * field is only set if the {@link PackageManager#GET_SHARED_LIBRARY_FILES 500 * PackageManager.GET_SHARED_LIBRARY_FILES} flag was used when retrieving 501 * the structure. 502 */ 503 public String[] sharedLibraryFiles; 504 505 /** 506 * Full path to a directory assigned to the package for its persistent 507 * data. 508 */ 509 public String dataDir; 510 511 /** 512 * Full path to the directory where native JNI libraries are stored. 513 */ 514 public String nativeLibraryDir; 515 516 /** 517 * Full path where unpacked native libraries for {@link #secondaryCpuAbi} 518 * are stored, if present. 519 * 520 * The main reason this exists is for bundled multi-arch apps, where 521 * it's not trivial to calculate the location of libs for the secondary abi 522 * given the location of the primary. 523 * 524 * TODO: Change the layout of bundled installs so that we can use 525 * nativeLibraryRootDir & nativeLibraryRootRequiresIsa there as well. 526 * (e.g {@code [ "/system/app-lib/Foo/arm", "/system/app-lib/Foo/arm64" ]} 527 * instead of {@code [ "/system/lib/Foo", "/system/lib64/Foo" ]}. 528 * 529 * @hide 530 */ 531 public String secondaryNativeLibraryDir; 532 533 /** 534 * The root path where unpacked native libraries are stored. 535 * <p> 536 * When {@link #nativeLibraryRootRequiresIsa} is set, the libraries are 537 * placed in ISA-specific subdirectories under this path, otherwise the 538 * libraries are placed directly at this path. 539 * 540 * @hide 541 */ 542 public String nativeLibraryRootDir; 543 544 /** 545 * Flag indicating that ISA must be appended to 546 * {@link #nativeLibraryRootDir} to be useful. 547 * 548 * @hide 549 */ 550 public boolean nativeLibraryRootRequiresIsa; 551 552 /** 553 * The primary ABI that this application requires, This is inferred from the ABIs 554 * of the native JNI libraries the application bundles. Will be {@code null} 555 * if this application does not require any particular ABI. 556 * 557 * If non-null, the application will always be launched with this ABI. 558 * 559 * {@hide} 560 */ 561 public String primaryCpuAbi; 562 563 /** 564 * The secondary ABI for this application. Might be non-null for multi-arch 565 * installs. The application itself never uses this ABI, but other applications that 566 * use its code might. 567 * 568 * {@hide} 569 */ 570 public String secondaryCpuAbi; 571 572 /** 573 * The kernel user-ID that has been assigned to this application; 574 * currently this is not a unique ID (multiple applications can have 575 * the same uid). 576 */ 577 public int uid; 578 579 /** 580 * The minimum SDK version this application targets. It may run on earlier 581 * versions, but it knows how to work with any new behavior added at this 582 * version. Will be {@link android.os.Build.VERSION_CODES#CUR_DEVELOPMENT} 583 * if this is a development build and the app is targeting that. You should 584 * compare that this number is >= the SDK version number at which your 585 * behavior was introduced. 586 */ 587 public int targetSdkVersion; 588 589 /** 590 * The app's declared version code. 591 * @hide 592 */ 593 public int versionCode; 594 595 /** 596 * When false, indicates that all components within this application are 597 * considered disabled, regardless of their individually set enabled status. 598 */ 599 public boolean enabled = true; 600 601 /** 602 * For convenient access to the current enabled setting of this app. 603 * @hide 604 */ 605 public int enabledSetting = PackageManager.COMPONENT_ENABLED_STATE_DEFAULT; 606 607 /** 608 * For convenient access to package's install location. 609 * @hide 610 */ 611 public int installLocation = PackageInfo.INSTALL_LOCATION_UNSPECIFIED; 612 613 public void dump(Printer pw, String prefix) { 614 super.dumpFront(pw, prefix); 615 if (className != null) { 616 pw.println(prefix + "className=" + className); 617 } 618 if (permission != null) { 619 pw.println(prefix + "permission=" + permission); 620 } 621 pw.println(prefix + "processName=" + processName); 622 pw.println(prefix + "taskAffinity=" + taskAffinity); 623 pw.println(prefix + "uid=" + uid + " flags=0x" + Integer.toHexString(flags) 624 + " privateFlags=0x" + Integer.toHexString(privateFlags) 625 + " theme=0x" + Integer.toHexString(theme)); 626 pw.println(prefix + "requiresSmallestWidthDp=" + requiresSmallestWidthDp 627 + " compatibleWidthLimitDp=" + compatibleWidthLimitDp 628 + " largestWidthLimitDp=" + largestWidthLimitDp); 629 pw.println(prefix + "sourceDir=" + sourceDir); 630 if (!Objects.equals(sourceDir, publicSourceDir)) { 631 pw.println(prefix + "publicSourceDir=" + publicSourceDir); 632 } 633 if (!ArrayUtils.isEmpty(splitSourceDirs)) { 634 pw.println(prefix + "splitSourceDirs=" + Arrays.toString(splitSourceDirs)); 635 } 636 if (!ArrayUtils.isEmpty(splitPublicSourceDirs) 637 && !Arrays.equals(splitSourceDirs, splitPublicSourceDirs)) { 638 pw.println(prefix + "splitPublicSourceDirs=" + Arrays.toString(splitPublicSourceDirs)); 639 } 640 if (resourceDirs != null) { 641 pw.println(prefix + "resourceDirs=" + resourceDirs); 642 } 643 if (seinfo != null) { 644 pw.println(prefix + "seinfo=" + seinfo); 645 } 646 pw.println(prefix + "dataDir=" + dataDir); 647 if (sharedLibraryFiles != null) { 648 pw.println(prefix + "sharedLibraryFiles=" + sharedLibraryFiles); 649 } 650 pw.println(prefix + "enabled=" + enabled + " targetSdkVersion=" + targetSdkVersion 651 + " versionCode=" + versionCode); 652 if (manageSpaceActivityName != null) { 653 pw.println(prefix + "manageSpaceActivityName="+manageSpaceActivityName); 654 } 655 if (descriptionRes != 0) { 656 pw.println(prefix + "description=0x"+Integer.toHexString(descriptionRes)); 657 } 658 if (uiOptions != 0) { 659 pw.println(prefix + "uiOptions=0x" + Integer.toHexString(uiOptions)); 660 } 661 pw.println(prefix + "supportsRtl=" + (hasRtlSupport() ? "true" : "false")); 662 super.dumpBack(pw, prefix); 663 } 664 665 /** 666 * @return true if "supportsRtl" has been set to true in the AndroidManifest 667 * @hide 668 */ 669 public boolean hasRtlSupport() { 670 return (flags & FLAG_SUPPORTS_RTL) == FLAG_SUPPORTS_RTL; 671 } 672 673 public static class DisplayNameComparator 674 implements Comparator<ApplicationInfo> { 675 public DisplayNameComparator(PackageManager pm) { 676 mPM = pm; 677 } 678 679 public final int compare(ApplicationInfo aa, ApplicationInfo ab) { 680 CharSequence sa = mPM.getApplicationLabel(aa); 681 if (sa == null) { 682 sa = aa.packageName; 683 } 684 CharSequence sb = mPM.getApplicationLabel(ab); 685 if (sb == null) { 686 sb = ab.packageName; 687 } 688 689 return sCollator.compare(sa.toString(), sb.toString()); 690 } 691 692 private final Collator sCollator = Collator.getInstance(); 693 private PackageManager mPM; 694 } 695 696 public ApplicationInfo() { 697 } 698 699 public ApplicationInfo(ApplicationInfo orig) { 700 super(orig); 701 taskAffinity = orig.taskAffinity; 702 permission = orig.permission; 703 processName = orig.processName; 704 className = orig.className; 705 theme = orig.theme; 706 flags = orig.flags; 707 privateFlags = orig.privateFlags; 708 requiresSmallestWidthDp = orig.requiresSmallestWidthDp; 709 compatibleWidthLimitDp = orig.compatibleWidthLimitDp; 710 largestWidthLimitDp = orig.largestWidthLimitDp; 711 scanSourceDir = orig.scanSourceDir; 712 scanPublicSourceDir = orig.scanPublicSourceDir; 713 sourceDir = orig.sourceDir; 714 publicSourceDir = orig.publicSourceDir; 715 splitSourceDirs = orig.splitSourceDirs; 716 splitPublicSourceDirs = orig.splitPublicSourceDirs; 717 nativeLibraryDir = orig.nativeLibraryDir; 718 secondaryNativeLibraryDir = orig.secondaryNativeLibraryDir; 719 nativeLibraryRootDir = orig.nativeLibraryRootDir; 720 nativeLibraryRootRequiresIsa = orig.nativeLibraryRootRequiresIsa; 721 primaryCpuAbi = orig.primaryCpuAbi; 722 secondaryCpuAbi = orig.secondaryCpuAbi; 723 resourceDirs = orig.resourceDirs; 724 seinfo = orig.seinfo; 725 sharedLibraryFiles = orig.sharedLibraryFiles; 726 dataDir = orig.dataDir; 727 uid = orig.uid; 728 targetSdkVersion = orig.targetSdkVersion; 729 versionCode = orig.versionCode; 730 enabled = orig.enabled; 731 enabledSetting = orig.enabledSetting; 732 installLocation = orig.installLocation; 733 manageSpaceActivityName = orig.manageSpaceActivityName; 734 descriptionRes = orig.descriptionRes; 735 uiOptions = orig.uiOptions; 736 backupAgentName = orig.backupAgentName; 737 } 738 739 740 public String toString() { 741 return "ApplicationInfo{" 742 + Integer.toHexString(System.identityHashCode(this)) 743 + " " + packageName + "}"; 744 } 745 746 public int describeContents() { 747 return 0; 748 } 749 750 public void writeToParcel(Parcel dest, int parcelableFlags) { 751 super.writeToParcel(dest, parcelableFlags); 752 dest.writeString(taskAffinity); 753 dest.writeString(permission); 754 dest.writeString(processName); 755 dest.writeString(className); 756 dest.writeInt(theme); 757 dest.writeInt(flags); 758 dest.writeInt(privateFlags); 759 dest.writeInt(requiresSmallestWidthDp); 760 dest.writeInt(compatibleWidthLimitDp); 761 dest.writeInt(largestWidthLimitDp); 762 dest.writeString(scanSourceDir); 763 dest.writeString(scanPublicSourceDir); 764 dest.writeString(sourceDir); 765 dest.writeString(publicSourceDir); 766 dest.writeStringArray(splitSourceDirs); 767 dest.writeStringArray(splitPublicSourceDirs); 768 dest.writeString(nativeLibraryDir); 769 dest.writeString(secondaryNativeLibraryDir); 770 dest.writeString(nativeLibraryRootDir); 771 dest.writeInt(nativeLibraryRootRequiresIsa ? 1 : 0); 772 dest.writeString(primaryCpuAbi); 773 dest.writeString(secondaryCpuAbi); 774 dest.writeStringArray(resourceDirs); 775 dest.writeString(seinfo); 776 dest.writeStringArray(sharedLibraryFiles); 777 dest.writeString(dataDir); 778 dest.writeInt(uid); 779 dest.writeInt(targetSdkVersion); 780 dest.writeInt(versionCode); 781 dest.writeInt(enabled ? 1 : 0); 782 dest.writeInt(enabledSetting); 783 dest.writeInt(installLocation); 784 dest.writeString(manageSpaceActivityName); 785 dest.writeString(backupAgentName); 786 dest.writeInt(descriptionRes); 787 dest.writeInt(uiOptions); 788 } 789 790 public static final Parcelable.Creator<ApplicationInfo> CREATOR 791 = new Parcelable.Creator<ApplicationInfo>() { 792 public ApplicationInfo createFromParcel(Parcel source) { 793 return new ApplicationInfo(source); 794 } 795 public ApplicationInfo[] newArray(int size) { 796 return new ApplicationInfo[size]; 797 } 798 }; 799 800 private ApplicationInfo(Parcel source) { 801 super(source); 802 taskAffinity = source.readString(); 803 permission = source.readString(); 804 processName = source.readString(); 805 className = source.readString(); 806 theme = source.readInt(); 807 flags = source.readInt(); 808 privateFlags = source.readInt(); 809 requiresSmallestWidthDp = source.readInt(); 810 compatibleWidthLimitDp = source.readInt(); 811 largestWidthLimitDp = source.readInt(); 812 scanSourceDir = source.readString(); 813 scanPublicSourceDir = source.readString(); 814 sourceDir = source.readString(); 815 publicSourceDir = source.readString(); 816 splitSourceDirs = source.readStringArray(); 817 splitPublicSourceDirs = source.readStringArray(); 818 nativeLibraryDir = source.readString(); 819 secondaryNativeLibraryDir = source.readString(); 820 nativeLibraryRootDir = source.readString(); 821 nativeLibraryRootRequiresIsa = source.readInt() != 0; 822 primaryCpuAbi = source.readString(); 823 secondaryCpuAbi = source.readString(); 824 resourceDirs = source.readStringArray(); 825 seinfo = source.readString(); 826 sharedLibraryFiles = source.readStringArray(); 827 dataDir = source.readString(); 828 uid = source.readInt(); 829 targetSdkVersion = source.readInt(); 830 versionCode = source.readInt(); 831 enabled = source.readInt() != 0; 832 enabledSetting = source.readInt(); 833 installLocation = source.readInt(); 834 manageSpaceActivityName = source.readString(); 835 backupAgentName = source.readString(); 836 descriptionRes = source.readInt(); 837 uiOptions = source.readInt(); 838 } 839 840 /** 841 * Retrieve the textual description of the application. This 842 * will call back on the given PackageManager to load the description from 843 * the application. 844 * 845 * @param pm A PackageManager from which the label can be loaded; usually 846 * the PackageManager from which you originally retrieved this item. 847 * 848 * @return Returns a CharSequence containing the application's description. 849 * If there is no description, null is returned. 850 */ 851 public CharSequence loadDescription(PackageManager pm) { 852 if (descriptionRes != 0) { 853 CharSequence label = pm.getText(packageName, descriptionRes, this); 854 if (label != null) { 855 return label; 856 } 857 } 858 return null; 859 } 860 861 /** 862 * Disable compatibility mode 863 * 864 * @hide 865 */ 866 public void disableCompatibilityMode() { 867 flags |= (FLAG_SUPPORTS_LARGE_SCREENS | FLAG_SUPPORTS_NORMAL_SCREENS | 868 FLAG_SUPPORTS_SMALL_SCREENS | FLAG_RESIZEABLE_FOR_SCREENS | 869 FLAG_SUPPORTS_SCREEN_DENSITIES | FLAG_SUPPORTS_XLARGE_SCREENS); 870 } 871 872 /** 873 * @hide 874 */ 875 @Override 876 public Drawable loadDefaultIcon(PackageManager pm) { 877 if ((flags & FLAG_EXTERNAL_STORAGE) != 0 878 && isPackageUnavailable(pm)) { 879 return Resources.getSystem().getDrawable( 880 com.android.internal.R.drawable.sym_app_on_sd_unavailable_icon); 881 } 882 return pm.getDefaultActivityIcon(); 883 } 884 885 private boolean isPackageUnavailable(PackageManager pm) { 886 try { 887 return pm.getPackageInfo(packageName, 0) == null; 888 } catch (NameNotFoundException ex) { 889 return true; 890 } 891 } 892 893 /** 894 * @hide 895 */ 896 public boolean isForwardLocked() { 897 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_FORWARD_LOCK) != 0; 898 } 899 900 /** 901 * @hide 902 */ 903 @Override protected ApplicationInfo getApplicationInfo() { 904 return this; 905 } 906 907 /** {@hide} */ public void setCodePath(String codePath) { scanSourceDir = codePath; } 908 /** {@hide} */ public void setBaseCodePath(String baseCodePath) { sourceDir = baseCodePath; } 909 /** {@hide} */ public void setSplitCodePaths(String[] splitCodePaths) { splitSourceDirs = splitCodePaths; } 910 /** {@hide} */ public void setResourcePath(String resourcePath) { scanPublicSourceDir = resourcePath; } 911 /** {@hide} */ public void setBaseResourcePath(String baseResourcePath) { publicSourceDir = baseResourcePath; } 912 /** {@hide} */ public void setSplitResourcePaths(String[] splitResourcePaths) { splitPublicSourceDirs = splitResourcePaths; } 913 914 /** {@hide} */ public String getCodePath() { return scanSourceDir; } 915 /** {@hide} */ public String getBaseCodePath() { return sourceDir; } 916 /** {@hide} */ public String[] getSplitCodePaths() { return splitSourceDirs; } 917 /** {@hide} */ public String getResourcePath() { return scanPublicSourceDir; } 918 /** {@hide} */ public String getBaseResourcePath() { return publicSourceDir; } 919 /** {@hide} */ public String[] getSplitResourcePaths() { return splitSourceDirs; } 920} 921