17 package android.app.backup;
26 import com.android.internal.backup.IBackupTransport;
55      * Indicates that the transport cannot accept a diff backup for this package.
58      * non-incremental backup. This might be used if the transport no longer has data for this
61      * <p>This is only valid when backup manager called {@link
71      * For key value backup, indicates that the backup data is a diff from a previous backup. The
72      * transport must apply this diff to an existing backup to build the new backup set.
79      * For key value backup, indicates that the backup data is a complete set, not a diff from a
80      * previous backup. The transport should clear any previous backup when storing this backup.
91             "android.app.backup.extra.TRANSPORT_REGISTRATION";
131      * can potentially associate backup data with arbitrary user accounts should
180      * Ask the transport where, on local device storage, to keep backup state blobs.
182      * "live" backup services without interfering with the live bookkeeping.  The
184      * available backup transports; the name of the class implementing the transport
189      *         different backup transports.
222      * Erase the given application's data from the backup destination.  This clears
223      * out the given package's data from the current backup set, making it as though
234      * Finish sending application data to the backup destination.  This must be
237      * method returns true can a backup be assumed to have succeeded.
246     // Key/value incremental backup support interfaces
249      * Verify that this is a suitable time for a key/value backup pass.  This should return zero
250      * if a backup is reasonable right now, some positive value otherwise.  This method
253      * <p>If this is not a suitable time for a backup, the transport should return a
256      * @return Zero if this is a suitable time for a backup pass, or a positive time delay
257      *   in milliseconds to suggest deferring the backup pass for a while.
264      * Send one application's key/value data update to the backup destination.  The
269      * If the backup data is a diff against the previous backup then the flag {@link
270      * BackupTransport#FLAG_INCREMENTAL} will be set. Otherwise, if the data is a complete backup
272      * be set regardless of whether the backup is incremental or not.
277      * that backup manager should delete its state and retry the package as a non-incremental
278      * backup. Before P, or if this is a non-incremental backup, then this return code is equivalent
289      *  {@link BackupTransport#TRANSPORT_PACKAGE_REJECTED} (to suppress backup of this
293      *  an incremental backup for this package), or {@link
323      * Get the identifying token of the backup set currently being stored from
328      *   is no backup set available corresponding to the current device state.
335      * Start restoring application data from backup.  After calling this function,
339      * @param token A backup token as returned by {@link #getAvailableRestoreSets}
352      * Get the package name of the next application with data in the backup store, plus
388      * @param data An open, writable file into which the key/value backup data should be stored.
405     // Full backup interfaces
408      * Verify that this is a suitable time for a full-data backup pass.  This should return zero
409      * if a backup is reasonable right now, some positive value otherwise.  This method
412      * <p>If this is not a suitable time for a backup, the transport should return a
415      * @return Zero if this is a suitable time for a backup pass, or a positive time delay
416      *   in milliseconds to suggest deferring the backup pass for a while.
429      * <p>If the package is not eligible for backup, the transport should return
431      * simply proceed with the next candidate if any, or finish the full backup operation
458      *    backup data; TRANSPORT_ERROR to indicate a fatal error condition that precludes
459      *    performing a backup at this time.
476      * handle a full-data backup operation of the specified size on the current package.
477      * If the transport returns anything other than TRANSPORT_OK, the package's backup
481      * <p class="note">The platform does no size-based rejection of full backup attempts on
492      * @return TRANSPORT_OK if the platform is to proceed with the full-data backup,
495      *         condition that means the platform cannot perform a backup at this time.
518      * Tells the transport to cancel the currently-ongoing full backup operation.  This
520      * if the OS needs to abort the backup operation for any reason, such as a crash in
521      * the application undergoing backup.
528      * call to {@link #finishBackup()}.  It needs to tear down any ongoing backup state
537      * Ask the transport whether this app is eligible for backup.
540      * @param isFullBackup If set, transport should check if app is eligible for full data backup,
541      *   otherwise to check if eligible for key-value backup.
542      * @return Whether this app is eligible for backup.
549      * Ask the transport about current quota for backup size of the package.
552      * @param isFullBackup If set, transport should return limit for full data backup, otherwise
553      *                     for key-value backup.
554      * @return Current limit on backup size in bytes.
618      * {@link android.app.backup.BackupAgent}. This allows the agent to decide what to do based on

Indexes created Sun Aug 12 02:23:12 CEST 2018