package cm.android.common.pm; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import android.content.Context; import android.content.pm.PackageManager; import android.net.Uri; import java.io.File; import cm.android.applications.AppUtil; import cm.android.util.IntentUtil; import cm.java.cmd.Shell; import cm.java.util.Utils; import static cm.java.cmd.Shell.SH; import static cm.java.cmd.Shell.SU; /** * PackageUtil * <ul> * <strong>Install package</strong> * <li>{@link PackageUtil#installNormal(Context, String)}</li> * <li>{@link PackageUtil#installSilent(Context, String)}</li> * <li>{@link PackageUtil#install(Context, String)}</li> * </ul> * <ul> * <strong>Uninstall package</strong> * <li>{@link PackageUtil#uninstallNormal(Context, String)}</li> * <li>{@link PackageUtil#uninstallSilent(Context, String)}</li> * <li>{@link PackageUtil#uninstall(Context, String)}</li> * </ul> * <ul> * <strong>Is system application</strong> * <li>{@link PackageUtil#isSystemApplication(Context)}</li> * <li>{@link PackageUtil#isSystemApplication(Context, String)}</li> * </ul> * * @author <a href="http://www.trinea.cn" target="_blank">Trinea</a> 2013-5-15 */ public class PackageUtil { private static final Logger logger = LoggerFactory.getLogger("PM"); public static final int INSTALL_DELETE_NORMAL = Integer.MAX_VALUE; /** * Installation return code<br/> * install success. */ public static final int INSTALL_SUCCEEDED = 1; /** * Installation return code<br/> * the package is already installed. */ public static final int INSTALL_FAILED_ALREADY_EXISTS = -1; /** * Installation return code<br/> * the package archive file is invalid. */ public static final int INSTALL_FAILED_INVALID_APK = -2; /** * Installation return code<br/> * the URI passed in is invalid. */ public static final int INSTALL_FAILED_INVALID_URI = -3; /** * Installation return code<br/> * the package manager service found that the device didn't have enough * storage space to install the app. */ public static final int INSTALL_FAILED_INSUFFICIENT_STORAGE = -4; /** * Installation return code<br/> * a package is already installed with the same name. */ public static final int INSTALL_FAILED_DUPLICATE_PACKAGE = -5; /** * Installation return code<br/> * the requested shared user does not exist. */ public static final int INSTALL_FAILED_NO_SHARED_USER = -6; /** * Installation return code<br/> * 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). */ public static final int INSTALL_FAILED_UPDATE_INCOMPATIBLE = -7; /** * Installation return code<br/> * the new package is requested a shared user which is already installed on * the device and does not have matching signature. */ public static final int INSTALL_FAILED_SHARED_USER_INCOMPATIBLE = -8; /** * Installation return code<br/> * the new package uses a shared library that is not available. */ public static final int INSTALL_FAILED_MISSING_SHARED_LIBRARY = -9; /** * Installation return code<br/> * the new package uses a shared library that is not available. */ public static final int INSTALL_FAILED_REPLACE_COULDNT_DELETE = -10; /** * Installation return code<br/> * the new package failed while optimizing and validating its dex files, * either because there was not enough storage or the validation failed. */ public static final int INSTALL_FAILED_DEXOPT = -11; /** * Installation return code<br/> * the new package failed because the current SDK version is older than that * required by the package. */ public static final int INSTALL_FAILED_OLDER_SDK = -12; /** * Installation return code<br/> * the new package failed because it contains a content provider with the * same authority as a provider already installed in the system. */ public static final int INSTALL_FAILED_CONFLICTING_PROVIDER = -13; /** * Installation return code<br/> * the new package failed because the current SDK version is newer than that * required by the package. */ public static final int INSTALL_FAILED_NEWER_SDK = -14; /** * Installation return code<br/> * the new package failed because it has specified that it is a test-only * package and the caller has not supplied the {@link #INSTALL_ALLOW_TEST} * flag. */ public static final int INSTALL_FAILED_TEST_ONLY = -15; /** * Installation return code<br/> * the package being installed contains native code, but none that is * compatible with the the device's CPU_ABI. */ public static final int INSTALL_FAILED_CPU_ABI_INCOMPATIBLE = -16; /** * Installation return code<br/> * the new package uses a feature that is not available. */ public static final int INSTALL_FAILED_MISSING_FEATURE = -17; /** * Installation return code<br/> * a secure container mount point couldn't be accessed on external media. */ public static final int INSTALL_FAILED_CONTAINER_ERROR = -18; /** * Installation return code<br/> * the new package couldn't be installed in the specified install location. */ public static final int INSTALL_FAILED_INVALID_INSTALL_LOCATION = -19; /** * Installation return code<br/> * the new package couldn't be installed in the specified install location * because the media is not available. */ public static final int INSTALL_FAILED_MEDIA_UNAVAILABLE = -20; /** * Installation return code<br/> * the new package couldn't be installed because the verification timed out. */ public static final int INSTALL_FAILED_VERIFICATION_TIMEOUT = -21; /** * Installation return code<br/> * the new package couldn't be installed because the verification did not * succeed. */ public static final int INSTALL_FAILED_VERIFICATION_FAILURE = -22; /** * Installation return code<br/> * the package changed from what the calling program expected. */ public static final int INSTALL_FAILED_PACKAGE_CHANGED = -23; /** * Installation return code<br/> * the new package is assigned a different UID than it previously held. */ public static final int INSTALL_FAILED_UID_CHANGED = -24; /** * Installation return code<br/> * if the parser was given a path that is not a file, or does not end with * the expected '.apk' extension. */ public static final int INSTALL_PARSE_FAILED_NOT_APK = -100; /** * Installation return code<br/> * if the parser was unable to retrieve the AndroidManifest.xml file. */ public static final int INSTALL_PARSE_FAILED_BAD_MANIFEST = -101; /** * Installation return code<br/> * if the parser encountered an unexpected exception. */ public static final int INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION = -102; /** * Installation return code<br/> * if the parser did not find any certificates in the .apk. */ public static final int INSTALL_PARSE_FAILED_NO_CERTIFICATES = -103; /** * Installation return code<br/> * if the parser found inconsistent certificates on the files in the .apk. */ public static final int INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES = -104; /** * Installation return code<br/> * if the parser encountered a CertificateEncodingException in one of the * files in the .apk. */ public static final int INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING = -105; /** * Installation return code<br/> * if the parser encountered a bad or missing package name in the manifest. */ public static final int INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME = -106; /** * Installation return code<br/> * if the parser encountered a bad shared user id name in the manifest. */ public static final int INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID = -107; /** * Installation return code<br/> * if the parser encountered some structural problem in the manifest. */ public static final int INSTALL_PARSE_FAILED_MANIFEST_MALFORMED = -108; /** * Installation return code<br/> * if the parser did not find any actionable tags (instrumentation or * application) in the manifest. */ public static final int INSTALL_PARSE_FAILED_MANIFEST_EMPTY = -109; /** * Installation return code<br/> * if the system failed to install the package because of system issues. */ public static final int INSTALL_FAILED_INTERNAL_ERROR = -110; /** * Installation return code<br/> * other reason */ public static final int INSTALL_FAILED_OTHER = -1000000; /** * Uninstall return code<br/> * uninstall success. */ public static final int DELETE_SUCCEEDED = 1; /** * Uninstall return code<br/> * uninstall fail if the system failed to delete the package for an * unspecified reason. */ public static final int DELETE_FAILED_INTERNAL_ERROR = -1; /** * Uninstall return code<br/> * uninstall fail if the system failed to delete the package because it is * the active DevicePolicy manager. */ public static final int DELETE_FAILED_DEVICE_POLICY_MANAGER = -2; /** * Uninstall return code<br/> * uninstall fail if pcakge name is invalid */ public static final int DELETE_FAILED_INVALID_PACKAGE = -3; /** * Uninstall return code<br/> * uninstall fail if permission denied */ public static final int DELETE_FAILED_PERMISSION_DENIED = -4; /** * install according conditions * <ul> * <li>if system application or rooted, see * {@link #installSilent(Context, String)}</li> * <li>else see {@link #installNormal(Context, String)}</li> * </ul> */ public static final int install(Context context, String filePath) { if (PackageUtil.isSystemApplication(context) || Shell.su()) { return installSilent(context, filePath); } return installNormal(context, filePath) ? INSTALL_DELETE_NORMAL : INSTALL_FAILED_INVALID_URI; } /** * install package normal by system intent * * @param filePath file path of package * @return whether apk exist */ public static boolean installNormal(Context context, String filePath) { if (Utils.isEmpty(filePath)) { return false; } return IntentUtil.installPackage(context, Uri.fromFile(new File(filePath))); } /** * install package silent by root * <ul> * <strong>Attentions:</strong> * <li>Don't call this on the ui thread, it may costs some times.</li> * <li>You should add <strong>android.permission.INSTALL_PACKAGES</strong> * in manifest, so no need to request root permission, if you are system * app.</li> * </ul> * * @param filePath file path of package * @return {@link PackageUtil#INSTALL_SUCCEEDED} means install success, * other means failed. details see {@link PackageUtil} * .INSTALL_FAILED_*. same to {@link PackageManager}.INSTALL_* */ public static int installSilent(Context context, String filePath) { if (filePath == null || filePath.length() == 0) { return INSTALL_FAILED_INVALID_URI; } File file = new File(filePath); if (file == null || file.length() <= 0 || !file.exists() || !file.isFile()) { return INSTALL_FAILED_INVALID_URI; } /** * if context is system app, don't need root permission, but should add * <uses-permission android:name="android.permission.INSTALL_PACKAGES" * /> in mainfest **/ StringBuilder command = new StringBuilder().append( "LD_LIBRARY_PATH=/vendor/lib:/system/lib pm install -r ") .append(filePath.replace(" ", "\\ ")); // CommandResult commandResult = ShellUtil.exec(command.toString(), // !isSystemApplication(context), true); String shell = isSystemApplication(context) ? SH : SU; Shell.Result commandResult = Shell.exec2(shell, new String[]{command.toString()}); if (commandResult.output != null && (commandResult.output.contains("Success") || commandResult.output .contains("success"))) { return INSTALL_SUCCEEDED; } logger.error(new StringBuilder().append("installSilent successMsg:") .append(commandResult.output).append(", ErrorMsg:") .append(commandResult.error).toString()); if (commandResult.error == null) { return INSTALL_FAILED_OTHER; } if (commandResult.error.contains("INSTALL_FAILED_ALREADY_EXISTS")) { return INSTALL_FAILED_ALREADY_EXISTS; } if (commandResult.error.contains("INSTALL_FAILED_INVALID_APK")) { return INSTALL_FAILED_INVALID_APK; } if (commandResult.error.contains("INSTALL_FAILED_INVALID_URI")) { return INSTALL_FAILED_INVALID_URI; } if (commandResult.error .contains("INSTALL_FAILED_INSUFFICIENT_STORAGE")) { return INSTALL_FAILED_INSUFFICIENT_STORAGE; } if (commandResult.error.contains("INSTALL_FAILED_DUPLICATE_PACKAGE")) { return INSTALL_FAILED_DUPLICATE_PACKAGE; } if (commandResult.error.contains("INSTALL_FAILED_NO_SHARED_USER")) { return INSTALL_FAILED_NO_SHARED_USER; } if (commandResult.error .contains("INSTALL_FAILED_UPDATE_INCOMPATIBLE")) { return INSTALL_FAILED_UPDATE_INCOMPATIBLE; } if (commandResult.error .contains("INSTALL_FAILED_SHARED_USER_INCOMPATIBLE")) { return INSTALL_FAILED_SHARED_USER_INCOMPATIBLE; } if (commandResult.error .contains("INSTALL_FAILED_MISSING_SHARED_LIBRARY")) { return INSTALL_FAILED_MISSING_SHARED_LIBRARY; } if (commandResult.error .contains("INSTALL_FAILED_REPLACE_COULDNT_DELETE")) { return INSTALL_FAILED_REPLACE_COULDNT_DELETE; } if (commandResult.error.contains("INSTALL_FAILED_DEXOPT")) { return INSTALL_FAILED_DEXOPT; } if (commandResult.error.contains("INSTALL_FAILED_OLDER_SDK")) { return INSTALL_FAILED_OLDER_SDK; } if (commandResult.error .contains("INSTALL_FAILED_CONFLICTING_PROVIDER")) { return INSTALL_FAILED_CONFLICTING_PROVIDER; } if (commandResult.error.contains("INSTALL_FAILED_NEWER_SDK")) { return INSTALL_FAILED_NEWER_SDK; } if (commandResult.error.contains("INSTALL_FAILED_TEST_ONLY")) { return INSTALL_FAILED_TEST_ONLY; } if (commandResult.error .contains("INSTALL_FAILED_CPU_ABI_INCOMPATIBLE")) { return INSTALL_FAILED_CPU_ABI_INCOMPATIBLE; } if (commandResult.error.contains("INSTALL_FAILED_MISSING_FEATURE")) { return INSTALL_FAILED_MISSING_FEATURE; } if (commandResult.error.contains("INSTALL_FAILED_CONTAINER_ERROR")) { return INSTALL_FAILED_CONTAINER_ERROR; } if (commandResult.error .contains("INSTALL_FAILED_INVALID_INSTALL_LOCATION")) { return INSTALL_FAILED_INVALID_INSTALL_LOCATION; } if (commandResult.error.contains("INSTALL_FAILED_MEDIA_UNAVAILABLE")) { return INSTALL_FAILED_MEDIA_UNAVAILABLE; } if (commandResult.error .contains("INSTALL_FAILED_VERIFICATION_TIMEOUT")) { return INSTALL_FAILED_VERIFICATION_TIMEOUT; } if (commandResult.error .contains("INSTALL_FAILED_VERIFICATION_FAILURE")) { return INSTALL_FAILED_VERIFICATION_FAILURE; } if (commandResult.error.contains("INSTALL_FAILED_PACKAGE_CHANGED")) { return INSTALL_FAILED_PACKAGE_CHANGED; } if (commandResult.error.contains("INSTALL_FAILED_UID_CHANGED")) { return INSTALL_FAILED_UID_CHANGED; } if (commandResult.error.contains("INSTALL_PARSE_FAILED_NOT_APK")) { return INSTALL_PARSE_FAILED_NOT_APK; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_BAD_MANIFEST")) { return INSTALL_PARSE_FAILED_BAD_MANIFEST; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION")) { return INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_NO_CERTIFICATES")) { return INSTALL_PARSE_FAILED_NO_CERTIFICATES; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES")) { return INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING")) { return INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME")) { return INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID")) { return INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_MANIFEST_MALFORMED")) { return INSTALL_PARSE_FAILED_MANIFEST_MALFORMED; } if (commandResult.error .contains("INSTALL_PARSE_FAILED_MANIFEST_EMPTY")) { return INSTALL_PARSE_FAILED_MANIFEST_EMPTY; } if (commandResult.error.contains("INSTALL_FAILED_INTERNAL_ERROR")) { return INSTALL_FAILED_INTERNAL_ERROR; } return INSTALL_FAILED_OTHER; } /** * uninstall according conditions * <ul> * <li>if system application or rooted, see * {@link #uninstallSilent(Context, String)}</li> * <li>else see {@link #uninstallNormal(Context, String)}</li> * </ul> * * @param packageName package name of app */ public static final int uninstall(Context context, String packageName) { if (PackageUtil.isSystemApplication(context) || Shell.su()) { return uninstallSilent(context, packageName); } return uninstallNormal(context, packageName) ? INSTALL_DELETE_NORMAL : DELETE_FAILED_INVALID_PACKAGE; } /** * uninstall package normal by system intent * * @param packageName package name of app * @return whether package name is empty */ public static boolean uninstallNormal(Context context, String packageName) { return IntentUtil.deletePackage(context, packageName); } /** * uninstall package and clear data of app silent by root * * @param packageName package name of app * @see #uninstallSilent(Context, String, boolean) */ public static int uninstallSilent(Context context, String packageName) { return uninstallSilent(context, packageName, true); } /** * uninstall package silent by root * <ul> * <strong>Attentions:</strong> * <li>Don't call this on the ui thread, it may costs some times.</li> * <li>You should add <strong>android.permission.DELETE_PACKAGES</strong> in * manifest, so no need to request root permission, if you are system app.</li> * </ul> * * @param context file path of package * @param packageName package name of app * @param isKeepData whether keep the data and cache directories around after * package removal * @return <ul> * <li>{@link #DELETE_SUCCEEDED} means uninstall success</li> * <li>{@link #DELETE_FAILED_INTERNAL_ERROR} means internal error</li> * <li>{@link #DELETE_FAILED_INVALID_PACKAGE} means package name * error</li> * <li>{@link #DELETE_FAILED_PERMISSION_DENIED} means permission * denied</li> */ public static int uninstallSilent(Context context, String packageName, boolean isKeepData) { if (packageName == null || packageName.length() == 0) { return DELETE_FAILED_INVALID_PACKAGE; } /** * if context is system app, don't need root permission, but should add * <uses-permission android:name="android.permission.DELETE_PACKAGES" /> * in mainfest **/ StringBuilder command = new StringBuilder() .append("LD_LIBRARY_PATH=/vendor/lib:/system/lib pm uninstall") .append(isKeepData ? " -k " : " ") .append(packageName.replace(" ", "\\ ")); // CommandResult commandResult = ShellUtil.exec(command.toString(), !isSystemApplication(context), true); String shell = isSystemApplication(context) ? Shell.SH : Shell.SU; Shell.Result commandResult = Shell.exec2(shell, new String[]{command.toString()}); if (commandResult.output != null && (commandResult.output.contains("Success") || commandResult.output .contains("success"))) { return DELETE_SUCCEEDED; } logger.error(new StringBuilder().append("uninstallSilent successMsg:") .append(commandResult.output).append(", ErrorMsg:") .append(commandResult.error).toString()); if (commandResult.error == null) { return DELETE_FAILED_INTERNAL_ERROR; } if (commandResult.error.contains("Permission denied")) { return DELETE_FAILED_PERMISSION_DENIED; } return DELETE_FAILED_INTERNAL_ERROR; } /** * whether context is system application */ public static boolean isSystemApplication(Context context) { if (context == null) { return false; } return isSystemApplication(context, context.getPackageName()); } /** * whether packageName is system application */ public static boolean isSystemApplication(Context context, String packageName) { if (context == null) { return false; } return AppUtil.isSystemApp(context.getPackageManager(), packageName); } }