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