Most visited

Recently visited

Results for

Added in API level 8

BackupAgent

public abstract class BackupAgent
extends ContextWrapper

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.backup.BackupAgent

Known Direct Subclasses

BackupAgentHelper

提供应用程序和Android数据备份基础架构之间的中心界面。希望参与备份和恢复机制的应用程序将声明BackupAgent的子类，实现onBackup()和onRestore()方法，并通过<application>标记的android:backupAgent属性在其AndroidManifest.xml文件中提供其备份代理类的名称。

Developer Guides

有关使用BackupAgent的更多信息，请阅读 Data Backup开发人员指南。

Basic Operation

当应用程序对希望保留备份的数据进行更改时，应调用BackupManager.dataChanged()方法。这会通知Android备份管理器该应用程序需要更新其备份映像的机会。备份管理器反过来安排在适当的时候执行备份。

恢复操作通常仅在应用程序首次安装在设备上时执行。此时，操作系统会检查是否有先前保存的数据集可用于正在安装的应用程序，如果是，则开始即时还原传递以在安装过程中传输备份数据。

当运行备份或还原过程时，启动应用程序的进程（如果尚未运行），清单声明的备份代理类（在android:backupAgent属性中）在该进程中实例化，并调用代理的onCreate()方法。这使代理实例准备好运行实际的备份或恢复逻辑。此时，代理的onBackup()或onRestore()方法将根据正在执行的操作调用。

备份数据集由一个或多个“实体”组成，每个扁平化二进制数据记录用数据集内唯一的键字符串标识。向活动数据集添加记录或更新现有记录是通过在所需密钥下简单写入新实体数据完成的。从数据集中删除一个实体是通过在指定负数据大小的标题下编写一个实体并且没有实际的实体数据来完成的。

助手类

基于方便助手类的可扩展代理可在BackupAgentHelper中BackupAgentHelper 。该类特别适合处理简单文件或SharedPreferences备份和恢复。

也可以看看：

Summary

Constants
`int`	`TYPE_DIRECTORY` 在完整还原期间，指示正在还原的文件系统对象是目录。
`int`	`TYPE_FILE` 在完全还原期间，指示正在还原的文件系统对象是普通文件。

Inherited constants

From class android.content.Context

Public constructors
`BackupAgent()`

Public methods
`final void`	`fullBackupFile(File file, FullBackupDataOutput output)` 作为完整备份操作的一部分写入整个文件。
`abstract void`	`onBackup(ParcelFileDescriptor oldState, BackupDataOutput data, ParcelFileDescriptor newState)` 要求应用程序写入自上次执行备份操作以来更改的任何数据。
`void`	`onCreate()` 为实际备份或恢复操作开始之前需要机会进行一次性初始化的代理实现提供便利。
`void`	`onDestroy()` 为备份或恢复完成后需要执行某种关闭过程的代理实现提供便利。
`void`	`onFullBackup(FullBackupDataOutput data)` 应用程序正在备份其整个文件系统内容。
`void`	`onQuotaExceeded(long backupDataBytes, long quotaBytes)` 通知应用程序的当前备份操作导致其超过传输所允许的最大大小。
`abstract void`	`onRestore(BackupDataInput data, int appVersionCode, ParcelFileDescriptor newState)` 应用程序正在从备份中恢复，并应将所有现有数据替换为备份的内容。
`void`	`onRestoreFile(ParcelFileDescriptor data, long size, File destination, int type, long mode, long mtime)` 在完全恢复操作期间处理通过给定文件描述符传送的数据。
`void`	`onRestoreFinished()` 应用程序的还原操作已完成。

Inherited methods

From class android.content.ContextWrapper

From class android.content.Context

`abstract boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` 连接到应用程序服务，根据需要创建它。
`abstract int`	`checkCallingOrSelfPermission(String permission)` 确定IPC的调用过程还是您已被授予特定权限。
`abstract int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` 确定IPC的调用进程或您是否被授予访问特定URI的权限。
`abstract int`	`checkCallingPermission(String permission)` 确定您正在处理的IPC的调用进程是否已被授予特定权限。
`abstract int`	`checkCallingUriPermission(Uri uri, int modeFlags)` 确定调用进程和用户标识是否已被授予访问特定URI的权限。
`abstract int`	`checkPermission(String permission, int pid, int uid)` 确定是否允许给定的权限用于系统中运行的特定进程和用户标识。
`abstract int`	`checkSelfPermission(String permission)` 确定您是否已获得特定权限。
`abstract int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` 检查Uri和普通权限。
`abstract int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` 确定是否已授予特定进程和用户标识访问特定URI的权限。
`abstract void`	`clearWallpaper()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.clear()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract Context`	`createConfigurationContext(Configuration overrideConfiguration)` 为当前上下文返回一个新的Context对象，但其资源被调整以匹配给定的配置。
`abstract Context`	`createDeviceProtectedStorageContext()` 为当前上下文返回一个新的Context对象，但其存储API由受设备保护的存储支持。
`abstract Context`	`createDisplayContext(Display display)` 为当前上下文返回一个新的Context对象，但其资源被调整为匹配给定Display的指标。
`abstract Context`	`createPackageContext(String packageName, int flags)` 为给定的应用程序名称返回一个新的Context对象。
`abstract String[]`	`databaseList()` 返回一个字符串数组，命名与此Context的应用程序包关联的专用数据库。
`abstract boolean`	`deleteDatabase(String name)` 删除与此Context的应用程序包关联的现有私有SQLiteDatabase。
`abstract boolean`	`deleteFile(String name)` 删除与此Context的应用程序包关联的给定私人文件。
`abstract boolean`	`deleteSharedPreferences(String name)` 删除现有的共享首选项文件。
`abstract void`	`enforceCallingOrSelfPermission(String permission, String message)` 如果您和您正在处理的IPC的调用过程都未获得特定许可，请丢弃 `SecurityException` 。
`abstract void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` 如果IPC的调用进程或您没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract void`	`enforceCallingPermission(String permission, String message)` 如果您正在处理的IPC的调用过程没有被授予特定权限，请抛出 `SecurityException` 。
`abstract void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` 如果调用进程和用户标识没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract void`	`enforcePermission(String permission, int pid, int uid, String message)` 如果在系统中运行的特定进程和用户标识不允许给定权限，则抛出 `SecurityException` 。
`abstract void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` 强制执行Uri和普通权限。
`abstract void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` 如果某个特定的进程和用户标识未被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract String[]`	`fileList()` 返回一个字符串数组，命名与此Context的应用程序包关联的私有文件。
`abstract Context`	`getApplicationContext()` 返回当前进程的单个全局应用程序对象的上下文。
`abstract ApplicationInfo`	`getApplicationInfo()` 返回此上下文包的完整应用程序信息。
`abstract AssetManager`	`getAssets()` 返回应用程序包的AssetManager实例。
`abstract File`	`getCacheDir()` 返回文件系统上特定于应用程序的缓存目录的绝对路径。
`abstract ClassLoader`	`getClassLoader()` 返回一个你可以用来检索这个包中的类的类加载器。
`abstract File`	`getCodeCacheDir()` 返回专用于存储缓存代码的文件系统上特定于应用程序的缓存目录的绝对路径。
`final int`	`getColor(int id)` 返回与特定资源ID关联的颜色并为当前主题设计样式。
`final ColorStateList`	`getColorStateList(int id)` 返回与特定资源ID关联的颜色状态列表，并为当前主题设计风格。
`abstract ContentResolver`	`getContentResolver()` 为你的应用程序包返回一个ContentResolver实例。
`abstract File`	`getDataDir()` 返回存储属于此应用程序的所有私人文件的文件系统上目录的绝对路径。
`abstract File`	`getDatabasePath(String name)` 返回存储使用 `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)`创建的数据库的文件系统上的绝对路径。
`abstract File`	`getDir(String name, int mode)` 根据需要检索，创建应用程序可以放置自己的自定义数据文件的新目录。
`final Drawable`	`getDrawable(int id)` 返回与特定资源ID关联的可绘制对象，并为当前主题创建样式。
`abstract File`	`getExternalCacheDir()` 返回应用程序可以放置其拥有的缓存文件的主共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File[]`	`getExternalCacheDirs()` 返回应用程序可以放置它拥有的缓存文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File`	`getExternalFilesDir(String type)` 返回应用程序可以放置其拥有的持久性文件的主共享/外部存储设备上目录的绝对路径。
`abstract File[]`	`getExternalFilesDirs(String type)` 返回应用程序可以放置其拥有的持久性文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File[]`	`getExternalMediaDirs()` 返回应用程序可放置媒体文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File`	`getFileStreamPath(String name)` 返回存储使用 `openFileOutput(String, int)`创建的文件的文件系统上的绝对路径。
`abstract File`	`getFilesDir()` 返回存储用 `openFileOutput(String, int)`创建的文件的文件系统上目录的绝对路径。
`abstract Looper`	`getMainLooper()` 返回当前进程主线程的Looper。
`abstract File`	`getNoBackupFilesDir()` 返回类似于 `getFilesDir()`的文件系统上目录的绝对路径。
`abstract File`	`getObbDir()` 返回此应用程序的OBB文件（如果有）的主要共享/外部存储目录。
`abstract File[]`	`getObbDirs()` 返回应用程序的OBB文件（如果有）的所有共享/外部存储设备上的应用程序特定目录的绝对路径。
`abstract String`	`getPackageCodePath()` 返回此上下文的主要Android包的完整路径。
`abstract PackageManager`	`getPackageManager()` 返回PackageManager实例以查找全局包信息。
`abstract String`	`getPackageName()` 返回此应用程序包的名称。
`abstract String`	`getPackageResourcePath()` 返回此上下文的主要Android包的完整路径。
`abstract Resources`	`getResources()` 返回应用程序包的资源实例。
`abstract SharedPreferences`	`getSharedPreferences(String name, int mode)` 检索并保存首选项文件'name'的内容，返回一个SharedPreferences，通过它可以检索和修改其值。
`final String`	`getString(int resId, Object... formatArgs)` 从应用程序包的默认字符串表中返回一个本地化的格式化字符串，替换 `Formatter`和 `format(String, Object...)`定义的格式参数。
`final String`	`getString(int resId)` 从应用程序包的默认字符串表中返回一个本地化的字符串。
`final <T> T`	`getSystemService(Class<T> serviceClass)` 按类返回句柄到系统级服务。
`abstract Object`	`getSystemService(String name)` 按名称将句柄返回到系统级服务。
`abstract String`	`getSystemServiceName(Class<?> serviceClass)` 获取由指定的类表示的系统级服务的名称。
`final CharSequence`	`getText(int resId)` 从应用程序包的默认字符串表中返回一个本地化的，风格化的CharSequence。
`abstract Resources.Theme`	`getTheme()` 返回与此上下文关联的主题对象。
`abstract Drawable`	`getWallpaper()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.get()` 。
`abstract int`	`getWallpaperDesiredMinimumHeight()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.getDesiredMinimumHeight()` 。
`abstract int`	`getWallpaperDesiredMinimumWidth()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.getDesiredMinimumWidth()` 。
`abstract void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` 无论该软件包是否具有访问Uri内容提供者的一般权限，都可以授予访问另一个软件包的特定Uri的权限。
`abstract boolean`	`isDeviceProtectedStorage()` 指示此Context的存储API是否受设备保护存储支持。
`boolean`	`isRestricted()` 指示此上下文是否受限制。
`abstract boolean`	`moveDatabaseFrom(Context sourceContext, String name)` 将现有数据库文件从给定的源存储上下文移动到此上下文。
`abstract boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` 将现有的共享首选项文件从给定的源存储上下文移至此上下文。
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(int resid, int[] attrs)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(int[] attrs)` 在此Context的主题中检索样式化属性信息。
`abstract FileInputStream`	`openFileInput(String name)` 打开与此Context的应用程序包关联的私人文件以供阅读。
`abstract FileOutputStream`	`openFileOutput(String name, int mode)` 打开与此Context的应用程序包关联的私有文件以进行写入。
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`abstract Drawable`	`peekWallpaper()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.peek()` 。
`void`	`registerComponentCallbacks(ComponentCallbacks callback)` 将新的 `ComponentCallbacks`添加到Context的基本应用程序中，将在调用ComponentCallbacks活动方法和其他组件的同时调用该新应用程序。
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` 注册BroadcastReceiver以在主要活动线程中运行。
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` 注册以接收意图广播，以在 `调度程序`的上下文中运行。
`abstract void`	`removeStickyBroadcast(Intent intent)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`revokeUriPermission(Uri uri, int modeFlags)` 删除所有权限以访问之前与 `grantUriPermission(String, Uri, int)`一起添加的特定内容提供商Uri。
`abstract void`	`sendBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，允许强制执行可选的必需权限。
`abstract void`	`sendBroadcast(Intent intent)` 将给定的意图广播给所有感兴趣的BroadcastReceivers。
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` 版本 `sendBroadcast(Intent)` ，允许您指定广播将发送到的用户。
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` 版本 `sendBroadcast(Intent, String)` ，允许您指定广播将发送到的用户。
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本 `sendBroadcast(Intent)` ，允许您从广播接收数据。
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，一次发送一个，让更多的首选接收者在将广播发送给次优先接收者之前消费广播。
`abstract void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本 `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` ，允许您指定广播将发送到的用户。
`abstract void`	`sendStickyBroadcast(Intent intent)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`setTheme(int resid)` 为此上下文设置基本主题。
`abstract void`	`setWallpaper(Bitmap bitmap)` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract void`	`setWallpaper(InputStream data)` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract void`	`startActivities(Intent[] intents, Bundle options)` 启动多项新活动。
`abstract void`	`startActivities(Intent[] intents)` 与 `startActivities(Intent[], Bundle)`相同，没有指定选项。
`abstract void`	`startActivity(Intent intent)` 与 `startActivity(Intent, Bundle)`相同，没有指定选项。
`abstract void`	`startActivity(Intent intent, Bundle options)` 启动一项新活动。
`abstract boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` 开始执行 `Instrumentation`课程。
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` 与没有指定选项的 `startIntentSender(IntentSender, Intent, int, int, int, Bundle)`相同。
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` 像 `startActivity(Intent, Bundle)`一样，但需要启动一个IntentSender。
`abstract ComponentName`	`startService(Intent service)` 请求启动给定的应用程序服务。
`abstract boolean`	`stopService(Intent service)` 请求停止给定的应用程序服务。
`abstract void`	`unbindService(ServiceConnection conn)` 断开应用程序服务。
`void`	`unregisterComponentCallbacks(ComponentCallbacks callback)` 删除以前用 `registerComponentCallbacks(ComponentCallbacks)`注册的 `ComponentCallbacks`对象。
`abstract void`	`unregisterReceiver(BroadcastReceiver receiver)` 取消注册以前注册的BroadcastReceiver。

From class java.lang.Object

Constants

TYPE_DIRECTORY

Added in API level 14

int TYPE_DIRECTORY

在完整还原期间，指示正在还原的文件系统对象是目录。

常量值：2（0x00000002）

TYPE_FILE

Added in API level 14

int TYPE_FILE

在完全还原期间，指示正在还原的文件系统对象是普通文件。

常数值：1（0x00000001）

Public constructors

BackupAgent

Added in API level 8

BackupAgent ()

Public methods

fullBackupFile

Added in API level 14

void fullBackupFile (File file, 
                FullBackupDataOutput output)

作为完整备份操作的一部分写入整个文件。该文件的内容将被传送到备份目标以及必要的元数据，以便将其置于恢复数据的设备上的正确位置和权限。

尝试备份备份系统忽略的目录中的文件将不起作用。例如，如果应用程序使用getNoBackupFilesDir()目录中的文件调用此方法，则它将被忽略。有关从备份中排除哪些目录的详细信息，请参阅{@link #onFullBackup（FullBackupDataOutput）。

Parameters
`file`	`File`: The file to be backed up. The file must exist and be readable by the caller.
`output`	`FullBackupDataOutput`: The destination to which the backed-up file data will be sent.

onBackup

Added in API level 8

void onBackup (ParcelFileDescriptor oldState, 
                BackupDataOutput data, 
                ParcelFileDescriptor newState)

要求应用程序写入自上次执行备份操作以来更改的任何数据。上次备份过程中记录的状态数据在oldState文件描述符中提供。如果oldState是null ，则不存在旧状态，应用程序应执行完整备份。在这两种情况下，此通道之后的最终备份状态的表示应写入由newState中newState的文件描述符指向的文件。

写入BackupDataOutput data流的每个实体将通过当前的备份传输器传输，并存储在作为实体一部分提供的密钥下的远程数据集中。编写一个负数据大小的实体指示传输从远程数据集中删除该密钥下当前存在的任何实体。

Parameters
`oldState`	`ParcelFileDescriptor`: An open, read-only ParcelFileDescriptor pointing to the last backup state provided by the application. May be `null`, in which case no prior state is being provided and the application should perform a full backup.
`data`	`BackupDataOutput`: A structured wrapper around an open, read/write file descriptor pointing to the backup data destination. Typically the application will use backup helper classes to write to this file.
`newState`	`ParcelFileDescriptor`: An open, read/write ParcelFileDescriptor pointing to an empty file. The application should record the final backup state here after writing the requested data to the `data` output stream.

Throws
`IOException`

onCreate

Added in API level 8

void onCreate ()

为实际备份或恢复操作开始之前需要机会进行一次性初始化的代理实现提供便利。

onDestroy

Added in API level 8

void onDestroy ()

为备份或恢复完成后需要执行某种关闭过程的代理实现提供便利。

代理不需要重写此方法。

onFullBackup

Added in API level 14

void onFullBackup (FullBackupDataOutput data)

应用程序正在备份其整个文件系统内容。 data指向备份目标，并且应用程序有机会选择要存储哪些文件。要将文件作为备份的一部分提交，请调用fullBackupFile(File, FullBackupDataOutput)辅助方法。将所有文件数据写入输出后，代理将从此方法返回并完成备份操作。

即使应用程序明确将它们发送到输出，也不会备份应用程序数据的某些部分：

The contents of the getCacheDir() directory
The contents of the getCodeCacheDir() directory
The contents of the getNoBackupFilesDir() directory
The contents of the app's shared library directory

此方法的默认实现将整个应用程序的“拥有”文件系统树备份到输出，而不是上面列出的少数例外。应用程序只需要覆盖此方法，如果他们需要对哪些文件超出getNoBackupFilesDir()提供的控件存储特殊限制。或者，他们可以提供一个xml资源来指定要包含或排除的数据。

Parameters
`data`	`FullBackupDataOutput`: A structured wrapper pointing to the backup destination.

Throws
	IOException
`IOException`

也可以看看：

onQuotaExceeded

Added in API level 24

void onQuotaExceeded (long backupDataBytes, 
                long quotaBytes)

通知应用程序的当前备份操作导致其超过传输所允许的最大大小。正在进行的备份操作将暂停并回滚：以前的备份操作存储的任何数据仍保持不变。在通过网络实际传输任何数据之前，通常会检测配额超出状态。

quotaBytes值是此应用程序当前允许的总数据大小。如果需要，应用程序可以使用它作为确定要存储多少数据的提示。例如，消息传递应用程序可能会选择仅存储最新的消息，将足够多的旧内容放在配额下。

请注意，应用程序的最大配额可能随时间而改变。特别是在未来，配额可能会增加。在决定要存储什么数据时适应配额的应用程序应该意识到这一点，并以可以利用额外配额的方式实现其数据存储机制。

Parameters
`backupDataBytes`	`long`: The amount of data measured while initializing the backup operation, if the total exceeds the app's alloted quota. If initial measurement suggested that the data would fit but then too much data was actually submitted as part of the operation, then this value is the amount of data that had been streamed into the transport at the time the quota was reached.
`quotaBytes`	`long`: The maximum data size that the transport currently permits this application to store as a backup.

onRestore

Added in API level 8

void onRestore (BackupDataInput data, 
                int appVersionCode, 
                ParcelFileDescriptor newState)

应用程序正在从备份中恢复，并应将所有现有数据替换为备份的内容。备份数据通过data参数提供。恢复完成后，应用程序应将最终状态的表示写入newState文件描述符。

应用程序负责正确删除其旧数据，并用提供给此方法的数据替换它。操作系统不会自动执行“清除用户数据”操作。这种情况的例外是在尝试恢复失败的情况下：如果onRestore（）抛出异常，操作系统将假定应用程序的数据现在可能处于非连贯状态，并且在继续之前将清除它。

Parameters
`data`	`BackupDataInput`: A structured wrapper around an open, read-only file descriptor pointing to a full snapshot of the application's data. The application should consume every entity represented in this data stream.
`appVersionCode`	`int`: The value of the `android:versionCode` manifest attribute, from the application that backed up this particular data set. This makes it possible for an application's agent to distinguish among any possible older data versions when asked to perform the restore operation.
`newState`	`ParcelFileDescriptor`: An open, read/write ParcelFileDescriptor pointing to an empty file. The application should record the final backup state here after restoring its data from the `data` stream. When a full-backup dataset is being restored, this will be `null`.

Throws
`IOException`

onRestoreFile

Added in API level 14

void onRestoreFile (ParcelFileDescriptor data, 
                long size, 
                File destination, 
                int type, 
                long mode, 
                long mtime)

在完全恢复操作期间处理通过给定文件描述符传送的数据。该代理将获得文件原始位置的路径以及其大小和元数据。

文件描述符只能读取size字节; 试图读取更多数据有未定义的行为。

默认实现创建目标文件/目录，并使用文件描述符中的数据填充目标文件/目录，然后设置文件的访问模式和修改时间以匹配恢复参数。

Parameters
`data`	`ParcelFileDescriptor`: A read-only file descriptor from which the agent can read `size` bytes of file data.
`size`	`long`: The number of bytes of file content to be restored to the given destination. If the file system object being restored is a directory, `size` will be zero.
`destination`	`File`: The File on disk to be restored with the given data.
`type`	`int`: The kind of file system object being restored. This will be either `TYPE_FILE` or `TYPE_DIRECTORY`.
`mode`	`long`: The access mode to be assigned to the destination after its data is written. This is in the standard format used by `chmod()`.
`mtime`	`long`: The modification time of the file when it was backed up, suitable to be assigned to the file after its data is written.

Throws
`IOException`

onRestoreFinished

Added in API level 21

void onRestoreFinished ()

应用程序的还原操作已完成。在将所有可用数据传递到应用程序进行还原（通过onRestore()或onRestoreFile()回调）之后调用此方法。这为应用程序提供了稳定的恢复结束机会，以对刚刚传送的数据执行任何适当的后处理。

也可以看看：

Interfaces

Classes

Most visited

Recently visited

Results for

BackupAgent

Developer Guides

Basic Operation

Summary

Constants

Inherited constants

Public constructors

Public methods

Inherited methods

Constants

TYPE_DIRECTORY

TYPE_FILE

Public constructors

BackupAgent

Public methods

fullBackupFile

onBackup

onCreate

onDestroy

onFullBackup

onQuotaExceeded

onRestore

onRestoreFile

onRestoreFinished