diff options
| author | Scott Main <smain@google.com> | 2010-05-14 11:56:14 -0700 |
|---|---|---|
| committer | Android Git Automerger <android-git-automerger@android.com> | 2010-05-14 11:56:14 -0700 |
| commit | 6c034325a856f4cfb1e8b5bc97adbc7f9dffd0a2 (patch) | |
| tree | e8c6b37d912c83c1b31052f222e3515c1e1fc6d9 /core | |
| parent | f55e322216c816d7876ca98521497c58520ebf08 (diff) | |
| parent | 6d8e4fd83bb7f4eabc942dd17fa229cf9baf5fcf (diff) | |
| download | frameworks_base-6c034325a856f4cfb1e8b5bc97adbc7f9dffd0a2.zip frameworks_base-6c034325a856f4cfb1e8b5bc97adbc7f9dffd0a2.tar.gz frameworks_base-6c034325a856f4cfb1e8b5bc97adbc7f9dffd0a2.tar.bz2 | |
am 6d8e4fd8: am b83a283a: docs: add dev guide for backup
Merge commit '6d8e4fd83bb7f4eabc942dd17fa229cf9baf5fcf' into kraken
* commit '6d8e4fd83bb7f4eabc942dd17fa229cf9baf5fcf':
docs: add dev guide for backup
Diffstat (limited to 'core')
| -rw-r--r-- | core/java/android/app/backup/BackupAgent.java | 7 | ||||
| -rw-r--r-- | core/java/android/app/backup/package.html | 27 |
2 files changed, 20 insertions, 14 deletions
diff --git a/core/java/android/app/backup/BackupAgent.java b/core/java/android/app/backup/BackupAgent.java index 5245da5..cb4e0e7 100644 --- a/core/java/android/app/backup/BackupAgent.java +++ b/core/java/android/app/backup/BackupAgent.java @@ -162,9 +162,10 @@ public abstract class BackupAgent extends ContextWrapper { * file descriptor pointing to a full snapshot of the * application's data. The application should consume every * entity represented in this data stream. - * @param appVersionCode The - * {@link android.R.styleable#AndroidManifest_versionCode android:versionCode} - * value of the application that backed up this particular data set. This + * @param appVersionCode The value of the <a + * href="{@docRoot}guide/topics/manifest/manifest-element.html#vcode">{@code + * android:versionCode}</a> 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. diff --git a/core/java/android/app/backup/package.html b/core/java/android/app/backup/package.html index e2518ec..ae29994 100644 --- a/core/java/android/app/backup/package.html +++ b/core/java/android/app/backup/package.html @@ -2,23 +2,28 @@ <BODY> <p>Contains the backup and restore functionality available to applications. If a user wipes the data on their device or upgrades to a new Android-powered -device, all applications that have enabled backup will restore the user's previous data and/or -preferences. {@more} All backup management is controlled through -{@link android.app.backup.BackupManager}. Individual backup functionality is -implemented through a subclass {@link android.app.backup.BackupAgent} and a -simple and easy-to-use implementation is provided in -{@link android.app.backup.BackupAgentHelper}.</p> +device, all applications that have enabled backup will restore the user's previous data.</p> +{@more} -<p>STOPSHIP: add more documentation and remove Dev Guide link if not written!</p> +<p>All backup and restore operations are controlled by the {@link +android.app.backup.BackupManager}. Each application that would +like to enable backup and preserve its data on remote strage must implement a +backup agent. A backup agent can be built by extending either {@link android.app.backup.BackupAgent} +or {@link android.app.backup.BackupAgentHelper}. The {@link +android.app.backup.BackupAgentHelper} class provides a wrapper around {@link +android.app.backup.BackupAgent} that simplifies the procedures to implement a backup agent by +employing backup helpers such as {@link android.app.backup.SharedPreferencesBackupHelper} and +{@link android.app.backup.FileBackupHelper}.</p> <p>The backup APIs let applications:</p> <ul> - <li>Perform backup of arbitrary data</li> - <li>Easily perform backup of Preferences and files</li> - <li>Handle restore of data</li> + <li>Perform backup of arbitrary data to remote storage</li> + <li>Easily perform backup of {@link android.content.SharedPreferences} and files</li> + <li>Restore the data saved to remote storage</li> </ul> <p>For a detailed guide to using the backup APIs, see the <a -href="{@docRoot}guide/topics/backup.html">Backup Dev Guide topic</a>.</p> +href="{@docRoot}guide/topics/data/backup.html">Data Backup</a> developer guide.</p> + </BODY> </HTML> |