Skip to content

A cross platform Audiobookshelf client for Android and iOS

Dart

Add [Battery] debug logging for background activity audit

Nathan Poulsonfb97aef69616
diff --git a/lib/screens/app_shell.dart b/lib/screens/app_shell.dart
index f3bbb1e1..8df1a170 100644
--- a/lib/screens/app_shell.dart
+++ b/lib/screens/app_shell.dart
@@ -344,6 +344,7 @@ class _AppShellState extends State<AppShell> with WidgetsBindingObserver, Ticker
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
+ debugPrint('[Battery] AppShell lifecycle: $state (playing=${AudioPlayerService().isPlaying})');
if (state == AppLifecycleState.resumed) {
context.read<LibraryProvider>().onAppForegrounded();
SleepTimerService().onAppForegrounded();
diff --git a/lib/services/audio_player_service.dart b/lib/services/audio_player_service.dart
index b8b50d20..d11f3aca 100644
--- a/lib/services/audio_player_service.dart
+++ b/lib/services/audio_player_service.dart
@@ -1048,6 +1048,7 @@ class AudioPlayerService extends ChangeNotifier {
androidWillPauseWhenDucked: true,
));
await session.setActive(true);
+ debugPrint('[Battery] AudioSession ACTIVATED');
_interruptSub?.cancel();
_interruptSub = session.interruptionEventStream.listen((event) async {
@@ -1717,8 +1718,10 @@ class AudioPlayerService extends ChangeNotifier {
void _updateWakeLock(bool playing) {
if (PlayerSettings.keepScreenAwake && playing) {
+ debugPrint('[Battery] WakeLock ENABLED (playing=$playing, keepScreenAwake=true)');
WakelockPlus.enable();
} else {
+ debugPrint('[Battery] WakeLock DISABLED (playing=$playing, keepScreenAwake=${PlayerSettings.keepScreenAwake})');
WakelockPlus.disable();
}
}
@@ -1744,12 +1747,14 @@ class AudioPlayerService extends ChangeNotifier {
_completionSub?.cancel();
_completionSub = null;
_lastKnownPositionSec = 0;
+ if (_bgSaveTimer != null) debugPrint('[Battery] bgSaveTimer CANCELLED (clearState)');
_bgSaveTimer?.cancel();
_bgSaveTimer = null;
_eqSessionSub?.cancel();
_eqSessionSub = null;
_streamRetryCount = 0;
_retryInProgress = false;
+ if (_stuckCheckTimer != null) debugPrint('[Battery] stuckCheckTimer CANCELLED (clearState)');
_stuckCheckTimer?.cancel();
_stuckCheckTimer = null;
_resetStuckDetection();
@@ -1864,7 +1869,9 @@ class AudioPlayerService extends ChangeNotifier {
// Safety-net timer for position persistence when Android throttles the
// Dart position stream in the background. The primary positionStream
// listener saves every 5s; this only matters when that stream goes silent.
+ debugPrint('[Battery] bgSaveTimer STARTED (30s interval)');
_bgSaveTimer = Timer.periodic(const Duration(seconds: 30), (_) async {
+ debugPrint('[Battery] bgSaveTimer TICK (playing=${_player?.playing}, item=$_currentItemId)');
if (_currentItemId == null || _player == null || !_player!.playing) return;
final pos = position;
final posSec = pos.inMilliseconds / 1000.0;
@@ -1895,6 +1902,7 @@ class AudioPlayerService extends ChangeNotifier {
_attemptStreamRetry(e);
});
+ debugPrint('[Battery] positionStream SUBSCRIBED');
_syncSub = _player?.positionStream.listen((trackRelativePos) async {
// Reset retry counter on successful position updates
_streamRetryCount = 0;
@@ -2047,6 +2055,7 @@ class AudioPlayerService extends ChangeNotifier {
_stuckCheckTimer?.cancel();
_resetStuckDetection();
+ debugPrint('[Battery] stuckCheckTimer STARTED (3s interval)');
_stuckCheckTimer = Timer.periodic(const Duration(seconds: 3), (_) async {
// Only check while actively playing
if (_player == null || !_player!.playing) {
@@ -2351,6 +2360,7 @@ class AudioPlayerService extends ChangeNotifier {
}
// Release audio focus so other apps can use it
if (!_audioFocusDisabled) {
+ debugPrint('[Battery] AudioSession DEACTIVATED (pause timeout)');
try { (await AudioSession.instance).setActive(false); } catch (_) {}
}
// Cancel sleep timer
@@ -2540,6 +2550,7 @@ class AudioPlayerService extends ChangeNotifier {
// Release audio focus so other apps can use it - but not during casting,
// because deactivating the session can interfere with cast playback.
if (!_audioFocusDisabled && !ChromecastService().isCasting) {
+ debugPrint('[Battery] AudioSession DEACTIVATED (stop)');
try { (await AudioSession.instance).setActive(false); } catch (_) {}
}
}
diff --git a/lib/services/home_widget_service.dart b/lib/services/home_widget_service.dart
index fe7d21b3..402800ef 100644
--- a/lib/services/home_widget_service.dart
+++ b/lib/services/home_widget_service.dart
@@ -295,12 +295,15 @@ class HomeWidgetService {
void _startProgressTimer() {
if (_progressTimer?.isActive == true) return;
+ debugPrint('[Battery] HomeWidget progressTimer STARTED (60s interval)');
_progressTimer = Timer.periodic(const Duration(seconds: 60), (_) {
+ debugPrint('[Battery] HomeWidget progressTimer TICK');
_scheduleUpdate();
});
}
void _stopProgressTimer() {
+ if (_progressTimer != null) debugPrint('[Battery] HomeWidget progressTimer STOPPED');
_progressTimer?.cancel();
_progressTimer = null;
}
diff --git a/lib/services/sleep_timer_service.dart b/lib/services/sleep_timer_service.dart
index 10aba16a..508deebb 100644
--- a/lib/services/sleep_timer_service.dart
+++ b/lib/services/sleep_timer_service.dart
@@ -343,6 +343,7 @@ class SleepTimerService extends ChangeNotifier {
_timer = null;
_positionSub?.cancel();
_positionSub = null;
+ if (_accelSub != null) debugPrint('[Battery] Accelerometer stream STOPPED');
_accelSub?.cancel();
_accelSub = null;
_mode = SleepTimerMode.off;
@@ -375,6 +376,7 @@ class SleepTimerService extends ChangeNotifier {
if (_shakeMode == 'off') return;
_accelSub?.cancel();
+ debugPrint('[Battery] Accelerometer stream STARTED (shakeMode=$_shakeMode)');
_accelSub = userAccelerometerEventStream().listen((event) {
final magnitude = sqrt(
event.x * event.x + event.y * event.y + event.z * event.z);
diff --git a/lib/services/socket_service.dart b/lib/services/socket_service.dart
index 8eb42b36..e534efe4 100644
--- a/lib/services/socket_service.dart
+++ b/lib/services/socket_service.dart
@@ -182,7 +182,7 @@ class SocketService {
/// cheaply reconnect later without re-wiring everything.
void softDisconnect() {
if (_socket == null) return;
- debugPrint('[Socket] Soft disconnect (battery saving)');
+ debugPrint('[Battery] Socket DISCONNECTED (soft, battery saving)');
_socket!.dispose();
_socket = null;
}
@@ -206,7 +206,7 @@ class SocketService {
final url = _serverUrl;
final token = _token;
if (url == null || token == null) return;
- debugPrint('[Socket] Soft reconnect');
+ debugPrint('[Battery] Socket RECONNECTED (soft)');
try {
_socket = io.io(url, _buildOptions());
diff --git a/lib/widgets/card_edge_progress_bar.dart b/lib/widgets/card_edge_progress_bar.dart
index af094431..4a2d0c47 100644
--- a/lib/widgets/card_edge_progress_bar.dart
+++ b/lib/widgets/card_edge_progress_bar.dart
@@ -101,10 +101,12 @@ class _CardEdgeProgressBarState extends State<CardEdgeProgressBar>
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
if (state == AppLifecycleState.resumed) {
+ debugPrint('[Battery] CardEdgeProgressBar RESUMED');
_backgrounded = false;
_loadSettings();
_syncTicker();
} else if (state == AppLifecycleState.paused) {
+ debugPrint('[Battery] CardEdgeProgressBar PAUSED - stopping ticker');
_backgrounded = true;
_smoothTicker?.cancel();
_smoothTicker = null;
@@ -120,11 +122,13 @@ class _CardEdgeProgressBarState extends State<CardEdgeProgressBar>
void _syncTicker() {
final shouldRun = _isPlaying && (widget.isActive || _isCastMode) && !_backgrounded;
if (shouldRun && _smoothTicker == null) {
+ debugPrint('[Battery] CardEdgeProgressBar ticker STARTED (playing=$_isPlaying, active=${widget.isActive}, bg=$_backgrounded)');
_smoothTicker = Timer.periodic(const Duration(milliseconds: 100), (_) {
// ignore: invalid_use_of_protected_member, invalid_use_of_visible_for_testing_member
_tickNotifier.notifyListeners();
});
} else if (!shouldRun && _smoothTicker != null) {
+ debugPrint('[Battery] CardEdgeProgressBar ticker STOPPED (playing=$_isPlaying, active=${widget.isActive}, bg=$_backgrounded)');
_smoothTicker!.cancel();
_smoothTicker = null;
}
diff --git a/lib/widgets/card_progress_bar.dart b/lib/widgets/card_progress_bar.dart
index 30735bd0..bb52c9eb 100644
--- a/lib/widgets/card_progress_bar.dart
+++ b/lib/widgets/card_progress_bar.dart
@@ -72,10 +72,12 @@ class _CardDualProgressBarState extends State<CardDualProgressBar> with WidgetsB
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
if (state == AppLifecycleState.resumed) {
+ debugPrint('[Battery] CardDualProgressBar RESUMED');
_backgrounded = false;
_loadSettings();
_syncTicker();
} else if (state == AppLifecycleState.paused) {
+ debugPrint('[Battery] CardDualProgressBar PAUSED - stopping ticker');
_backgrounded = true;
_smoothTicker?.cancel();
_smoothTicker = null;
@@ -91,11 +93,13 @@ class _CardDualProgressBarState extends State<CardDualProgressBar> with WidgetsB
void _syncTicker() {
final shouldRun = _isPlaying && (widget.isActive || _isCastMode) && !_backgrounded;
if (shouldRun && _smoothTicker == null) {
+ debugPrint('[Battery] CardDualProgressBar ticker STARTED (playing=$_isPlaying, active=${widget.isActive}, bg=$_backgrounded)');
_smoothTicker = Timer.periodic(const Duration(milliseconds: 100), (_) {
// ignore: invalid_use_of_protected_member, invalid_use_of_visible_for_testing_member
_tickNotifier.notifyListeners();
});
} else if (!shouldRun && _smoothTicker != null) {
+ debugPrint('[Battery] CardDualProgressBar ticker STOPPED (playing=$_isPlaying, active=${widget.isActive}, bg=$_backgrounded)');
_smoothTicker!.cancel();
_smoothTicker = null;
}