Skip to content

A cross platform Audiobookshelf client for Android and iOS

Dart

Add pre-release update toggle for GitHub builds

Barnabas405c0d24d4f8
diff --git a/lib/screens/app_shell.dart b/lib/screens/app_shell.dart
index e4293a9c..f2c5fa2c 100644
--- a/lib/screens/app_shell.dart
+++ b/lib/screens/app_shell.dart
@@ -21,6 +21,7 @@ import 'stats_screen.dart';
import 'settings_screen.dart';
import '../widgets/welcome_sheet.dart';
import '../services/update_checker_service.dart';
+import '../services/player_settings.dart';
import 'package:url_launcher/url_launcher.dart';
class AppShell extends StatefulWidget {
@@ -206,13 +207,14 @@ class _AppShellState extends State<AppShell> with WidgetsBindingObserver, Ticker
void _checkForUpdate() async {
if (!_isGithubBuild) return;
- final info = await UpdateCheckerService.check();
+ final includePreReleases = await PlayerSettings.getIncludePreReleases();
+ final info = await UpdateCheckerService.check(includePreReleases: includePreReleases);
if (info == null || !mounted) return;
showDialog(
context: context,
builder: (ctx) => AlertDialog(
- title: Text('Update available'),
- content: Text('A new version of Absorb is available: ${info.latestVersion}\n\nYou are on ${info.currentVersion}.'),
+ title: Text(info.isPreRelease ? 'Pre-release available' : 'Update available'),
+ content: Text('A new ${info.isPreRelease ? 'pre-release' : 'version'} of Absorb is available: ${info.latestVersion}\n\nYou are on ${info.currentVersion}.'),
actions: [
TextButton(
onPressed: () {
diff --git a/lib/screens/settings_screen.dart b/lib/screens/settings_screen.dart
index ff172114..b43ed3d2 100644
--- a/lib/screens/settings_screen.dart
+++ b/lib/screens/settings_screen.dart
@@ -85,6 +85,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
bool _keepScreenAwake = false;
bool _disableAudioFocus = false;
bool _trustAllCerts = false;
+ bool _includePreReleases = false;
bool _loaded = false;
String _downloadLocationLabel = 'App Internal Storage (Default)';
bool _canPickDownloadLocation = false;
@@ -189,6 +190,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
PlayerSettings.getCoverPlayButton(), // 41
PlayerSettings.getSkipChapterBarrier(), // 42
PlayerSettings.getShowExplicitBadge(), // 43
+ PlayerSettings.getIncludePreReleases(), // 44
]);
final s = results[0] as AutoRewindSettings;
final speed = results[1] as double;
@@ -232,6 +234,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
final coverPlay = results[39] as bool;
final skipBarrier = results[40] as bool;
final showExplicit = results[41] as bool;
+ final preReleases = results[42] as bool;
if (mounted) setState(() {
_rewindSettings = s;
_defaultSpeed = speed;
@@ -279,6 +282,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
_skipChapterBarrier = skipBarrier;
_trustAllCerts = trustCerts;
_showExplicitBadge = showExplicit;
+ _includePreReleases = preReleases;
_canPickDownloadLocation = !_isPlayStoreBuild;
_loaded = true;
@@ -1839,6 +1843,27 @@ class _SettingsScreenState extends State<SettingsScreen> {
applyTrustAllCerts(v);
} : null,
),
+ if (_isGithubBuild) ...[
+ const Divider(height: 1, indent: 16, endIndent: 16),
+ SwitchListTile(
+ title: Row(children: [
+ const Flexible(child: Text('Include pre-releases')),
+ _infoIcon('Pre-release Updates',
+ 'When enabled, the update checker will also notify you about alpha and pre-release builds from GitHub. '
+ 'These may be less stable but include the latest features and fixes.'),
+ ]),
+ subtitle: Text(
+ _includePreReleases
+ ? 'On - checking for alpha & pre-release builds'
+ : 'Off - stable releases only',
+ style: tt.bodySmall?.copyWith(color: cs.onSurfaceVariant)),
+ value: _includePreReleases,
+ onChanged: _loaded ? (v) async {
+ setState(() => _includePreReleases = v);
+ await PlayerSettings.setIncludePreReleases(v);
+ } : null,
+ ),
+ ],
],
),
const SizedBox(height: 16),
@@ -1964,7 +1989,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
const SizedBox(height: 4),
Center(child: TextButton.icon(
onPressed: () async {
- final info = await UpdateCheckerService.check(force: true);
+ final info = await UpdateCheckerService.check(force: true, includePreReleases: _includePreReleases);
if (!mounted) return;
if (info == null || !info.hasUpdate) {
ScaffoldMessenger.of(context).showSnackBar(
@@ -1975,8 +2000,8 @@ class _SettingsScreenState extends State<SettingsScreen> {
showDialog(
context: context,
builder: (ctx) => AlertDialog(
- title: const Text('Update available'),
- content: Text('A new version of Absorb is available: ${info.latestVersion}\n\nYou are on ${info.currentVersion}.'),
+ title: Text(info.isPreRelease ? 'Pre-release available' : 'Update available'),
+ content: Text('A new ${info.isPreRelease ? 'pre-release' : 'version'} of Absorb is available: ${info.latestVersion}\n\nYou are on ${info.currentVersion}.'),
actions: [
TextButton(
onPressed: () => Navigator.pop(ctx),
diff --git a/lib/services/player_settings.dart b/lib/services/player_settings.dart
index 99af2b2c..87cd8c26 100644
--- a/lib/services/player_settings.dart
+++ b/lib/services/player_settings.dart
@@ -320,6 +320,17 @@ class PlayerSettings {
await prefs.setBool('trustAllCerts', value);
}
+ // ── Pre-release updates (GitHub build only) ──
+
+ static Future<bool> getIncludePreReleases() async {
+ final prefs = await SharedPreferences.getInstance();
+ return prefs.getBool('includePreReleases') ?? false;
+ }
+ static Future<void> setIncludePreReleases(bool value) async {
+ final prefs = await SharedPreferences.getInstance();
+ await prefs.setBool('includePreReleases', value);
+ }
+
// ── Local server ──
static Future<bool> getLocalServerEnabled() => _get('localServerEnabled', false);
diff --git a/lib/services/update_checker_service.dart b/lib/services/update_checker_service.dart
index 4a814ac3..7f94fb25 100644
--- a/lib/services/update_checker_service.dart
+++ b/lib/services/update_checker_service.dart
@@ -9,12 +9,14 @@ class UpdateInfo {
final String currentVersion;
final String downloadUrl;
final String releaseNotes;
+ final bool isPreRelease;
UpdateInfo({
required this.latestVersion,
required this.currentVersion,
required this.downloadUrl,
this.releaseNotes = '',
+ this.isPreRelease = false,
});
bool get hasUpdate => _compareVersions(latestVersion, currentVersion) > 0;
@@ -40,7 +42,8 @@ class UpdateCheckerService {
/// Check for updates. Returns UpdateInfo if a newer version exists, null otherwise.
/// Respects a 12-hour cooldown between checks and skips dismissed versions.
- static Future<UpdateInfo?> check({bool force = false}) async {
+ /// When [includePreReleases] is true, pre-release/alpha builds are also considered.
+ static Future<UpdateInfo?> check({bool force = false, bool includePreReleases = false}) async {
try {
final prefs = await SharedPreferences.getInstance();
@@ -53,17 +56,31 @@ class UpdateCheckerService {
await prefs.setInt(_lastCheckKey, DateTime.now().millisecondsSinceEpoch);
- final response = await http.get(
- Uri.parse('https://api.github.com/repos/$_repo/releases/latest'),
- headers: {'Accept': 'application/vnd.github.v3+json'},
- ).timeout(const Duration(seconds: 10));
-
- if (response.statusCode != 200) return null;
+ Map<String, dynamic>? data;
+
+ if (includePreReleases) {
+ // Fetch all releases and pick the first (newest) one, which may be a pre-release
+ final response = await http.get(
+ Uri.parse('https://api.github.com/repos/$_repo/releases?per_page=5'),
+ headers: {'Accept': 'application/vnd.github.v3+json'},
+ ).timeout(const Duration(seconds: 10));
+ if (response.statusCode != 200) return null;
+ final releases = jsonDecode(response.body) as List<dynamic>;
+ if (releases.isEmpty) return null;
+ data = releases.first as Map<String, dynamic>;
+ } else {
+ final response = await http.get(
+ Uri.parse('https://api.github.com/repos/$_repo/releases/latest'),
+ headers: {'Accept': 'application/vnd.github.v3+json'},
+ ).timeout(const Duration(seconds: 10));
+ if (response.statusCode != 200) return null;
+ data = jsonDecode(response.body) as Map<String, dynamic>;
+ }
- final data = jsonDecode(response.body) as Map<String, dynamic>;
final tagName = data['tag_name'] as String? ?? '';
final body = data['body'] as String? ?? '';
final assets = data['assets'] as List<dynamic>? ?? [];
+ final isPreRelease = data['prerelease'] as bool? ?? false;
// Find APK asset
String downloadUrl = data['html_url'] as String? ?? '';
@@ -83,6 +100,7 @@ class UpdateCheckerService {
currentVersion: currentVersion,
downloadUrl: downloadUrl,
releaseNotes: body,
+ isPreRelease: isPreRelease,
);
if (!info.hasUpdate) return null;