Meshtastic-Android/conductor/archive/migrate_debug_panel_20260319/plan.md
James Rich 00697cc3c1
feat: KMP Debug Panel Migration and Update Documentation (#4859)
Signed-off-by: James Rich <2199651+jamesarich@users.noreply.github.com>
2026-03-19 19:07:03 +00:00

1.7 KiB

Implementation Plan: Debug Panel KMP Migration

Phase 1: Analysis and Relocation [checkpoint: a2e83eb]

  • Task: Locate all source files for the Android Debug Panel (UI, ViewModels, States).
  • Task: Move these files from the Android-specific source sets (e.g., feature/settings/src/androidMain) into feature/settings/src/commonMain.
  • Task: Conductor - User Manual Verification 'Phase 1: Analysis and Relocation' (Protocol in workflow.md)

Phase 2: Adaptation to KMP [checkpoint: 834f42c]

  • Task: Resolve compilation errors by removing Android-specific imports (android.*, java.*).
  • Task: Migrate Android Jetpack Compose imports (androidx.compose) to Compose Multiplatform equivalents (org.jetbrains.compose.* or ensuring the standard Multiplatform aliases are used).
  • Task: Ensure the Debug Panel ViewModel uses the multiplatform androidx.lifecycle.ViewModel.
  • Task: Abstract any necessary platform-specific logging or hardware interactions using expect/actual or KMP interfaces.
  • Task: Write or migrate corresponding unit tests to commonTest.
  • Task: Conductor - User Manual Verification 'Phase 2: Adaptation to KMP' (Protocol in workflow.md)

Phase 3: Desktop Integration [checkpoint: de2ae06]

  • Task: Wire the Debug Panel into the Desktop target's settings menu (DesktopSettingsNavigation.kt).
  • Task: Add DI bindings for the Desktop module if the Debug Panel requires specific dependencies.
  • Task: Verify the Debug Panel screen can be opened and navigated to from the Desktop app.
  • Task: Conductor - User Manual Verification 'Phase 3: Desktop Integration' (Protocol in workflow.md)

Phase: Review Fixes

  • Task: Apply review suggestions ac69e73