1 /*
2  * Copyright (C) 2017 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
5  * except in compliance with the License. You may obtain a copy of the License at
6  *
7  *      http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software distributed under the
10  * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
11  * KIND, either express or implied. See the License for the specific language governing
12  * permissions and limitations under the License.
13  */
14 
15 package com.android.systemui.statusbar.policy;
16 
17 import android.provider.Settings;
18 
19 import com.android.systemui.statusbar.policy.DeviceProvisionedController.DeviceProvisionedListener;
20 
21 /**
22  * Controller to cache in process the state of the device provisioning.
23  * <p>
24  * This controller keeps track of the values of device provisioning, user setup complete, and
25  * whether Factory Reset Protection is active.
26  */
27 public interface DeviceProvisionedController extends CallbackController<DeviceProvisionedListener> {
28 
29     /**
30      * @return whether the device is provisioned
31      * @see Settings.Global#DEVICE_PROVISIONED
32      */
isDeviceProvisioned()33     boolean isDeviceProvisioned();
34 
35     /**
36      * @deprecated use {@link com.android.systemui.settings.UserTracker}
37      */
38     @Deprecated
getCurrentUser()39     int getCurrentUser();
40 
41     /**
42      * @param user the user to query
43      * @return whether that user has completed the user setup
44      * @see Settings.Secure#USER_SETUP_COMPLETE
45      */
isUserSetup(int user)46     boolean isUserSetup(int user);
47 
48     /**
49      * @see DeviceProvisionedController#isUserSetup
50      */
isCurrentUserSetup()51     boolean isCurrentUserSetup();
52 
53     /**
54      * Interface to provide calls when the values tracked change
55      */
56     interface DeviceProvisionedListener {
57         /**
58          * Call when the device changes from not provisioned to provisioned
59          */
onDeviceProvisionedChanged()60         default void onDeviceProvisionedChanged() { }
61 
62         /**
63          * Call on user switched
64          */
onUserSwitched()65         default void onUserSwitched() {
66             onUserSetupChanged();
67         }
68 
69         /**
70          * Call when some user changes from not provisioned to provisioned
71          */
onUserSetupChanged()72         default void onUserSetupChanged() { }
73     }
74 }
75