Cross Reference: /frameworks/base/core/java/android/app/backup/BackupAgent.java

Lines Matching defs:backup
17 package android.app.backup;
21 import android.app.backup.FullBackup.BackupScheme.PathWithRequiredFlags;
54  * application and Android's data backup infrastructure.  An application that wishes
55  * to participate in the backup and restore mechanism will declare a subclass of
56  * {@link android.app.backup.BackupAgent}, implement the
59  * and provide the name of its backup agent class in its {@code AndroidManifest.xml} file via
67  * <a href="{@docRoot}guide/topics/data/backup.html">Data Backup</a> developer guide.</p></div>
73  * {@link android.app.backup.BackupManager#dataChanged() BackupManager.dataChanged()} method.
75  * to update its backup image.  The Backup Manager, in turn, schedules a
76  * backup pass to be performed at an opportune time.
81  * begins an immediate restore pass to deliver the backup data as part of the installation
84  * When a backup or restore pass is run, the application's process is launched
85  * (if not already running), the manifest-declared backup agent class (in the {@code
88  * agent instance to run the actual backup or restore logic.  At this point the
94  * A backup data set consists of one or more "entities," flattened binary data
104  * {@link android.app.backup.BackupAgentHelper}.  That class is particularly
106  * backup and restore.
120  * @see android.app.backup.BackupManager
121  * @see android.app.backup.BackupAgentHelper
122  * @see android.app.backup.BackupDataInput
123  * @see android.app.backup.BackupDataOutput
151      * <p>The transport has client-side encryption enabled. i.e., the user's backup has been
154      * decrypt the user's backup data.
163      * storage. The user's backup data is sent directly to another device over e.g., USB or WiFi.
213      * to do one-time initialization before the actual backup or restore operation
222      * sort of shutdown process after backup or restore is completed.
231      * time it performed a backup operation. The state data recorded during the
232      * last backup pass is provided in the <code>oldState</code> file
234      * is available and the application should perform a full backup. In both
235      * cases, a representation of the final backup state after this pass should
239      * Each entity written to the {@link android.app.backup.BackupDataOutput}
241      * over the current backup transport and stored in the remote data set under
247      *            last backup state provided by the application. May be
249      *            provided and the application should perform a full backup.
251      *            file descriptor pointing to the backup data destination.
252      *            Typically the application will use backup helper classes to
255      *            empty file. The application should record the final backup
263      * The application is being restored from backup and should replace any
264      * existing data with the contents of the backup. The backup data is
289      *            empty file. The application should record the final backup
291      *            When a full-backup dataset is being restored, this will be <code>null</code>.
309      * points to the backup destination, and the app has the opportunity to choose which
310      * files are to be stored.  To commit a file as part of the backup, call the
312      * data is written to the output, the agent returns from this method and the backup
333      * @param data A structured wrapper pointing to the backup destination.
357                                 + " Aborting full backup.", e);
486      * Notification that the application's current backup operation causes it to exceed
487      * the maximum size permitted by the transport.  The ongoing backup operation is
488      * halted and rolled back: any data that had been stored by a previous backup operation
504      * @param backupDataBytes The amount of data measured while initializing the backup
510      *    this application to store as a backup.
550      * Write an entire file as part of a full-backup operation.  The file's contents
551      * will be delivered to the backup destination along with the metadata necessary
556      * the backup system will have no effect.  For example, if the app calls this method
614             // may or may not have external files access to attempt backup/restore there
689      * omitted from the backup process.
993                 // Ensure that any SharedPreferences writes have landed after the backup,
1086                     Log.e(TAG, "Unable to finalize backup stream!");