| /* |
| * Copyright (C) 2007 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package android.content.pm; |
| |
| import android.content.pm.PackageManager.NameNotFoundException; |
| import android.content.res.Resources; |
| import android.graphics.drawable.Drawable; |
| import android.os.Parcel; |
| import android.os.Parcelable; |
| import android.util.Printer; |
| |
| import java.text.Collator; |
| import java.util.Comparator; |
| |
| /** |
| * Information you can retrieve about a particular application. This |
| * corresponds to information collected from the AndroidManifest.xml's |
| * <application> tag. |
| */ |
| public class ApplicationInfo extends PackageItemInfo implements Parcelable { |
| |
| /** |
| * Default task affinity of all activities in this application. See |
| * {@link ActivityInfo#taskAffinity} for more information. This comes |
| * from the "taskAffinity" attribute. |
| */ |
| public String taskAffinity; |
| |
| /** |
| * Optional name of a permission required to be able to access this |
| * application's components. From the "permission" attribute. |
| */ |
| public String permission; |
| |
| /** |
| * The name of the process this application should run in. From the |
| * "process" attribute or, if not set, the same as |
| * <var>packageName</var>. |
| */ |
| public String processName; |
| |
| /** |
| * Class implementing the Application object. From the "class" |
| * attribute. |
| */ |
| public String className; |
| |
| /** |
| * A style resource identifier (in the package's resources) of the |
| * description of an application. From the "description" attribute |
| * or, if not set, 0. |
| */ |
| public int descriptionRes; |
| |
| /** |
| * A style resource identifier (in the package's resources) of the |
| * default visual theme of the application. From the "theme" attribute |
| * or, if not set, 0. |
| */ |
| public int theme; |
| |
| /** |
| * Class implementing the Application's manage space |
| * functionality. From the "manageSpaceActivity" |
| * attribute. This is an optional attribute and will be null if |
| * applications don't specify it in their manifest |
| */ |
| public String manageSpaceActivityName; |
| |
| /** |
| * Class implementing the Application's backup functionality. From |
| * the "backupAgent" attribute. This is an optional attribute and |
| * will be null if the application does not specify it in its manifest. |
| * |
| * <p>If android:allowBackup is set to false, this attribute is ignored. |
| */ |
| public String backupAgentName; |
| |
| /** |
| * Value for {@link #flags}: if set, this application is installed in the |
| * device's system image. |
| */ |
| public static final int FLAG_SYSTEM = 1<<0; |
| |
| /** |
| * Value for {@link #flags}: set to true if this application would like to |
| * allow debugging of its |
| * code, even when installed on a non-development system. Comes |
| * from {@link android.R.styleable#AndroidManifestApplication_debuggable |
| * android:debuggable} of the <application> tag. |
| */ |
| public static final int FLAG_DEBUGGABLE = 1<<1; |
| |
| /** |
| * Value for {@link #flags}: set to true if this application has code |
| * associated with it. Comes |
| * from {@link android.R.styleable#AndroidManifestApplication_hasCode |
| * android:hasCode} of the <application> tag. |
| */ |
| public static final int FLAG_HAS_CODE = 1<<2; |
| |
| /** |
| * Value for {@link #flags}: set to true if this application is persistent. |
| * Comes from {@link android.R.styleable#AndroidManifestApplication_persistent |
| * android:persistent} of the <application> tag. |
| */ |
| public static final int FLAG_PERSISTENT = 1<<3; |
| |
| /** |
| * Value for {@link #flags}: set to true if this application holds the |
| * {@link android.Manifest.permission#FACTORY_TEST} permission and the |
| * device is running in factory test mode. |
| */ |
| public static final int FLAG_FACTORY_TEST = 1<<4; |
| |
| /** |
| * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. |
| * Comes from {@link android.R.styleable#AndroidManifestApplication_allowTaskReparenting |
| * android:allowTaskReparenting} of the <application> tag. |
| */ |
| public static final int FLAG_ALLOW_TASK_REPARENTING = 1<<5; |
| |
| /** |
| * Value for {@link #flags}: default value for the corresponding ActivityInfo flag. |
| * Comes from {@link android.R.styleable#AndroidManifestApplication_allowClearUserData |
| * android:allowClearUserData} of the <application> tag. |
| */ |
| public static final int FLAG_ALLOW_CLEAR_USER_DATA = 1<<6; |
| |
| /** |
| * Value for {@link #flags}: this is set if this application has been |
| * install as an update to a built-in system application. |
| */ |
| public static final int FLAG_UPDATED_SYSTEM_APP = 1<<7; |
| |
| /** |
| * Value for {@link #flags}: this is set of the application has specified |
| * {@link android.R.styleable#AndroidManifestApplication_testOnly |
| * android:testOnly} to be true. |
| */ |
| public static final int FLAG_TEST_ONLY = 1<<8; |
| |
| /** |
| * Value for {@link #flags}: true when the application's window can be |
| * reduced in size for smaller screens. Corresponds to |
| * {@link android.R.styleable#AndroidManifestSupportsScreens_smallScreens |
| * android:smallScreens}. |
| */ |
| public static final int FLAG_SUPPORTS_SMALL_SCREENS = 1<<9; |
| |
| /** |
| * Value for {@link #flags}: true when the application's window can be |
| * displayed on normal screens. Corresponds to |
| * {@link android.R.styleable#AndroidManifestSupportsScreens_normalScreens |
| * android:normalScreens}. |
| */ |
| public static final int FLAG_SUPPORTS_NORMAL_SCREENS = 1<<10; |
| |
| /** |
| * Value for {@link #flags}: true when the application's window can be |
| * increased in size for larger screens. Corresponds to |
| * {@link android.R.styleable#AndroidManifestSupportsScreens_largeScreens |
| * android:largeScreens}. |
| */ |
| public static final int FLAG_SUPPORTS_LARGE_SCREENS = 1<<11; |
| |
| /** |
| * Value for {@link #flags}: true when the application knows how to adjust |
| * its UI for different screen sizes. Corresponds to |
| * {@link android.R.styleable#AndroidManifestSupportsScreens_resizeable |
| * android:resizeable}. |
| */ |
| public static final int FLAG_RESIZEABLE_FOR_SCREENS = 1<<12; |
| |
| /** |
| * Value for {@link #flags}: true when the application knows how to |
| * accomodate different screen densities. Corresponds to |
| * {@link android.R.styleable#AndroidManifestSupportsScreens_anyDensity |
| * android:anyDensity}. |
| */ |
| public static final int FLAG_SUPPORTS_SCREEN_DENSITIES = 1<<13; |
| |
| /** |
| * Value for {@link #flags}: set to true if this application would like to |
| * request the VM to operate under the safe mode. Comes from |
| * {@link android.R.styleable#AndroidManifestApplication_vmSafeMode |
| * android:vmSafeMode} of the <application> tag. |
| */ |
| public static final int FLAG_VM_SAFE_MODE = 1<<14; |
| |
| /** |
| * Value for {@link #flags}: set to <code>false</code> if the application does not wish |
| * to permit any OS-driven backups of its data; <code>true</code> otherwise. |
| * |
| * <p>Comes from the |
| * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} |
| * attribute of the <application> tag. |
| */ |
| public static final int FLAG_ALLOW_BACKUP = 1<<15; |
| |
| /** |
| * Value for {@link #flags}: set to <code>false</code> if the application must be kept |
| * in memory following a full-system restore operation; <code>true</code> otherwise. |
| * Ordinarily, during a full system restore operation each application is shut down |
| * following execution of its agent's onRestore() method. Setting this attribute to |
| * <code>false</code> prevents this. Most applications will not need to set this attribute. |
| * |
| * <p>If |
| * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} |
| * is set to <code>false</code> or no |
| * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent} |
| * is specified, this flag will be ignored. |
| * |
| * <p>Comes from the |
| * {@link android.R.styleable#AndroidManifestApplication_killAfterRestore android:killAfterRestore} |
| * attribute of the <application> tag. |
| */ |
| public static final int FLAG_KILL_AFTER_RESTORE = 1<<16; |
| |
| /** |
| * Value for {@link #flags}: Set to <code>true</code> if the application's backup |
| * agent claims to be able to handle restore data even "from the future," |
| * i.e. from versions of the application with a versionCode greater than |
| * the one currently installed on the device. <i>Use with caution!</i> By default |
| * this attribute is <code>false</code> and the Backup Manager will ensure that data |
| * from "future" versions of the application are never supplied during a restore operation. |
| * |
| * <p>If |
| * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup} |
| * is set to <code>false</code> or no |
| * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent} |
| * is specified, this flag will be ignored. |
| * |
| * <p>Comes from the |
| * {@link android.R.styleable#AndroidManifestApplication_restoreAnyVersion android:restoreAnyVersion} |
| * attribute of the <application> tag. |
| */ |
| public static final int FLAG_RESTORE_ANY_VERSION = 1<<17; |
| |
| /** |
| * Value for {@link #flags}: Set to true if the application is |
| * currently installed on external/removable/unprotected storage. Such |
| * applications may not be available if their storage is not currently |
| * mounted. When the storage it is on is not available, it will look like |
| * the application has been uninstalled (its .apk is no longer available) |
| * but its persistent data is not removed. |
| */ |
| public static final int FLAG_EXTERNAL_STORAGE = 1<<18; |
| |
| /** |
| * Value for {@link #flags}: true when the application's window can be |
| * increased in size for extra large screens. Corresponds to |
| * {@link android.R.styleable#AndroidManifestSupportsScreens_xlargeScreens |
| * android:xlargeScreens}. |
| */ |
| public static final int FLAG_SUPPORTS_XLARGE_SCREENS = 1<<19; |
| |
| /** |
| * Value for {@link #flags}: true when the application has requested a |
| * large heap for its processes. Corresponds to |
| * {@link android.R.styleable#AndroidManifestApplication_largeHeap |
| * android:largeHeap}. |
| */ |
| public static final int FLAG_LARGE_HEAP = 1<<20; |
| |
| /** |
| * Value for {@link #flags}: true if this application's package is in |
| * the stopped state. |
| */ |
| public static final int FLAG_STOPPED = 1<<21; |
| |
| /** |
| * Value for {@link #flags}: Set to true if the application has been |
| * installed using the forward lock option. |
| * |
| * NOTE: DO NOT CHANGE THIS VALUE! It is saved in packages.xml. |
| * |
| * {@hide} |
| */ |
| public static final int FLAG_FORWARD_LOCK = 1<<29; |
| |
| /** |
| * Value for {@link #flags}: set to <code>true</code> if the application |
| * has reported that it is heavy-weight, and thus can not participate in |
| * the normal application lifecycle. |
| * |
| * <p>Comes from the |
| * {@link android.R.styleable#AndroidManifestApplication_cantSaveState android:cantSaveState} |
| * attribute of the <application> tag. |
| * |
| * {@hide} |
| */ |
| public static final int FLAG_CANT_SAVE_STATE = 1<<28; |
| |
| /** |
| * Flags associated with the application. Any combination of |
| * {@link #FLAG_SYSTEM}, {@link #FLAG_DEBUGGABLE}, {@link #FLAG_HAS_CODE}, |
| * {@link #FLAG_PERSISTENT}, {@link #FLAG_FACTORY_TEST}, and |
| * {@link #FLAG_ALLOW_TASK_REPARENTING} |
| * {@link #FLAG_ALLOW_CLEAR_USER_DATA}, {@link #FLAG_UPDATED_SYSTEM_APP}, |
| * {@link #FLAG_TEST_ONLY}, {@link #FLAG_SUPPORTS_SMALL_SCREENS}, |
| * {@link #FLAG_SUPPORTS_NORMAL_SCREENS}, |
| * {@link #FLAG_SUPPORTS_LARGE_SCREENS}, {@link #FLAG_SUPPORTS_XLARGE_SCREENS}, |
| * {@link #FLAG_RESIZEABLE_FOR_SCREENS}, |
| * {@link #FLAG_SUPPORTS_SCREEN_DENSITIES}, {@link #FLAG_VM_SAFE_MODE} |
| */ |
| public int flags = 0; |
| |
| /** |
| * Full path to the location of this package. |
| */ |
| public String sourceDir; |
| |
| /** |
| * Full path to the location of the publicly available parts of this |
| * package (i.e. the primary resource package and manifest). For |
| * non-forward-locked apps this will be the same as {@link #sourceDir). |
| */ |
| public String publicSourceDir; |
| |
| /** |
| * Full paths to the locations of extra resource packages this application |
| * uses. This field is only used if there are extra resource packages, |
| * otherwise it is null. |
| * |
| * {@hide} |
| */ |
| public String[] resourceDirs; |
| |
| /** |
| * Paths to all shared libraries this application is linked against. This |
| * field is only set if the {@link PackageManager#GET_SHARED_LIBRARY_FILES |
| * PackageManager.GET_SHARED_LIBRARY_FILES} flag was used when retrieving |
| * the structure. |
| */ |
| public String[] sharedLibraryFiles; |
| |
| /** |
| * Full path to a directory assigned to the package for its persistent |
| * data. |
| */ |
| public String dataDir; |
| |
| /** |
| * Full path to the directory where native JNI libraries are stored. |
| */ |
| public String nativeLibraryDir; |
| |
| /** |
| * The kernel user-ID that has been assigned to this application; |
| * currently this is not a unique ID (multiple applications can have |
| * the same uid). |
| */ |
| public int uid; |
| |
| /** |
| * The minimum SDK version this application targets. It may run on earlier |
| * versions, but it knows how to work with any new behavior added at this |
| * version. Will be {@link android.os.Build.VERSION_CODES#CUR_DEVELOPMENT} |
| * if this is a development build and the app is targeting that. You should |
| * compare that this number is >= the SDK version number at which your |
| * behavior was introduced. |
| */ |
| public int targetSdkVersion; |
| |
| /** |
| * When false, indicates that all components within this application are |
| * considered disabled, regardless of their individually set enabled status. |
| */ |
| public boolean enabled = true; |
| |
| /** |
| * For convenient access to package's install location. |
| * @hide |
| */ |
| public int installLocation = PackageInfo.INSTALL_LOCATION_UNSPECIFIED; |
| |
| public void dump(Printer pw, String prefix) { |
| super.dumpFront(pw, prefix); |
| if (className != null) { |
| pw.println(prefix + "className=" + className); |
| } |
| if (permission != null) { |
| pw.println(prefix + "permission=" + permission); |
| } |
| pw.println(prefix + "processName=" + processName); |
| pw.println(prefix + "taskAffinity=" + taskAffinity); |
| pw.println(prefix + "uid=" + uid + " flags=0x" + Integer.toHexString(flags) |
| + " theme=0x" + Integer.toHexString(theme)); |
| pw.println(prefix + "sourceDir=" + sourceDir); |
| if (sourceDir == null) { |
| if (publicSourceDir != null) { |
| pw.println(prefix + "publicSourceDir=" + publicSourceDir); |
| } |
| } else if (!sourceDir.equals(publicSourceDir)) { |
| pw.println(prefix + "publicSourceDir=" + publicSourceDir); |
| } |
| if (resourceDirs != null) { |
| pw.println(prefix + "resourceDirs=" + resourceDirs); |
| } |
| pw.println(prefix + "dataDir=" + dataDir); |
| if (sharedLibraryFiles != null) { |
| pw.println(prefix + "sharedLibraryFiles=" + sharedLibraryFiles); |
| } |
| pw.println(prefix + "enabled=" + enabled + " targetSdkVersion=" + targetSdkVersion); |
| if (manageSpaceActivityName != null) { |
| pw.println(prefix + "manageSpaceActivityName="+manageSpaceActivityName); |
| } |
| if (descriptionRes != 0) { |
| pw.println(prefix + "description=0x"+Integer.toHexString(descriptionRes)); |
| } |
| super.dumpBack(pw, prefix); |
| } |
| |
| public static class DisplayNameComparator |
| implements Comparator<ApplicationInfo> { |
| public DisplayNameComparator(PackageManager pm) { |
| mPM = pm; |
| } |
| |
| public final int compare(ApplicationInfo aa, ApplicationInfo ab) { |
| CharSequence sa = mPM.getApplicationLabel(aa); |
| if (sa == null) { |
| sa = aa.packageName; |
| } |
| CharSequence sb = mPM.getApplicationLabel(ab); |
| if (sb == null) { |
| sb = ab.packageName; |
| } |
| |
| return sCollator.compare(sa.toString(), sb.toString()); |
| } |
| |
| private final Collator sCollator = Collator.getInstance(); |
| private PackageManager mPM; |
| } |
| |
| public ApplicationInfo() { |
| } |
| |
| public ApplicationInfo(ApplicationInfo orig) { |
| super(orig); |
| taskAffinity = orig.taskAffinity; |
| permission = orig.permission; |
| processName = orig.processName; |
| className = orig.className; |
| theme = orig.theme; |
| flags = orig.flags; |
| sourceDir = orig.sourceDir; |
| publicSourceDir = orig.publicSourceDir; |
| nativeLibraryDir = orig.nativeLibraryDir; |
| resourceDirs = orig.resourceDirs; |
| sharedLibraryFiles = orig.sharedLibraryFiles; |
| dataDir = orig.dataDir; |
| uid = orig.uid; |
| targetSdkVersion = orig.targetSdkVersion; |
| enabled = orig.enabled; |
| installLocation = orig.installLocation; |
| manageSpaceActivityName = orig.manageSpaceActivityName; |
| descriptionRes = orig.descriptionRes; |
| } |
| |
| |
| public String toString() { |
| return "ApplicationInfo{" |
| + Integer.toHexString(System.identityHashCode(this)) |
| + " " + packageName + "}"; |
| } |
| |
| public int describeContents() { |
| return 0; |
| } |
| |
| public void writeToParcel(Parcel dest, int parcelableFlags) { |
| super.writeToParcel(dest, parcelableFlags); |
| dest.writeString(taskAffinity); |
| dest.writeString(permission); |
| dest.writeString(processName); |
| dest.writeString(className); |
| dest.writeInt(theme); |
| dest.writeInt(flags); |
| dest.writeString(sourceDir); |
| dest.writeString(publicSourceDir); |
| dest.writeString(nativeLibraryDir); |
| dest.writeStringArray(resourceDirs); |
| dest.writeStringArray(sharedLibraryFiles); |
| dest.writeString(dataDir); |
| dest.writeInt(uid); |
| dest.writeInt(targetSdkVersion); |
| dest.writeInt(enabled ? 1 : 0); |
| dest.writeInt(installLocation); |
| dest.writeString(manageSpaceActivityName); |
| dest.writeString(backupAgentName); |
| dest.writeInt(descriptionRes); |
| } |
| |
| public static final Parcelable.Creator<ApplicationInfo> CREATOR |
| = new Parcelable.Creator<ApplicationInfo>() { |
| public ApplicationInfo createFromParcel(Parcel source) { |
| return new ApplicationInfo(source); |
| } |
| public ApplicationInfo[] newArray(int size) { |
| return new ApplicationInfo[size]; |
| } |
| }; |
| |
| private ApplicationInfo(Parcel source) { |
| super(source); |
| taskAffinity = source.readString(); |
| permission = source.readString(); |
| processName = source.readString(); |
| className = source.readString(); |
| theme = source.readInt(); |
| flags = source.readInt(); |
| sourceDir = source.readString(); |
| publicSourceDir = source.readString(); |
| nativeLibraryDir = source.readString(); |
| resourceDirs = source.readStringArray(); |
| sharedLibraryFiles = source.readStringArray(); |
| dataDir = source.readString(); |
| uid = source.readInt(); |
| targetSdkVersion = source.readInt(); |
| enabled = source.readInt() != 0; |
| installLocation = source.readInt(); |
| manageSpaceActivityName = source.readString(); |
| backupAgentName = source.readString(); |
| descriptionRes = source.readInt(); |
| } |
| |
| /** |
| * Retrieve the textual description of the application. This |
| * will call back on the given PackageManager to load the description from |
| * the application. |
| * |
| * @param pm A PackageManager from which the label can be loaded; usually |
| * the PackageManager from which you originally retrieved this item. |
| * |
| * @return Returns a CharSequence containing the application's description. |
| * If there is no description, null is returned. |
| */ |
| public CharSequence loadDescription(PackageManager pm) { |
| if (descriptionRes != 0) { |
| CharSequence label = pm.getText(packageName, descriptionRes, this); |
| if (label != null) { |
| return label; |
| } |
| } |
| return null; |
| } |
| |
| /** |
| * Disable compatibility mode |
| * |
| * @hide |
| */ |
| public void disableCompatibilityMode() { |
| flags |= (FLAG_SUPPORTS_LARGE_SCREENS | FLAG_SUPPORTS_NORMAL_SCREENS | |
| FLAG_SUPPORTS_SMALL_SCREENS | FLAG_RESIZEABLE_FOR_SCREENS | |
| FLAG_SUPPORTS_SCREEN_DENSITIES | FLAG_SUPPORTS_XLARGE_SCREENS); |
| } |
| |
| /** |
| * @hide |
| */ |
| @Override protected Drawable loadDefaultIcon(PackageManager pm) { |
| if ((flags & FLAG_EXTERNAL_STORAGE) != 0 |
| && isPackageUnavailable(pm)) { |
| return Resources.getSystem().getDrawable( |
| com.android.internal.R.drawable.sym_app_on_sd_unavailable_icon); |
| } |
| return pm.getDefaultActivityIcon(); |
| } |
| |
| private boolean isPackageUnavailable(PackageManager pm) { |
| try { |
| return pm.getPackageInfo(packageName, 0) == null; |
| } catch (NameNotFoundException ex) { |
| return true; |
| } |
| } |
| |
| /** |
| * @hide |
| */ |
| @Override protected ApplicationInfo getApplicationInfo() { |
| return this; |
| } |
| } |
