diff options
author | kwaky <kwaky@google.com> | 2020-02-28 11:14:37 -0800 |
---|---|---|
committer | kwaky <kwaky@google.com> | 2020-03-05 16:03:51 -0800 |
commit | 198b5dc318106f066f7b5af5ed22b97cb4db0d1f (patch) | |
tree | 4ec228231269636b4bb366f2268c9ea4a6a62dc0 /packages/SystemUI/src/com/android/keyguard/KeyguardViewController.java | |
parent | e6750fd522b0cc06a1c78b584676c13f82181179 (diff) |
DO NOT MERGE Create KeyguardViewController that extracts view-related logic in KeyguardViewMediator and re-wire Dagger accordingly.
Prior to this change, KeyguardViewMediator used StatusBarKeyguardViewManager for making view-related changes.
This meant that KeyguardViewMediator could only be used with a specific Keyguard view that is mounted to the StatusBar.
This change makes KeyguardViewMediator compatible with any Keyguard view no matter where it is mounted, as long as it implements
the methods defined in the KeyguardViewController interface.
For AAOS, This refactorization allows us to implements our own Keyguard View and its Manager as the next step.
Bug: 150467593
Test: Build and Manual Test -- Android builds successfully on Hawk and Pixel 2 and interacting with Keyguard functionalities works.
Change-Id: Idda93514eac030f1d92523aebc9444a4d55b21d2
Diffstat (limited to 'packages/SystemUI/src/com/android/keyguard/KeyguardViewController.java')
-rw-r--r-- | packages/SystemUI/src/com/android/keyguard/KeyguardViewController.java | 174 |
1 files changed, 174 insertions, 0 deletions
diff --git a/packages/SystemUI/src/com/android/keyguard/KeyguardViewController.java b/packages/SystemUI/src/com/android/keyguard/KeyguardViewController.java new file mode 100644 index 000000000000..fc29f5cddb26 --- /dev/null +++ b/packages/SystemUI/src/com/android/keyguard/KeyguardViewController.java @@ -0,0 +1,174 @@ +/* + * Copyright (C) 2020 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.android.keyguard; + +import android.os.Bundle; +import android.view.View; +import android.view.ViewGroup; +import android.view.ViewRootImpl; + +import com.android.systemui.keyguard.DismissCallbackRegistry; +import com.android.systemui.keyguard.KeyguardViewMediator; +import com.android.systemui.plugins.FalsingManager; +import com.android.systemui.statusbar.phone.BiometricUnlockController; +import com.android.systemui.statusbar.phone.KeyguardBypassController; +import com.android.systemui.statusbar.phone.NotificationPanelViewController; +import com.android.systemui.statusbar.phone.StatusBar; + +/** + * Interface to control Keyguard View. It should be implemented by KeyguardViewManagers, which + * should, in turn, be injected into {@link KeyguardViewMediator}. + */ +public interface KeyguardViewController { + /** + * Shows Keyguard. + * @param options + */ + void show(Bundle options); + + /** + * Hides Keyguard with the fade-out animation as configured by the parameters provided. + * + * @param startTime + * @param fadeoutDuration + */ + void hide(long startTime, long fadeoutDuration); + + /** + * Resets the state of Keyguard View. + * @param hideBouncerWhenShowing + */ + void reset(boolean hideBouncerWhenShowing); + + /** + * Called when the device started going to sleep. + */ + void onStartedGoingToSleep(); + + /** + * Called when the device has finished going to sleep. + */ + void onFinishedGoingToSleep(); + + /** + * Called when the device started waking up. + */ + void onStartedWakingUp(); + + /** + * Called when the device started turning on. + */ + void onScreenTurningOn(); + + /** + * Called when the device has finished turning on. + */ + void onScreenTurnedOn(); + + /** + * Sets whether the Keyguard needs input. + * @param needsInput + */ + void setNeedsInput(boolean needsInput); + + /** + * Called when cancel button in bouncer is pressed. + */ + void onCancelClicked(); + + /** + * Sets whether the keyguard is occluded by another window. + * + * @param occluded + * @param animate + */ + void setOccluded(boolean occluded, boolean animate); + + /** + * @return Whether the keyguard is showing + */ + boolean isShowing(); + + /** + * Dismisses the keyguard by going to the next screen or making it gone. + */ + void dismissAndCollapse(); + + /** + * Notifies that Keyguard is just about to go away. + */ + void keyguardGoingAway(); + + /** + * @return Whether window animation for unlock should be disabled. + */ + boolean shouldDisableWindowAnimationsForUnlock(); + + /** + * @return Whether the keyguard is going to notification shade. + */ + boolean isGoingToNotificationShade(); + + /** + * @return Whether subtle animation should be used for unlocking the device. + */ + boolean isUnlockWithWallpaper(); + + /** + * @return Whether subtle animation should be used for unlocking the device. + */ + boolean shouldSubtleWindowAnimationsForUnlock(); + + /** + * Starts the animation before we dismiss Keyguard, i.e. an disappearing animation on the + * security view of the bouncer. + * + * @param finishRunnable the runnable to be run after the animation finished, or {@code null} if + * no action should be run + */ + void startPreHideAnimation(Runnable finishRunnable); + + /** + * @return the ViewRootImpl of the View where the Keyguard is mounted. + */ + ViewRootImpl getViewRootImpl(); + + // TODO: Deprecate registerStatusBar in KeyguardViewController interface. It is currently + // only used for testing purposes in StatusBarKeyguardViewManager, and it prevents us from + // achieving complete abstraction away from where the Keyguard View is mounted. + + /** + * Registers the StatusBar to which this Keyguard View is mounted. + * + * @param statusBar + * @param container + * @param notificationPanelViewController + * @param biometricUnlockController + * @param dismissCallbackRegistry + * @param lockIconContainer + * @param notificationContainer + * @param bypassController + * @param falsingManager + */ + void registerStatusBar(StatusBar statusBar, + ViewGroup container, + NotificationPanelViewController notificationPanelViewController, + BiometricUnlockController biometricUnlockController, + DismissCallbackRegistry dismissCallbackRegistry, + ViewGroup lockIconContainer, View notificationContainer, + KeyguardBypassController bypassController, FalsingManager falsingManager); +} |