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