tree: bb5263b341bc60a826432b1f726a0a9afa0707db [path history] [tgz]
  1. accessibility/
  2. aconfig/
  3. animation/
  4. checks/
  5. common/
  6. communal/
  7. compose/
  8. customization/
  9. docs/
  10. log/
  11. monet/
  12. multivalentTests/
  13. plugin/
  14. plugin_core/
  15. res/
  16. res-keyguard/
  17. res-product/
  18. scripts/
  19. shared/
  20. src/
  21. src-debug/
  22. src-release/
  23. tests/
  24. tools/
  25. unfold/
  26. Android.bp
  27. AndroidManifest-res.xml
  28. AndroidManifest.xml
  29. CleanSpec.mk
  30. flag_check.py
  31. lint.xml
  32. MODULE_LICENSE_APACHE2
  33. NOTICE
  34. OWNERS
  35. proguard.flags
  36. proguard_common.flags
  37. README.md
  38. TEST_MAPPING
packages/SystemUI/README.md

SystemUI

“Everything you see in Android that's not an app”

SystemUI is a persistent process that provides UI for the system but outside of the system_server process.

Inputs directed at sysui (as opposed to general listeners) generally come in through IStatusBar. Outputs from sysui are through a variety of private APIs to the android platform all over.

SystemUIApplication

When SystemUIApplication starts up, it instantiates a Dagger graph from which various pieces of the application are built.

To support customization, SystemUIApplication relies on the AndroidManifest.xml having an android.app.AppComponentFactory specified. Specifically, it relies on an AppComponentFactory that subclases SystemUIAppComponentFactoryBase. Implementations of this abstract base class must override #createSystemUIInitializer(Context) which returns a SystemUIInitializer. SystemUIInitializer primary job in turn is to intialize and return the Dagger root component back to the SystemUIApplication.

Writing a custom SystemUIAppComponentFactoryBase and SystemUIInitializer, should be enough for most implementations to stand up a customized Dagger graph, and launch a custom version of SystemUI.

Dagger / Dependency Injection

See dagger.md and https://dagger.dev/.

CoreStartable

The starting point for most of SystemUI code is a list of classes that implement CoreStartable that are started up by SystemUIApplication. CoreStartables are like miniature services. They have their #start method called after being instantiated, and a reference to them is stored inside SystemUIApplication. They are in charge of their own behavior beyond this, registering and unregistering with the rest of the system as needed.

CoreStartable also receives a callback for #onBootCompleted since these objects may be started before the device has finished booting.

CoreStartable is an ideal place to add new features and functionality that does not belong directly under the umbrella of an existing feature. It is better to define a new CoreStartable than to stick unrelated initialization code together in catch-all methods.

CoreStartables are tied to application startup via Dagger:

class FeatureStartable
@Inject
constructor(
    /* ... */
) : CoreStartable {
    override fun start() {
        // ...
    }
}

@Module
abstract class FeatureModule {
    @Binds
    @IntoMap
    @ClassKey(FeatureStartable::class)
    abstract fun bind(impl: FeatureStartable): CoreStartable
}

Including FeatureModule in the Dagger graph such as this will ensure that FeatureStartable gets constructed and that its #start method is called.

IStatusBar

CommandQueue is the object that receives all of the incoming events from the system_server. It extends IStatusBar and dispatches those callbacks back any number of listeners. The system_server gets a hold of the IStatusBar when StatusBar calls IStatusBarService#registerStatusBar, so if StatusBar is not included in the XML service list, it will not be registered with the OS.

CommandQueue posts all incoming callbacks to a handler and then dispatches those messages to each callback that is currently registered. CommandQueue also tracks the current value of disable flags and will call #disable immediately for any callbacks added.

There are a few places where CommandQueue is used as a bus to communicate across sysui. Such as when StatusBar calls CommandQueue#recomputeDisableFlags. This is generally used a shortcut to directly trigger CommandQueue rather than calling StatusManager and waiting for the call to come back to IStatusBar.

com.android.systemui.util.NotificationChannels

Creates/initializes the channels sysui uses when posting notifications.

com.android.systemui.keyguard.KeyguardViewMediator

Manages keyguard view state.

com.android.systemui.recents.Recents

Recents tracks all the data needed for recents and starts/stops the recents activity. It provides this cached data to RecentsActivity when it is started.

com.android.systemui.volume.VolumeUI

Registers all the callbacks/listeners required to show the Volume dialog when it should be shown.

com.android.systemui.status.phone.CentralSurfaces

This shows the UI for the status bar and the notification shade it contains. It also contains a significant amount of other UI that interacts with these surfaces (keyguard, AOD, etc.). CentralSurfaces also contains a notification listener to receive notification callbacks.

com.android.systemui.usb.StorageNotification

Tracks USB status and sends notifications for it.

com.android.systemui.power.PowerUI

Tracks power status and sends notifications for low battery/power saver.

com.android.systemui.media.RingtonePlayer

Plays ringtones.

com.android.systemui.keyboard.KeyboardUI

Shows UI for keyboard shortcuts (triggered by keyboard shortcut).

com.android.systemui.shortcut.ShortcutKeyDispatcher

Dispatches shortcut to System UI components.

@string/config_systemUIVendorServiceComponent

Component allowing the vendor/OEM to inject a custom component.

com.android.systemui.util.leak.GarbageMonitor$Service

Tracks large objects in sysui to see if there are leaks.

com.android.systemui.LatencyTester

Class that only runs on debuggable builds that listens to broadcasts that simulate actions in the system that are used for testing the latency.

com.android.systemui.globalactions.GlobalActionsComponent

Shows the global actions dialog (long-press power).

com.android.systemui.ScreenDecorations

Draws decorations about the screen in software (e.g. rounded corners, cutouts).

com.android.systemui.biometrics.BiometricDialogImpl

Biometric UI.

com.android.systemui.wmshell.WMShell

Delegates SysUI events to WM Shell controllers.