IT. Expert System.

public class RecoverySystem
extends Object

• Nested Class Summary

  Nested Classes

  Modifier and Type	Class and Description
  static interface	RecoverySystem.ProgressListener Interface definition for a callback to be invoked regularly as verification proceeds.

• Constructor Summary

  Constructors

  Constructor and Description
  RecoverySystem()

• Method Summary

  Methods

  Modifier and Type	Method and Description
  static String	handleAftermath() Called after booting to process and remove recovery-related files.
  static void	installPackage(Context context, File packageFile) Reboots the device in order to install the given update package.
  static void	rebootWipeCache(Context context) Reboot into the recovery system to wipe the /cache partition.
  static void	rebootWipeUserData(Context context) Reboots the device and wipes the user data partition.
  static void	verifyPackage(File packageFile, RecoverySystem.ProgressListener listener, File deviceCertsZipFile) Verify the cryptographic signature of a system update package before installing it.

  • Methods inherited from class java.lang.Object

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

• Constructor Detail

  • RecoverySystem

    public RecoverySystem()

• Method Detail

  • verifyPackage

    public static void verifyPackage(File packageFile,
                     RecoverySystem.ProgressListener listener,
                     File deviceCertsZipFile)
                              throws IOException,
                                     GeneralSecurityException

    Verify the cryptographic signature of a system update package before installing it. Note that the package is also verified separately by the installer once the device is rebooted into the recovery system. This function will return only if the package was successfully verified; otherwise it will throw an exception. Verification of a package can take significant time, so this function should not be called from a UI thread. Interrupting the thread while this function is in progress will result in a SecurityException being thrown (and the thread's interrupt flag will be cleared).

    Parameters:

    packageFile - the package to be verified

    listener - an object to receive periodic progress updates as verification proceeds. May be null.

    deviceCertsZipFile - the zip file of certificates whose public keys we will accept. Verification succeeds if the package is signed by the private key corresponding to any public key in this file. May be null to use the system default file (currently "/system/etc/security/otacerts.zip").

    Throws:

    IOException - if there were any errors reading the package or certs files.

    GeneralSecurityException - if verification failed

  • installPackage

    public static void installPackage(Context context,
                      File packageFile)
                               throws IOException

    Reboots the device in order to install the given update package. Requires the android.Manifest.permission#REBOOT permission.

    Parameters:

    context - the Context to use

    packageFile - the update package to install. Must be on a partition mountable by recovery. (The set of partitions known to recovery may vary from device to device. Generally, /cache and /data are safe.)

    Throws:

    IOException - if writing the recovery command file fails, or if the reboot itself fails.

  • rebootWipeUserData

    public static void rebootWipeUserData(Context context)
                                   throws IOException

    Reboots the device and wipes the user data partition. This is sometimes called a "factory reset", which is something of a misnomer because the system partition is not restored to its factory state. Requires the android.Manifest.permission#REBOOT permission.

    Parameters:

    context - the Context to use

    Throws:

    IOException - if writing the recovery command file fails, or if the reboot itself fails.

  • rebootWipeCache

    public static void rebootWipeCache(Context context)
                                throws IOException

    Reboot into the recovery system to wipe the /cache partition.

    Throws:

    IOException - if something goes wrong.

  • handleAftermath

    public static String handleAftermath()

    Called after booting to process and remove recovery-related files.

    Returns:

    the log file from recovery, or null if none was found.