How launcher3-dev/launcher3 works
Project context
• This is an Android-only launcher app (Launcher3).
• We’re focusing on the “widget” submodule under src/com/android/launcher3/widget.
• This submodule provides everything needed to display, add, preview and manage home-screen widgets.
1. WidgetCell
2. WidgetCellPreview
3. WidgetImageView
4. BaseLauncherAppWidgetHostView
5. NavigableAppWidgetHostView
6. PendingAppWidgetHostView
7. AddItemWidgetsBottomSheet
8. BaseWidgetSheet
9. LauncherWidgetHolder
1. WidgetManagerHelper
2. WidgetSections
3. WidgetItemComparator
1. LauncherAppWidgetHost
2. LauncherAppWidgetProviderInfo
1. DatabaseWidgetPreviewLoader
2. LocalColorExtractor
1. WidgetAddFlowHandler
2. WidgetInflater (Kotlin)
3. WidgetHostViewLoader
4. PendingItemDragHelper
5. PendingAddWidgetInfo
6. PendingAddShortcutInfo
7. WidgetSections
• Flow:
AddItemWidgetsBottomSheet
→ invokes WidgetSections to list widget categories
→ feeds selected PendingAddWidgetInfo / PendingAddShortcutInfo to WidgetAddFlowHandler
→ WidgetAddFlowHandler
• uses WidgetManagerHelper to resolve provider info
• uses LauncherAppWidgetHost & ProviderInfo model to allocate IDs
• inflates the host view via WidgetHostViewLoader & WidgetInflater
• displays in BaseWidgetSheet / BottomSheet
• Preview & coloring:
WidgetCell → WidgetCellPreview → DatabaseWidgetPreviewLoader
• Host & navigation:
LauncherAppWidgetHost
→ instantiates BaseLauncherAppWidgetHostView
→ can navigate internally via NavigableAppWidgetHostView
→ handles pending via PendingAppWidgetHostView
• Sorting & organization:
WidgetSections groups by category
WidgetItemComparator orders items within a section
Details to capture
• Explicitly show PendingAddWidgetInfo and PendingAddShortcutInfo feeding into WidgetAddFlowHandler.
• LauncherAppWidgetHost interacting with provider info model.
• DatabaseWidgetPreviewLoader’s relationship to LocalColorExtractor and WidgetImageView.
• WidgetSections as the entry point for the sheet’s content grouping.
Summary
– Identify components (as above),
– Label everything clearly.