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 /** Returns true when Factory Reset Protection is locking the device. */ isFrpActive()54 boolean isFrpActive(); 55 56 /** 57 * Interface to provide calls when the values tracked change 58 */ 59 interface DeviceProvisionedListener { 60 /** 61 * Call when the device changes from not provisioned to provisioned 62 */ onDeviceProvisionedChanged()63 default void onDeviceProvisionedChanged() { } 64 65 /** 66 * Call on user switched 67 */ onUserSwitched()68 default void onUserSwitched() { 69 onUserSetupChanged(); 70 } 71 72 /** 73 * Call when some user changes from not provisioned to provisioned 74 */ onUserSetupChanged()75 default void onUserSetupChanged() { } 76 77 /** 78 * Called when the state of FRP changes. 79 */ onFrpActiveChanged()80 default void onFrpActiveChanged() {} 81 } 82 } 83