ApplicationInfo.java revision d3d8a32217d5a2d895917cfe7e1645935d228494
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 public static final int FLAG_USES_CLEARTEXT_TRAFFIC = 1<<27; 345 346 /** 347 * When set installer extracts native libs from .apk files. 348 */ 349 public static final int FLAG_EXTRACT_NATIVE_LIBS = 1<<28; 350 351 /** 352 * Value for {@link #flags}: true if code from this application will need to be 353 * loaded into other applications' processes. On devices that support multiple 354 * instruction sets, this implies the code might be loaded into a process that's 355 * using any of the devices supported instruction sets. 356 * 357 * <p> The system might treat such applications specially, for eg., by 358 * extracting the application's native libraries for all supported instruction 359 * sets or by compiling the application's dex code for all supported instruction 360 * sets. 361 */ 362 public static final int FLAG_MULTIARCH = 1 << 31; 363 364 /** 365 * Flags associated with the application. Any combination of 366 * {@link #FLAG_SYSTEM}, {@link #FLAG_DEBUGGABLE}, {@link #FLAG_HAS_CODE}, 367 * {@link #FLAG_PERSISTENT}, {@link #FLAG_FACTORY_TEST}, and 368 * {@link #FLAG_ALLOW_TASK_REPARENTING} 369 * {@link #FLAG_ALLOW_CLEAR_USER_DATA}, {@link #FLAG_UPDATED_SYSTEM_APP}, 370 * {@link #FLAG_TEST_ONLY}, {@link #FLAG_SUPPORTS_SMALL_SCREENS}, 371 * {@link #FLAG_SUPPORTS_NORMAL_SCREENS}, 372 * {@link #FLAG_SUPPORTS_LARGE_SCREENS}, {@link #FLAG_SUPPORTS_XLARGE_SCREENS}, 373 * {@link #FLAG_RESIZEABLE_FOR_SCREENS}, 374 * {@link #FLAG_SUPPORTS_SCREEN_DENSITIES}, {@link #FLAG_VM_SAFE_MODE}, 375 * {@link #FLAG_ALLOW_BACKUP}, {@link #FLAG_KILL_AFTER_RESTORE}, 376 * {@link #FLAG_RESTORE_ANY_VERSION}, {@link #FLAG_EXTERNAL_STORAGE}, 377 * {@link #FLAG_LARGE_HEAP}, {@link #FLAG_STOPPED}, 378 * {@link #FLAG_SUPPORTS_RTL}, {@link #FLAG_INSTALLED}, 379 * {@link #FLAG_IS_DATA_ONLY}, {@link #FLAG_IS_GAME}, 380 * {@link #FLAG_FULL_BACKUP_ONLY}, {@link #FLAG_USES_CLEARTEXT_TRAFFIC}, 381 * {@link #FLAG_MULTIARCH}. 382 */ 383 public int flags = 0; 384 385 /** 386 * Value for {@link #privateFlags}: true if the application is hidden via restrictions and for 387 * most purposes is considered as not installed. 388 * {@hide} 389 */ 390 public static final int PRIVATE_FLAG_HIDDEN = 1<<0; 391 392 /** 393 * Value for {@link #privateFlags}: set to <code>true</code> if the application 394 * has reported that it is heavy-weight, and thus can not participate in 395 * the normal application lifecycle. 396 * 397 * <p>Comes from the 398 * android.R.styleable#AndroidManifestApplication_cantSaveState 399 * attribute of the <application> tag. 400 * 401 * {@hide} 402 */ 403 public static final int PRIVATE_FLAG_CANT_SAVE_STATE = 1<<1; 404 405 /** 406 * Value for {@link #privateFlags}: Set to true if the application has been 407 * installed using the forward lock option. 408 * 409 * NOTE: DO NOT CHANGE THIS VALUE! It is saved in packages.xml. 410 * 411 * {@hide} 412 */ 413 public static final int PRIVATE_FLAG_FORWARD_LOCK = 1<<2; 414 415 /** 416 * Value for {@link #privateFlags}: set to {@code true} if the application 417 * is permitted to hold privileged permissions. 418 * 419 * {@hide} 420 */ 421 public static final int PRIVATE_FLAG_PRIVILEGED = 1<<3; 422 423 /** 424 * Value for {@link #flags}: {@code true} if the application has any IntentFiler with some 425 * data URI using HTTP or HTTPS with an associated VIEW action. 426 * 427 * {@hide} 428 */ 429 public static final int PRIVATE_FLAG_HAS_DOMAIN_URLS = 1<<4; 430 431 /** 432 * Private/hidden flags. See {@code PRIVATE_FLAG_...} constants. 433 * {@hide} 434 */ 435 public int privateFlags; 436 437 /** 438 * The required smallest screen width the application can run on. If 0, 439 * nothing has been specified. Comes from 440 * {@link android.R.styleable#AndroidManifestSupportsScreens_requiresSmallestWidthDp 441 * android:requiresSmallestWidthDp} attribute of the <supports-screens> tag. 442 */ 443 public int requiresSmallestWidthDp = 0; 444 445 /** 446 * The maximum smallest screen width the application is designed for. If 0, 447 * nothing has been specified. Comes from 448 * {@link android.R.styleable#AndroidManifestSupportsScreens_compatibleWidthLimitDp 449 * android:compatibleWidthLimitDp} attribute of the <supports-screens> tag. 450 */ 451 public int compatibleWidthLimitDp = 0; 452 453 /** 454 * The maximum smallest screen width the application will work on. If 0, 455 * nothing has been specified. Comes from 456 * {@link android.R.styleable#AndroidManifestSupportsScreens_largestWidthLimitDp 457 * android:largestWidthLimitDp} attribute of the <supports-screens> tag. 458 */ 459 public int largestWidthLimitDp = 0; 460 461 /** {@hide} */ 462 public String scanSourceDir; 463 /** {@hide} */ 464 public String scanPublicSourceDir; 465 466 /** 467 * Full path to the base APK for this application. 468 */ 469 public String sourceDir; 470 471 /** 472 * Full path to the publicly available parts of {@link #sourceDir}, 473 * including resources and manifest. This may be different from 474 * {@link #sourceDir} if an application is forward locked. 475 */ 476 public String publicSourceDir; 477 478 /** 479 * Full paths to zero or more split APKs that, when combined with the base 480 * APK defined in {@link #sourceDir}, form a complete application. 481 */ 482 public String[] splitSourceDirs; 483 484 /** 485 * Full path to the publicly available parts of {@link #splitSourceDirs}, 486 * including resources and manifest. This may be different from 487 * {@link #splitSourceDirs} if an application is forward locked. 488 */ 489 public String[] splitPublicSourceDirs; 490 491 /** 492 * Full paths to the locations of extra resource packages this application 493 * uses. This field is only used if there are extra resource packages, 494 * otherwise it is null. 495 * 496 * {@hide} 497 */ 498 public String[] resourceDirs; 499 500 /** 501 * String retrieved from the seinfo tag found in selinux policy. This value 502 * is useful in setting an SELinux security context on the process as well 503 * as its data directory. 504 * 505 * {@hide} 506 */ 507 public String seinfo; 508 509 /** 510 * Paths to all shared libraries this application is linked against. This 511 * field is only set if the {@link PackageManager#GET_SHARED_LIBRARY_FILES 512 * PackageManager.GET_SHARED_LIBRARY_FILES} flag was used when retrieving 513 * the structure. 514 */ 515 public String[] sharedLibraryFiles; 516 517 /** 518 * Full path to a directory assigned to the package for its persistent 519 * data. 520 */ 521 public String dataDir; 522 523 /** 524 * Full path to the directory where native JNI libraries are stored. 525 */ 526 public String nativeLibraryDir; 527 528 /** 529 * Full path where unpacked native libraries for {@link #secondaryCpuAbi} 530 * are stored, if present. 531 * 532 * The main reason this exists is for bundled multi-arch apps, where 533 * it's not trivial to calculate the location of libs for the secondary abi 534 * given the location of the primary. 535 * 536 * TODO: Change the layout of bundled installs so that we can use 537 * nativeLibraryRootDir & nativeLibraryRootRequiresIsa there as well. 538 * (e.g {@code [ "/system/app-lib/Foo/arm", "/system/app-lib/Foo/arm64" ]} 539 * instead of {@code [ "/system/lib/Foo", "/system/lib64/Foo" ]}. 540 * 541 * @hide 542 */ 543 public String secondaryNativeLibraryDir; 544 545 /** 546 * The root path where unpacked native libraries are stored. 547 * <p> 548 * When {@link #nativeLibraryRootRequiresIsa} is set, the libraries are 549 * placed in ISA-specific subdirectories under this path, otherwise the 550 * libraries are placed directly at this path. 551 * 552 * @hide 553 */ 554 public String nativeLibraryRootDir; 555 556 /** 557 * Flag indicating that ISA must be appended to 558 * {@link #nativeLibraryRootDir} to be useful. 559 * 560 * @hide 561 */ 562 public boolean nativeLibraryRootRequiresIsa; 563 564 /** 565 * The primary ABI that this application requires, This is inferred from the ABIs 566 * of the native JNI libraries the application bundles. Will be {@code null} 567 * if this application does not require any particular ABI. 568 * 569 * If non-null, the application will always be launched with this ABI. 570 * 571 * {@hide} 572 */ 573 public String primaryCpuAbi; 574 575 /** 576 * The secondary ABI for this application. Might be non-null for multi-arch 577 * installs. The application itself never uses this ABI, but other applications that 578 * use its code might. 579 * 580 * {@hide} 581 */ 582 public String secondaryCpuAbi; 583 584 /** 585 * The kernel user-ID that has been assigned to this application; 586 * currently this is not a unique ID (multiple applications can have 587 * the same uid). 588 */ 589 public int uid; 590 591 /** 592 * The minimum SDK version this application targets. It may run on earlier 593 * versions, but it knows how to work with any new behavior added at this 594 * version. Will be {@link android.os.Build.VERSION_CODES#CUR_DEVELOPMENT} 595 * if this is a development build and the app is targeting that. You should 596 * compare that this number is >= the SDK version number at which your 597 * behavior was introduced. 598 */ 599 public int targetSdkVersion; 600 601 /** 602 * The app's declared version code. 603 * @hide 604 */ 605 public int versionCode; 606 607 /** 608 * When false, indicates that all components within this application are 609 * considered disabled, regardless of their individually set enabled status. 610 */ 611 public boolean enabled = true; 612 613 /** 614 * For convenient access to the current enabled setting of this app. 615 * @hide 616 */ 617 public int enabledSetting = PackageManager.COMPONENT_ENABLED_STATE_DEFAULT; 618 619 /** 620 * For convenient access to package's install location. 621 * @hide 622 */ 623 public int installLocation = PackageInfo.INSTALL_LOCATION_UNSPECIFIED; 624 625 /** 626 * True when the application's rendering should be hardware accelerated. 627 */ 628 public boolean hardwareAccelerated; 629 630 public void dump(Printer pw, String prefix) { 631 super.dumpFront(pw, prefix); 632 if (className != null) { 633 pw.println(prefix + "className=" + className); 634 } 635 if (permission != null) { 636 pw.println(prefix + "permission=" + permission); 637 } 638 pw.println(prefix + "processName=" + processName); 639 pw.println(prefix + "taskAffinity=" + taskAffinity); 640 pw.println(prefix + "uid=" + uid + " flags=0x" + Integer.toHexString(flags) 641 + " privateFlags=0x" + Integer.toHexString(privateFlags) 642 + " theme=0x" + Integer.toHexString(theme)); 643 pw.println(prefix + "requiresSmallestWidthDp=" + requiresSmallestWidthDp 644 + " compatibleWidthLimitDp=" + compatibleWidthLimitDp 645 + " largestWidthLimitDp=" + largestWidthLimitDp); 646 pw.println(prefix + "sourceDir=" + sourceDir); 647 if (!Objects.equals(sourceDir, publicSourceDir)) { 648 pw.println(prefix + "publicSourceDir=" + publicSourceDir); 649 } 650 if (!ArrayUtils.isEmpty(splitSourceDirs)) { 651 pw.println(prefix + "splitSourceDirs=" + Arrays.toString(splitSourceDirs)); 652 } 653 if (!ArrayUtils.isEmpty(splitPublicSourceDirs) 654 && !Arrays.equals(splitSourceDirs, splitPublicSourceDirs)) { 655 pw.println(prefix + "splitPublicSourceDirs=" + Arrays.toString(splitPublicSourceDirs)); 656 } 657 if (resourceDirs != null) { 658 pw.println(prefix + "resourceDirs=" + resourceDirs); 659 } 660 if (seinfo != null) { 661 pw.println(prefix + "seinfo=" + seinfo); 662 } 663 pw.println(prefix + "dataDir=" + dataDir); 664 if (sharedLibraryFiles != null) { 665 pw.println(prefix + "sharedLibraryFiles=" + Arrays.toString(sharedLibraryFiles)); 666 } 667 pw.println(prefix + "enabled=" + enabled + " targetSdkVersion=" + targetSdkVersion 668 + " versionCode=" + versionCode); 669 pw.println(prefix + "hardwareAccelerated=" + hardwareAccelerated); 670 if (manageSpaceActivityName != null) { 671 pw.println(prefix + "manageSpaceActivityName="+manageSpaceActivityName); 672 } 673 if (descriptionRes != 0) { 674 pw.println(prefix + "description=0x"+Integer.toHexString(descriptionRes)); 675 } 676 if (uiOptions != 0) { 677 pw.println(prefix + "uiOptions=0x" + Integer.toHexString(uiOptions)); 678 } 679 pw.println(prefix + "supportsRtl=" + (hasRtlSupport() ? "true" : "false")); 680 super.dumpBack(pw, prefix); 681 } 682 683 /** 684 * @return true if "supportsRtl" has been set to true in the AndroidManifest 685 * @hide 686 */ 687 public boolean hasRtlSupport() { 688 return (flags & FLAG_SUPPORTS_RTL) == FLAG_SUPPORTS_RTL; 689 } 690 691 public static class DisplayNameComparator 692 implements Comparator<ApplicationInfo> { 693 public DisplayNameComparator(PackageManager pm) { 694 mPM = pm; 695 } 696 697 public final int compare(ApplicationInfo aa, ApplicationInfo ab) { 698 CharSequence sa = mPM.getApplicationLabel(aa); 699 if (sa == null) { 700 sa = aa.packageName; 701 } 702 CharSequence sb = mPM.getApplicationLabel(ab); 703 if (sb == null) { 704 sb = ab.packageName; 705 } 706 707 return sCollator.compare(sa.toString(), sb.toString()); 708 } 709 710 private final Collator sCollator = Collator.getInstance(); 711 private PackageManager mPM; 712 } 713 714 public ApplicationInfo() { 715 } 716 717 public ApplicationInfo(ApplicationInfo orig) { 718 super(orig); 719 taskAffinity = orig.taskAffinity; 720 permission = orig.permission; 721 processName = orig.processName; 722 className = orig.className; 723 theme = orig.theme; 724 flags = orig.flags; 725 privateFlags = orig.privateFlags; 726 requiresSmallestWidthDp = orig.requiresSmallestWidthDp; 727 compatibleWidthLimitDp = orig.compatibleWidthLimitDp; 728 largestWidthLimitDp = orig.largestWidthLimitDp; 729 scanSourceDir = orig.scanSourceDir; 730 scanPublicSourceDir = orig.scanPublicSourceDir; 731 sourceDir = orig.sourceDir; 732 publicSourceDir = orig.publicSourceDir; 733 splitSourceDirs = orig.splitSourceDirs; 734 splitPublicSourceDirs = orig.splitPublicSourceDirs; 735 nativeLibraryDir = orig.nativeLibraryDir; 736 secondaryNativeLibraryDir = orig.secondaryNativeLibraryDir; 737 nativeLibraryRootDir = orig.nativeLibraryRootDir; 738 nativeLibraryRootRequiresIsa = orig.nativeLibraryRootRequiresIsa; 739 primaryCpuAbi = orig.primaryCpuAbi; 740 secondaryCpuAbi = orig.secondaryCpuAbi; 741 resourceDirs = orig.resourceDirs; 742 seinfo = orig.seinfo; 743 sharedLibraryFiles = orig.sharedLibraryFiles; 744 dataDir = orig.dataDir; 745 uid = orig.uid; 746 targetSdkVersion = orig.targetSdkVersion; 747 versionCode = orig.versionCode; 748 enabled = orig.enabled; 749 enabledSetting = orig.enabledSetting; 750 installLocation = orig.installLocation; 751 manageSpaceActivityName = orig.manageSpaceActivityName; 752 descriptionRes = orig.descriptionRes; 753 uiOptions = orig.uiOptions; 754 backupAgentName = orig.backupAgentName; 755 hardwareAccelerated = orig.hardwareAccelerated; 756 } 757 758 759 public String toString() { 760 return "ApplicationInfo{" 761 + Integer.toHexString(System.identityHashCode(this)) 762 + " " + packageName + "}"; 763 } 764 765 public int describeContents() { 766 return 0; 767 } 768 769 public void writeToParcel(Parcel dest, int parcelableFlags) { 770 super.writeToParcel(dest, parcelableFlags); 771 dest.writeString(taskAffinity); 772 dest.writeString(permission); 773 dest.writeString(processName); 774 dest.writeString(className); 775 dest.writeInt(theme); 776 dest.writeInt(flags); 777 dest.writeInt(privateFlags); 778 dest.writeInt(requiresSmallestWidthDp); 779 dest.writeInt(compatibleWidthLimitDp); 780 dest.writeInt(largestWidthLimitDp); 781 dest.writeString(scanSourceDir); 782 dest.writeString(scanPublicSourceDir); 783 dest.writeString(sourceDir); 784 dest.writeString(publicSourceDir); 785 dest.writeStringArray(splitSourceDirs); 786 dest.writeStringArray(splitPublicSourceDirs); 787 dest.writeString(nativeLibraryDir); 788 dest.writeString(secondaryNativeLibraryDir); 789 dest.writeString(nativeLibraryRootDir); 790 dest.writeInt(nativeLibraryRootRequiresIsa ? 1 : 0); 791 dest.writeString(primaryCpuAbi); 792 dest.writeString(secondaryCpuAbi); 793 dest.writeStringArray(resourceDirs); 794 dest.writeString(seinfo); 795 dest.writeStringArray(sharedLibraryFiles); 796 dest.writeString(dataDir); 797 dest.writeInt(uid); 798 dest.writeInt(targetSdkVersion); 799 dest.writeInt(versionCode); 800 dest.writeInt(enabled ? 1 : 0); 801 dest.writeInt(enabledSetting); 802 dest.writeInt(installLocation); 803 dest.writeString(manageSpaceActivityName); 804 dest.writeString(backupAgentName); 805 dest.writeInt(descriptionRes); 806 dest.writeInt(uiOptions); 807 dest.writeInt(hardwareAccelerated ? 1 : 0); 808 } 809 810 public static final Parcelable.Creator<ApplicationInfo> CREATOR 811 = new Parcelable.Creator<ApplicationInfo>() { 812 public ApplicationInfo createFromParcel(Parcel source) { 813 return new ApplicationInfo(source); 814 } 815 public ApplicationInfo[] newArray(int size) { 816 return new ApplicationInfo[size]; 817 } 818 }; 819 820 private ApplicationInfo(Parcel source) { 821 super(source); 822 taskAffinity = source.readString(); 823 permission = source.readString(); 824 processName = source.readString(); 825 className = source.readString(); 826 theme = source.readInt(); 827 flags = source.readInt(); 828 privateFlags = source.readInt(); 829 requiresSmallestWidthDp = source.readInt(); 830 compatibleWidthLimitDp = source.readInt(); 831 largestWidthLimitDp = source.readInt(); 832 scanSourceDir = source.readString(); 833 scanPublicSourceDir = source.readString(); 834 sourceDir = source.readString(); 835 publicSourceDir = source.readString(); 836 splitSourceDirs = source.readStringArray(); 837 splitPublicSourceDirs = source.readStringArray(); 838 nativeLibraryDir = source.readString(); 839 secondaryNativeLibraryDir = source.readString(); 840 nativeLibraryRootDir = source.readString(); 841 nativeLibraryRootRequiresIsa = source.readInt() != 0; 842 primaryCpuAbi = source.readString(); 843 secondaryCpuAbi = source.readString(); 844 resourceDirs = source.readStringArray(); 845 seinfo = source.readString(); 846 sharedLibraryFiles = source.readStringArray(); 847 dataDir = source.readString(); 848 uid = source.readInt(); 849 targetSdkVersion = source.readInt(); 850 versionCode = source.readInt(); 851 enabled = source.readInt() != 0; 852 enabledSetting = source.readInt(); 853 installLocation = source.readInt(); 854 manageSpaceActivityName = source.readString(); 855 backupAgentName = source.readString(); 856 descriptionRes = source.readInt(); 857 uiOptions = source.readInt(); 858 hardwareAccelerated = source.readInt() != 0; 859 } 860 861 /** 862 * Retrieve the textual description of the application. This 863 * will call back on the given PackageManager to load the description from 864 * the application. 865 * 866 * @param pm A PackageManager from which the label can be loaded; usually 867 * the PackageManager from which you originally retrieved this item. 868 * 869 * @return Returns a CharSequence containing the application's description. 870 * If there is no description, null is returned. 871 */ 872 public CharSequence loadDescription(PackageManager pm) { 873 if (descriptionRes != 0) { 874 CharSequence label = pm.getText(packageName, descriptionRes, this); 875 if (label != null) { 876 return label; 877 } 878 } 879 return null; 880 } 881 882 /** 883 * Disable compatibility mode 884 * 885 * @hide 886 */ 887 public void disableCompatibilityMode() { 888 flags |= (FLAG_SUPPORTS_LARGE_SCREENS | FLAG_SUPPORTS_NORMAL_SCREENS | 889 FLAG_SUPPORTS_SMALL_SCREENS | FLAG_RESIZEABLE_FOR_SCREENS | 890 FLAG_SUPPORTS_SCREEN_DENSITIES | FLAG_SUPPORTS_XLARGE_SCREENS); 891 } 892 893 /** 894 * @hide 895 */ 896 @Override 897 public Drawable loadDefaultIcon(PackageManager pm) { 898 if ((flags & FLAG_EXTERNAL_STORAGE) != 0 899 && isPackageUnavailable(pm)) { 900 return Resources.getSystem().getDrawable( 901 com.android.internal.R.drawable.sym_app_on_sd_unavailable_icon); 902 } 903 return pm.getDefaultActivityIcon(); 904 } 905 906 private boolean isPackageUnavailable(PackageManager pm) { 907 try { 908 return pm.getPackageInfo(packageName, 0) == null; 909 } catch (NameNotFoundException ex) { 910 return true; 911 } 912 } 913 914 /** 915 * @hide 916 */ 917 public boolean isForwardLocked() { 918 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_FORWARD_LOCK) != 0; 919 } 920 921 /** 922 * @hide 923 */ 924 @Override protected ApplicationInfo getApplicationInfo() { 925 return this; 926 } 927 928 /** {@hide} */ public void setCodePath(String codePath) { scanSourceDir = codePath; } 929 /** {@hide} */ public void setBaseCodePath(String baseCodePath) { sourceDir = baseCodePath; } 930 /** {@hide} */ public void setSplitCodePaths(String[] splitCodePaths) { splitSourceDirs = splitCodePaths; } 931 /** {@hide} */ public void setResourcePath(String resourcePath) { scanPublicSourceDir = resourcePath; } 932 /** {@hide} */ public void setBaseResourcePath(String baseResourcePath) { publicSourceDir = baseResourcePath; } 933 /** {@hide} */ public void setSplitResourcePaths(String[] splitResourcePaths) { splitPublicSourceDirs = splitResourcePaths; } 934 935 /** {@hide} */ public String getCodePath() { return scanSourceDir; } 936 /** {@hide} */ public String getBaseCodePath() { return sourceDir; } 937 /** {@hide} */ public String[] getSplitCodePaths() { return splitSourceDirs; } 938 /** {@hide} */ public String getResourcePath() { return scanPublicSourceDir; } 939 /** {@hide} */ public String getBaseResourcePath() { return publicSourceDir; } 940 /** {@hide} */ public String[] getSplitResourcePaths() { return splitSourceDirs; } 941} 942