/*
* 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 java.util.Comparator;
import android.content.res.Resources;
import android.graphics.drawable.Drawable;
import android.os.Parcelable;
import android.util.Printer;
/**
* 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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.R.styleable#AndroidManifestApplication_allowBackup
* android:allowBackup} is set to <code>false</code> or no
* {@link com.intel.jsdroid.sample.R.styleable#AndroidManifestApplication_backupAgent
* android:backupAgent} is specified, this flag will be ignored.
*
* <p>
* Comes from the
* {@link com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.R.styleable#AndroidManifestApplication_allowBackup
* android:allowBackup} is set to <code>false</code> or no
* {@link com.intel.jsdroid.sample.R.styleable#AndroidManifestApplication_backupAgent
* android:backupAgent} is specified, this flag will be ignored.
*
* <p>
* Comes from the
* {@link com.intel.jsdroid.sample.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 com.intel.jsdroid.sample.R.styleable#AndroidManifestSupportsScreens_xlargeScreens
* android:xlargeScreens}.
*
* @hide
*/
public static final int FLAG_SUPPORTS_XLARGE_SCREENS = 1 << 19;
/**
* Value for {@link #flags}: this is true if the application has set its
* android:neverEncrypt to true, false otherwise. It is used to specify that
* this package specifically "opts-out" of a secured file system solution,
* and will always store its data in-the-clear.
*
* {@hide}
*/
public static final int FLAG_NEVER_ENCRYPT = 1 << 30;
/**
* Value for {@link #flags}: Set to true if the application has been
* installed using the forward lock option.
*
* {@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 com.intel.jsdroid.sample.R.styleable#AndroidManifestApplication_cantSaveState
* android:cantSaveState} attribute of the <application> tag.
*
* {@hide}
*/
public static final int FLAG_CANT_SAVE_STATE = 1 << 27;
/**
* 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_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 0;
}
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;
}
/**
* 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) {
return pm.getPackageInfo(packageName, 0) == null;
}
/**
* @hide
*/
@Override
protected ApplicationInfo getApplicationInfo() {
return this;
}
}