1 /*
2  * Copyright (C) 2011 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package android.app.backup;
18 
19 /**
20  * Observer of a full backup or restore process.  The observer is told "interesting"
21  * information about an ongoing full backup or restore action.
22  *
23  * {@hide}
24  */
25 
26 oneway interface IFullBackupRestoreObserver {
27     /**
28      * Notification: a full backup operation has begun.
29      */
onStartBackup()30     void onStartBackup();
31 
32     /**
33      * Notification: the system has begun backing up the given package.
34      *
35      * @param name The name of the application being saved.  This will typically be a
36      *     user-meaningful name such as "Browser" rather than a package name such as
37      *     "com.android.browser", though this is not guaranteed.
38      */
onBackupPackage(String name)39     void onBackupPackage(String name);
40 
41     /**
42      * Notification: the full backup operation has ended.
43      */
onEndBackup()44     void onEndBackup();
45 
46     /**
47      * Notification: a restore-from-full-backup operation has begun.
48      */
onStartRestore()49     void onStartRestore();
50 
51     /**
52      * Notification: the system has begun restore of the given package.
53      *
54      * @param name The name of the application being saved.  This will typically be a
55      *     user-meaningful name such as "Browser" rather than a package name such as
56      *     "com.android.browser", though this is not guaranteed.
57      */
onRestorePackage(String name)58     void onRestorePackage(String name);
59 
60     /**
61      * Notification: the restore-from-full-backup operation has ended.
62      */
onEndRestore()63     void onEndRestore();
64 
65     /**
66      * The user's window of opportunity for confirming the operation has timed out.
67      */
onTimeout()68     void onTimeout();
69 }
70