meshtastic/Meshtastic-Android
1
0
Fork 0
mirror of https://github.com/meshtastic/Meshtastic-Android.git synced 2026-04-20 22:23:37 +00:00
Code Issues Projects Releases Packages Wiki Activity
Meshtastic-Android/conductor/archive/fix_android_animations_20260313/spec.md
James Rich 427c0f3bbb
fix: fix animation stalls and update dependencies for stability (#4784) 
Signed-off-by: James Rich <2199651+jamesarich@users.noreply.github.com>
2026-03-13 23:01:17 +00:00

1.7 KiB
Raw Permalink Blame History

Track Specification: Fix Android Animation Stalls (Regression)

Overview

This track aims to diagnose and resolve a regression introduced in recent 2.7.14-internal releases where animations (standard Compose progress indicators and custom transitions) fail to fire on Android. While these animations work correctly on Desktop, they are "stuck" or "stalled" on Android, likely due to threading issues or recomposition failures.

Historical Context

  • Introduction: This issue appeared during the 2.7.14-internal release cycle.
  • Comparison: Older versions or the current Desktop build can be used as references to identify code changes that might have triggered the regression.

Functional Requirements

  • Animation Restoration: Restore movement to indeterminate circular and linear progress bars, particularly on the Connections screen.
  • Transition Fixes: Ensure MeshActivity animations (entry/exit/transitions) fire as expected.
  • Project-wide Audit: Audit other screens for similar "stuck" animations.
  • KMP Parity: Ensure shared commonMain code functions correctly on both Android and Desktop.

Non-Functional Requirements

  • Performance: Ensure no UI jank or excessive recompositions.
  • Verification: Use historical code comparison (via gh or temporary copies) to isolate the breaking change.

Acceptance Criteria

  • Indeterminate progress bars on the Connections screen animate continuously.
  • MeshActivity animations fire correctly.
  • Root cause identified (Regression since 2.7.14-internal).
  • Automated UI tests verify animation behavior on Android.
  • Unit tests verify state flow if threading/ViewModels are involved.