From f2b189458541e22b24c02426353c4b0288365a72 Mon Sep 17 00:00:00 2001 From: Peter Kalauskas Date: Wed, 16 Nov 2022 15:14:17 -0800 Subject: [PATCH] New javadoc for SysUI CoreStartables Test: n/a Bug: 259474752 Change-Id: Ide39a7bef9852980f5d8ad4c075edd0e4b53386b --- .../src/com/android/systemui/CoreStartable.java | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/packages/SystemUI/src/com/android/systemui/CoreStartable.java b/packages/SystemUI/src/com/android/systemui/CoreStartable.java index 929ebea37eef0..becf5b39e9dfc 100644 --- a/packages/SystemUI/src/com/android/systemui/CoreStartable.java +++ b/packages/SystemUI/src/com/android/systemui/CoreStartable.java @@ -39,10 +39,13 @@ import java.io.PrintWriter; */ public interface CoreStartable extends Dumpable { - /** Main entry point for implementations. Called shortly after app startup. */ + /** Main entry point for implementations. Called shortly after SysUI startup. */ void start(); - /** */ + /** Called when the device configuration changes. This will not be called before + * {@link #start()}, but it could be called before {@link #onBootCompleted()}. + * + * @see android.app.Application#onConfigurationChanged(Configuration) */ default void onConfigurationChanged(Configuration newConfig) { } @@ -50,7 +53,11 @@ public interface CoreStartable extends Dumpable { default void dump(@NonNull PrintWriter pw, @NonNull String[] args) { } - /** Called when the device reports BOOT_COMPLETED. */ + /** Called immediately after the system broadcasts + * {@link android.content.Intent#ACTION_LOCKED_BOOT_COMPLETED} or during SysUI startup if the + * property {@code sys.boot_completed} is already set to 1. The latter typically occurs when + * starting a new SysUI instance, such as when starting SysUI for a secondary user. + * {@link #onBootCompleted()} will never be called before {@link #start()}. */ default void onBootCompleted() { } }