cn.trinea.android.common.util

Class PackageUtils

java.lang.Object

cn.trinea.android.common.util.PackageUtils

public class PackageUtils
extends java.lang.Object

PackageUtils

Install package
• installNormal(Context, String)
• installSilent(Context, String)
• install(Context, String)

Uninstall package
• uninstallNormal(Context, String)
• uninstallSilent(Context, String)
• uninstall(Context, String)

Is system application
• isSystemApplication(Context)
• isSystemApplication(Context, String)
• isSystemApplication(PackageManager, String)

Others
• getInstallLocation() get system install location
• isTopActivity(Context, String) whether the app whost package's name is packageName is on the top of the stack
• startInstalledAppDetails(Context, String) start InstalledAppDetails Activity

Author:

Trinea 2013-5-15

Field Summary

Fields

Modifier and Type	Field and Description
static int	APP_INSTALL_AUTO App installation location settings values, same to #PackageHelper
static int	APP_INSTALL_EXTERNAL
static int	APP_INSTALL_INTERNAL
static int	DELETE_FAILED_DEVICE_POLICY_MANAGER Uninstall return code uninstall fail if the system failed to delete the package because it is the active DevicePolicy manager.
static int	DELETE_FAILED_INTERNAL_ERROR Uninstall return code uninstall fail if the system failed to delete the package for an unspecified reason.
static int	DELETE_FAILED_INVALID_PACKAGE Uninstall return code uninstall fail if pcakge name is invalid
static int	DELETE_FAILED_PERMISSION_DENIED Uninstall return code uninstall fail if permission denied
static int	DELETE_SUCCEEDED Uninstall return code uninstall success.
static int	INSTALL_FAILED_ALREADY_EXISTS Installation return code the package is already installed.
static int	INSTALL_FAILED_CONFLICTING_PROVIDER Installation return code the new package failed because it contains a content provider with the same authority as a provider already installed in the system.
static int	INSTALL_FAILED_CONTAINER_ERROR Installation return code a secure container mount point couldn't be accessed on external media.
static int	INSTALL_FAILED_CPU_ABI_INCOMPATIBLE Installation return code the package being installed contains native code, but none that is compatible with the the device's CPU_ABI.
static int	INSTALL_FAILED_DEXOPT Installation return code the new package failed while optimizing and validating its dex files, either because there was not enough storage or the validation failed.
static int	INSTALL_FAILED_DUPLICATE_PACKAGE Installation return code a package is already installed with the same name.
static int	INSTALL_FAILED_INSUFFICIENT_STORAGE Installation return code the package manager service found that the device didn't have enough storage space to install the app.
static int	INSTALL_FAILED_INTERNAL_ERROR Installation return code if the system failed to install the package because of system issues.
static int	INSTALL_FAILED_INVALID_APK Installation return code the package archive file is invalid.
static int	INSTALL_FAILED_INVALID_INSTALL_LOCATION Installation return code the new package couldn't be installed in the specified install location.
static int	INSTALL_FAILED_INVALID_URI Installation return code the URI passed in is invalid.
static int	INSTALL_FAILED_MEDIA_UNAVAILABLE Installation return code the new package couldn't be installed in the specified install location because the media is not available.
static int	INSTALL_FAILED_MISSING_FEATURE Installation return code the new package uses a feature that is not available.
static int	INSTALL_FAILED_MISSING_SHARED_LIBRARY Installation return code the new package uses a shared library that is not available.
static int	INSTALL_FAILED_NEWER_SDK Installation return code the new package failed because the current SDK version is newer than that required by the package.
static int	INSTALL_FAILED_NO_SHARED_USER Installation return code the requested shared user does not exist.
static int	INSTALL_FAILED_OLDER_SDK Installation return code the new package failed because the current SDK version is older than that required by the package.
static int	INSTALL_FAILED_OTHER Installation return code other reason
static int	INSTALL_FAILED_PACKAGE_CHANGED Installation return code the package changed from what the calling program expected.
static int	INSTALL_FAILED_REPLACE_COULDNT_DELETE Installation return code the new package uses a shared library that is not available.
static int	INSTALL_FAILED_SHARED_USER_INCOMPATIBLE Installation return code the new package is requested a shared user which is already installed on the device and does not have matching signature.
static int	INSTALL_FAILED_TEST_ONLY Installation return code the new package failed because it has specified that it is a test-only package and the caller has not supplied the #INSTALL_ALLOW_TEST flag.
static int	INSTALL_FAILED_UID_CHANGED Installation return code the new package is assigned a different UID than it previously held.
static int	INSTALL_FAILED_UPDATE_INCOMPATIBLE Installation return code a previously installed package of the same name has a different signature than the new package (and the old package's data was not removed).
static int	INSTALL_FAILED_VERIFICATION_FAILURE Installation return code the new package couldn't be installed because the verification did not succeed.
static int	INSTALL_FAILED_VERIFICATION_TIMEOUT Installation return code the new package couldn't be installed because the verification timed out.
static int	INSTALL_PARSE_FAILED_BAD_MANIFEST Installation return code if the parser was unable to retrieve the AndroidManifest.xml file.
static int	INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME Installation return code if the parser encountered a bad or missing package name in the manifest.
static int	INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID Installation return code if the parser encountered a bad shared user id name in the manifest.
static int	INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING Installation return code if the parser encountered a CertificateEncodingException in one of the files in the .apk.
static int	INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES Installation return code if the parser found inconsistent certificates on the files in the .apk.
static int	INSTALL_PARSE_FAILED_MANIFEST_EMPTY Installation return code if the parser did not find any actionable tags (instrumentation or application) in the manifest.
static int	INSTALL_PARSE_FAILED_MANIFEST_MALFORMED Installation return code if the parser encountered some structural problem in the manifest.
static int	INSTALL_PARSE_FAILED_NO_CERTIFICATES Installation return code if the parser did not find any certificates in the .apk.
static int	INSTALL_PARSE_FAILED_NOT_APK Installation return code if the parser was given a path that is not a file, or does not end with the expected '.apk' extension.
static int	INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION Installation return code if the parser encountered an unexpected exception.
static int	INSTALL_SUCCEEDED Installation return code install success.
static java.lang.String	TAG

Constructor Summary

Constructors

Constructor and Description
PackageUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static int	getAppVersionCode(Context context) get app version code
static int	getInstallLocation() get system install location can be set by System Menu Setting->Storage->Prefered install location
static int	install(Context context, java.lang.String filePath) install according conditions if system application or rooted, see installSilent(Context, String) else see installNormal(Context, String)
static boolean	installNormal(Context context, java.lang.String filePath) install package normal by system intent
static int	installSilent(Context context, java.lang.String filePath) install package silent by root Attentions: Don't call this on the ui thread, it may costs some times.
static int	installSilent(Context context, java.lang.String filePath, java.lang.String pmParams) install package silent by root Attentions: Don't call this on the ui thread, it may costs some times.
static boolean	isSystemApplication(Context context) whether context is system application
static boolean	isSystemApplication(Context context, java.lang.String packageName) whether packageName is system application
static boolean	isSystemApplication(PackageManager packageManager, java.lang.String packageName) whether packageName is system application
static java.lang.Boolean	isTopActivity(Context context, java.lang.String packageName) whether the app whost package's name is packageName is on the top of the stack Attentions: You should add android.permission.GET_TASKS in manifest
static void	startInstalledAppDetails(Context context, java.lang.String packageName) start InstalledAppDetails Activity
static int	uninstall(Context context, java.lang.String packageName) uninstall according conditions if system application or rooted, see uninstallSilent(Context, String) else see uninstallNormal(Context, String)
static boolean	uninstallNormal(Context context, java.lang.String packageName) uninstall package normal by system intent
static int	uninstallSilent(Context context, java.lang.String packageName) uninstall package and clear data of app silent by root
static int	uninstallSilent(Context context, java.lang.String packageName, boolean isKeepData) uninstall package silent by root Attentions: Don't call this on the ui thread, it may costs some times.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

APP_INSTALL_AUTO

public static final int APP_INSTALL_AUTO

App installation location settings values, same to #PackageHelper

See Also:

Constant Field Values

APP_INSTALL_INTERNAL

public static final int APP_INSTALL_INTERNAL

See Also:

Constant Field Values

APP_INSTALL_EXTERNAL

public static final int APP_INSTALL_EXTERNAL

See Also:

Constant Field Values

INSTALL_SUCCEEDED

public static final int INSTALL_SUCCEEDED

Installation return code
install success.

See Also:

Constant Field Values

INSTALL_FAILED_ALREADY_EXISTS

public static final int INSTALL_FAILED_ALREADY_EXISTS

Installation return code
the package is already installed.

See Also:

Constant Field Values

INSTALL_FAILED_INVALID_APK

public static final int INSTALL_FAILED_INVALID_APK

Installation return code
the package archive file is invalid.

See Also:

Constant Field Values

INSTALL_FAILED_INVALID_URI

public static final int INSTALL_FAILED_INVALID_URI

Installation return code
the URI passed in is invalid.

See Also:

Constant Field Values

INSTALL_FAILED_INSUFFICIENT_STORAGE

public static final int INSTALL_FAILED_INSUFFICIENT_STORAGE

Installation return code
the package manager service found that the device didn't have enough storage space to install the app.

See Also:

Constant Field Values

INSTALL_FAILED_DUPLICATE_PACKAGE

public static final int INSTALL_FAILED_DUPLICATE_PACKAGE

Installation return code
a package is already installed with the same name.

See Also:

Constant Field Values

INSTALL_FAILED_NO_SHARED_USER

public static final int INSTALL_FAILED_NO_SHARED_USER

Installation return code
the requested shared user does not exist.

See Also:

Constant Field Values

INSTALL_FAILED_UPDATE_INCOMPATIBLE

public static final int INSTALL_FAILED_UPDATE_INCOMPATIBLE

Installation return code
a previously installed package of the same name has a different signature than the new package (and the old package's data was not removed).

See Also:

Constant Field Values

INSTALL_FAILED_SHARED_USER_INCOMPATIBLE

public static final int INSTALL_FAILED_SHARED_USER_INCOMPATIBLE

Installation return code
the new package is requested a shared user which is already installed on the device and does not have matching signature.

See Also:

Constant Field Values

INSTALL_FAILED_MISSING_SHARED_LIBRARY

public static final int INSTALL_FAILED_MISSING_SHARED_LIBRARY

Installation return code
the new package uses a shared library that is not available.

See Also:

Constant Field Values

INSTALL_FAILED_REPLACE_COULDNT_DELETE

public static final int INSTALL_FAILED_REPLACE_COULDNT_DELETE

Installation return code
the new package uses a shared library that is not available.

See Also:

Constant Field Values

INSTALL_FAILED_DEXOPT

public static final int INSTALL_FAILED_DEXOPT

Installation return code
the new package failed while optimizing and validating its dex files, either because there was not enough storage or the validation failed.

See Also:

Constant Field Values

INSTALL_FAILED_OLDER_SDK

public static final int INSTALL_FAILED_OLDER_SDK

Installation return code
the new package failed because the current SDK version is older than that required by the package.

See Also:

Constant Field Values

INSTALL_FAILED_CONFLICTING_PROVIDER

public static final int INSTALL_FAILED_CONFLICTING_PROVIDER

Installation return code
the new package failed because it contains a content provider with the same authority as a provider already installed in the system.

See Also:

Constant Field Values

INSTALL_FAILED_NEWER_SDK

public static final int INSTALL_FAILED_NEWER_SDK

Installation return code
the new package failed because the current SDK version is newer than that required by the package.

See Also:

Constant Field Values

INSTALL_FAILED_TEST_ONLY

public static final int INSTALL_FAILED_TEST_ONLY

Installation return code
the new package failed because it has specified that it is a test-only package and the caller has not supplied the #INSTALL_ALLOW_TEST flag.

See Also:

Constant Field Values

INSTALL_FAILED_CPU_ABI_INCOMPATIBLE

public static final int INSTALL_FAILED_CPU_ABI_INCOMPATIBLE

Installation return code
the package being installed contains native code, but none that is compatible with the the device's CPU_ABI.

See Also:

Constant Field Values

INSTALL_FAILED_MISSING_FEATURE

public static final int INSTALL_FAILED_MISSING_FEATURE

Installation return code
the new package uses a feature that is not available.

See Also:

Constant Field Values

INSTALL_FAILED_CONTAINER_ERROR

public static final int INSTALL_FAILED_CONTAINER_ERROR

Installation return code
a secure container mount point couldn't be accessed on external media.

See Also:

Constant Field Values

INSTALL_FAILED_INVALID_INSTALL_LOCATION

public static final int INSTALL_FAILED_INVALID_INSTALL_LOCATION

Installation return code
the new package couldn't be installed in the specified install location.

See Also:

Constant Field Values

INSTALL_FAILED_MEDIA_UNAVAILABLE

public static final int INSTALL_FAILED_MEDIA_UNAVAILABLE

Installation return code
the new package couldn't be installed in the specified install location because the media is not available.

See Also:

Constant Field Values

INSTALL_FAILED_VERIFICATION_TIMEOUT

public static final int INSTALL_FAILED_VERIFICATION_TIMEOUT

Installation return code
the new package couldn't be installed because the verification timed out.

See Also:

Constant Field Values

INSTALL_FAILED_VERIFICATION_FAILURE

public static final int INSTALL_FAILED_VERIFICATION_FAILURE

Installation return code
the new package couldn't be installed because the verification did not succeed.

See Also:

Constant Field Values

INSTALL_FAILED_PACKAGE_CHANGED

public static final int INSTALL_FAILED_PACKAGE_CHANGED

Installation return code
the package changed from what the calling program expected.

See Also:

Constant Field Values

INSTALL_FAILED_UID_CHANGED

public static final int INSTALL_FAILED_UID_CHANGED

Installation return code
the new package is assigned a different UID than it previously held.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_NOT_APK

public static final int INSTALL_PARSE_FAILED_NOT_APK

Installation return code
if the parser was given a path that is not a file, or does not end with the expected '.apk' extension.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_BAD_MANIFEST

public static final int INSTALL_PARSE_FAILED_BAD_MANIFEST

Installation return code
if the parser was unable to retrieve the AndroidManifest.xml file.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION

public static final int INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION

Installation return code
if the parser encountered an unexpected exception.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_NO_CERTIFICATES

public static final int INSTALL_PARSE_FAILED_NO_CERTIFICATES

Installation return code
if the parser did not find any certificates in the .apk.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES

public static final int INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES

Installation return code
if the parser found inconsistent certificates on the files in the .apk.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING

public static final int INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING

Installation return code
if the parser encountered a CertificateEncodingException in one of the files in the .apk.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME

public static final int INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME

Installation return code
if the parser encountered a bad or missing package name in the manifest.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID

public static final int INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID

Installation return code
if the parser encountered a bad shared user id name in the manifest.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_MANIFEST_MALFORMED

public static final int INSTALL_PARSE_FAILED_MANIFEST_MALFORMED

Installation return code
if the parser encountered some structural problem in the manifest.

See Also:

Constant Field Values

INSTALL_PARSE_FAILED_MANIFEST_EMPTY

public static final int INSTALL_PARSE_FAILED_MANIFEST_EMPTY

Installation return code
if the parser did not find any actionable tags (instrumentation or application) in the manifest.

See Also:

Constant Field Values

INSTALL_FAILED_INTERNAL_ERROR

public static final int INSTALL_FAILED_INTERNAL_ERROR

Installation return code
if the system failed to install the package because of system issues.

See Also:

Constant Field Values

INSTALL_FAILED_OTHER

public static final int INSTALL_FAILED_OTHER

Installation return code
other reason

See Also:

Constant Field Values

DELETE_SUCCEEDED

public static final int DELETE_SUCCEEDED

Uninstall return code
uninstall success.

See Also:

Constant Field Values

DELETE_FAILED_INTERNAL_ERROR

public static final int DELETE_FAILED_INTERNAL_ERROR

Uninstall return code
uninstall fail if the system failed to delete the package for an unspecified reason.

See Also:

Constant Field Values

DELETE_FAILED_DEVICE_POLICY_MANAGER

public static final int DELETE_FAILED_DEVICE_POLICY_MANAGER

Uninstall return code
uninstall fail if the system failed to delete the package because it is the active DevicePolicy manager.

See Also:

Constant Field Values

DELETE_FAILED_INVALID_PACKAGE

public static final int DELETE_FAILED_INVALID_PACKAGE

Uninstall return code
uninstall fail if pcakge name is invalid

See Also:

Constant Field Values

DELETE_FAILED_PERMISSION_DENIED

public static final int DELETE_FAILED_PERMISSION_DENIED

Uninstall return code
uninstall fail if permission denied

See Also:

Constant Field Values

Constructor Detail

PackageUtils

public PackageUtils()

Method Detail

install

public static final int install(Context context,
          java.lang.String filePath)

install according conditions

• if system application or rooted, see installSilent(Context, String)
• else see installNormal(Context, String)

Parameters:

context -

filePath -

Returns:

installNormal

public static boolean installNormal(Context context,
                    java.lang.String filePath)

install package normal by system intent

Parameters:

context -

filePath - file path of package

Returns:

whether apk exist

installSilent

public static int installSilent(Context context,
                java.lang.String filePath)

install package silent by root

Attentions:
• Don't call this on the ui thread, it may costs some times.
• You should add android.permission.INSTALL_PACKAGES in manifest, so no need to request root permission, if you are system app.
• Default pm install params is "-r".

Parameters:

context -

filePath - file path of package

Returns:

INSTALL_SUCCEEDED means install success, other means failed. details see PackageUtils.INSTALL_FAILED_*. same to PackageManager.INSTALL_*

See Also:

installSilent(Context, String, String)

installSilent

public static int installSilent(Context context,
                java.lang.String filePath,
                java.lang.String pmParams)

install package silent by root

Attentions:
• Don't call this on the ui thread, it may costs some times.
• You should add android.permission.INSTALL_PACKAGES in manifest, so no need to request root permission, if you are system app.

Parameters:

context -

filePath - file path of package

pmParams - pm install params

Returns:

INSTALL_SUCCEEDED means install success, other means failed. details see PackageUtils.INSTALL_FAILED_*. same to PackageManager.INSTALL_*

uninstall

public static final int uninstall(Context context,
            java.lang.String packageName)

uninstall according conditions

• if system application or rooted, see uninstallSilent(Context, String)
• else see uninstallNormal(Context, String)

Parameters:

context -

packageName - package name of app

Returns:

whether package name is empty

uninstallNormal

public static boolean uninstallNormal(Context context,
                      java.lang.String packageName)

uninstall package normal by system intent

Parameters:

context -

packageName - package name of app

Returns:

whether package name is empty

uninstallSilent

public static int uninstallSilent(Context context,
                  java.lang.String packageName)

uninstall package and clear data of app silent by root

Parameters:

context -

packageName - package name of app

Returns:

See Also:

uninstallSilent(Context, String, boolean)

uninstallSilent

public static int uninstallSilent(Context context,
                  java.lang.String packageName,
                  boolean isKeepData)

uninstall package silent by root

Attentions:
• Don't call this on the ui thread, it may costs some times.
• You should add android.permission.DELETE_PACKAGES in manifest, so no need to request root permission, if you are system app.

Parameters:

context - file path of package

packageName - package name of app

isKeepData - whether keep the data and cache directories around after package removal

Returns:

• DELETE_SUCCEEDED means uninstall success
• DELETE_FAILED_INTERNAL_ERROR means internal error
• DELETE_FAILED_INVALID_PACKAGE means package name error
• DELETE_FAILED_PERMISSION_DENIED means permission denied

isSystemApplication

public static boolean isSystemApplication(Context context)

whether context is system application

Parameters:

context -

Returns:

isSystemApplication

public static boolean isSystemApplication(Context context,
                          java.lang.String packageName)

whether packageName is system application

Parameters:

context -

packageName -

Returns:

isSystemApplication

public static boolean isSystemApplication(PackageManager packageManager,
                          java.lang.String packageName)

whether packageName is system application

Parameters:

packageManager -

packageName -

Returns:

• if packageManager is null, return false
• if package name is null or is empty, return false
• if package name not exit, return false
• if package name exit, but not system app, return false
• else return true

isTopActivity

public static java.lang.Boolean isTopActivity(Context context,
                              java.lang.String packageName)

whether the app whost package's name is packageName is on the top of the stack

Attentions:
• You should add android.permission.GET_TASKS in manifest

Parameters:

context -

packageName -

Returns:

if params error or task stack is null, return null, otherwise retun whether the app is on the top of stack

getAppVersionCode

public static int getAppVersionCode(Context context)

get app version code

Parameters:

context -

Returns:

getInstallLocation

public static int getInstallLocation()

get system install location
can be set by System Menu Setting->Storage->Prefered install location

Returns:

See Also:

IPackageManager#getInstallLocation()}

startInstalledAppDetails

public static void startInstalledAppDetails(Context context,
                            java.lang.String packageName)

start InstalledAppDetails Activity

Parameters:

context -

packageName -