Files
ReelShort/lib/core/config/server_endpoint.dart
T
2026-11-18 17:41:55 +08:00

87 lines
2.8 KiB
Dart

// Author: fruit.com.cn
import 'package:flutter/foundation.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'app_config.dart';
/// Debug-only runtime server endpoint persisted outside build-time defines.
abstract final class ServerEndpoint {
/// Preference key used for the runtime server address.
static const String preferenceKey = 'dev.api_base_url';
/// 地址迁移前的开发机默认值;UAT 启动时不能继续使用它。
static const String legacyLocalBaseUrl = 'http://192.168.31.120:8081';
/// Returns a normalized http(s) URL, or null for invalid input.
static String? normalize(String? raw) {
final value = raw?.trim() ?? '';
final uri = Uri.tryParse(value);
if (uri == null ||
(uri.scheme != 'http' && uri.scheme != 'https') ||
uri.host.isEmpty) {
return null;
}
return value.replaceFirst(RegExp(r'/+$'), '');
}
/// 运行时手改优先,其次构建期默认地址;两者都必须先通过规范校验。
static String resolve({required String? stored, required String fallback}) {
return normalize(stored) ?? normalize(fallback) ?? fallback;
}
/// Loads the persisted override before the app creates its ApiClient.
///
/// In release builds this returns immediately without reading preferences.
static Future<void> load({
bool debug = kDebugMode,
SharedPreferencesAsync? preferences,
}) async {
if (!debug) return;
try {
final prefs = preferences ?? SharedPreferencesAsync();
final stored = await prefs.getString(preferenceKey);
final normalizedStored = normalize(stored);
if (normalizedStored == legacyLocalBaseUrl &&
normalize(AppConfig.baseUrl) != legacyLocalBaseUrl) {
await prefs.remove(preferenceKey);
AppConfig.clearRuntimeBaseUrl();
return;
}
AppConfig.applyRuntimeBaseUrl(
resolve(stored: normalizedStored, fallback: AppConfig.baseUrl),
);
} catch (_) {
AppConfig.clearRuntimeBaseUrl();
}
}
/// Persists a normalized runtime endpoint.
static Future<bool> save(
String raw, {
SharedPreferencesAsync? preferences,
}) async {
final normalized = normalize(raw);
if (normalized == null) return false;
try {
await (preferences ?? SharedPreferencesAsync()).setString(
preferenceKey,
normalized,
);
AppConfig.applyRuntimeBaseUrl(normalized);
return true;
} catch (_) {
return false;
}
}
/// Removes the persisted runtime endpoint.
static Future<void> clear({SharedPreferencesAsync? preferences}) async {
try {
await (preferences ?? SharedPreferencesAsync()).remove(preferenceKey);
} catch (_) {
// Clearing an optional developer override is best effort.
}
}
}