316 lines
11 KiB
Dart
316 lines
11 KiB
Dart
|
import 'dart:async';
|
|||
|
|
import 'dart:ui';
|
|||
|
|
|
|||
|
|
import 'package:flutter/material.dart';
|
|||
|
|
import 'package:flutter/services.dart';
|
|||
|
|
import 'package:flutter_localizations/flutter_localizations.dart';
|
|||
|
|
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
|||
|
|
|
|||
|
|
import 'app/router.dart';
|
|||
|
|
import 'app/theme.dart';
|
|||
|
|
import 'providers/locale_provider.dart';
|
|||
|
|
import 'providers/theme_provider.dart';
|
|||
|
|
import 'providers/display_provider.dart';
|
|||
|
|
import 'utils/constants.dart';
|
|||
|
|
import 'utils/credential_storage.dart';
|
|||
|
|
import 'utils/i10n.dart';
|
|||
|
|
import 'utils/store_local_cache.dart';
|
|||
|
|
import 'config/prod_guard.dart';
|
|||
|
|
|
|||
|
|
/// 应用入口。
|
|||
|
|
///
|
|||
|
|
/// 三端（Android / iOS / HarmonyOS）共用同一套 lib/ 代码，
|
|||
|
|
/// 通过 [ProviderScope] 注入全局状态，使用 go_router 进行声明式路由。
|
|||
|
|
/// 根组件 key；重试时更换以强制整棵树重建。
|
|||
|
|
GlobalKey _appRootKey = GlobalKey();
|
|||
|
|
|
|||
|
|
void main() {
|
|||
|
|
// 全局 ErrorWidget：任何 widget 在 build/layout/paint 阶段抛异常时，
|
|||
|
|
// 直接显示可读的红色错误页，而不是 release 模式默认的灰色错误块（静默灰屏）。
|
|||
|
|
ErrorWidget.builder = (FlutterErrorDetails details) {
|
|||
|
|
return _ErrorWidgetScreen(
|
|||
|
|
message: details.exceptionAsString(),
|
|||
|
|
stack: details.stack,
|
|||
|
|
);
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// 框架级异常兜底：记录并写入 _fatalError，供根组件在 build 时渲染错误页。
|
|||
|
|
// 注意：不再调用 FlutterError.presentError，避免默认灰屏覆盖自定义错误页。
|
|||
|
|
FlutterError.onError = (details) {
|
|||
|
|
_reportFatal(details.exceptionAsString(), details.stack);
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// 异步/Zone 异常兜底。
|
|||
|
|
PlatformDispatcher.instance.onError = (error, stack) {
|
|||
|
|
_reportFatal(error.toString(), stack);
|
|||
|
|
return true;
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
runZonedGuarded<void>(
|
|||
|
|
() async {
|
|||
|
|
WidgetsFlutterBinding.ensureInitialized();
|
|||
|
|
|
|||
|
|
// 启用 Edge-to-Edge 全屏：内容延伸至状态栏与导航栏区域，
|
|||
|
|
// 避免手机四周出现黑边；同时保持系统手势/状态栏可见。
|
|||
|
|
await SystemChrome.setEnabledSystemUIMode(SystemUiMode.edgeToEdge);
|
|||
|
|
// 状态栏 / 导航栏图标亮度跟随系统明暗（修复此前硬编码 Brightness.light
|
|||
|
|
// 导致浅色模式下图标不可见的 bug）。
|
|||
|
|
final isDark =
|
|||
|
|
WidgetsBinding.instance.platformDispatcher.platformBrightness ==
|
|||
|
|
Brightness.dark;
|
|||
|
|
SystemChrome.setSystemUIOverlayStyle(
|
|||
|
|
SystemUiOverlayStyle(
|
|||
|
|
statusBarColor: Colors.transparent,
|
|||
|
|
systemNavigationBarColor: Colors.transparent,
|
|||
|
|
systemNavigationBarDividerColor: Colors.transparent,
|
|||
|
|
statusBarIconBrightness: isDark ? Brightness.light : Brightness.dark,
|
|||
|
|
systemNavigationBarIconBrightness:
|
|||
|
|
isDark ? Brightness.light : Brightness.dark,
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
// 预初始化凭据持久化（记住密码 / 免登录恢复依赖 SharedPreferences 同步读取）。
|
|||
|
|
await CredentialStorage.init();
|
|||
|
|
|
|||
|
|
// 生产环境强制守卫：启动即校验当前后端非生产，命中则失败退出并阻断启动。
|
|||
|
|
ProductionGuard.enforce();
|
|||
|
|
|
|||
|
|
// 预初始化本地缓存（语言、主题等配置需要同步读取）。
|
|||
|
|
// 即便失败也用默认值兜底，不让启动崩溃。
|
|||
|
|
StoreLocalCache.instance.initialize().catchError((_) {
|
|||
|
|
// 忽略：SharedPreferences 不可用时退化为内存态。
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// 应用已保存的显示方向偏好（跟随系统 / 竖屏 / 横屏），
|
|||
|
|
// 确保首帧即按用户设置的方向渲染，不闪一下系统默认朝向。
|
|||
|
|
final savedOrientation = await loadSavedOrientation();
|
|||
|
|
applyDisplayOrientation(savedOrientation);
|
|||
|
|
|
|||
|
|
_launchApp();
|
|||
|
|
},
|
|||
|
|
(error, stack) {
|
|||
|
|
_reportFatal(error.toString(), stack);
|
|||
|
|
},
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 启动根组件（重试时再次调用即可重建整棵树）。
|
|||
|
|
void _launchApp() {
|
|||
|
|
runApp(
|
|||
|
|
ProviderScope(
|
|||
|
|
key: _appRootKey,
|
|||
|
|
child: const OpsConsoleApp(),
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 全局致命错误信息；非空时 [OpsConsoleApp] 渲染错误页而非正常界面。
|
|||
|
|
String? _fatalError;
|
|||
|
|
|
|||
|
|
/// 记录致命错误并写入全局变量，供 [OpsConsoleApp] 在 build 时渲染错误页。
|
|||
|
|
void _reportFatal(Object error, StackTrace? stack) {
|
|||
|
|
if (_fatalError == null) {
|
|||
|
|
_fatalError =
|
|||
|
|
'$error\n\n${stack?.toString().split('\n').take(8).join('\n') ?? ''}';
|
|||
|
|
}
|
|||
|
|
debugPrint('FATAL: $error');
|
|||
|
|
debugPrint('STACK: $stack');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 清空致命错误并重启根组件（错误页「重试」按钮调用）。
|
|||
|
|
void _retryApp() {
|
|||
|
|
_fatalError = null;
|
|||
|
|
_appRootKey = GlobalKey();
|
|||
|
|
_launchApp();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 运维管理台根组件。
|
|||
|
|
class OpsConsoleApp extends ConsumerWidget {
|
|||
|
|
const OpsConsoleApp({super.key});
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
Widget build(BuildContext context, WidgetRef ref) {
|
|||
|
|
// 全局致命错误：直接渲染可读错误页，避免 release 模式静默灰屏。
|
|||
|
|
if (_fatalError != null) {
|
|||
|
|
return MaterialApp(
|
|||
|
|
title: AppConstants.appName,
|
|||
|
|
debugShowCheckedModeBanner: false,
|
|||
|
|
theme: AppTheme.light(),
|
|||
|
|
darkTheme: AppTheme.dark(),
|
|||
|
|
themeMode: ThemeMode.system,
|
|||
|
|
home: _FatalErrorScreen(error: _fatalError!),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
final router = ref.watch(appRouterProvider);
|
|||
|
|
final themeMode = ref.watch(themeModeProvider);
|
|||
|
|
final appLocale = ref.watch(localeProvider);
|
|||
|
|
|
|||
|
|
return MaterialApp.router(
|
|||
|
|
title: AppConstants.appName,
|
|||
|
|
// 应用级名称，与 AndroidManifest/iOS Info.plist/鸿蒙配置保持一致
|
|||
|
|
debugShowCheckedModeBanner: false,
|
|||
|
|
theme: AppTheme.light(),
|
|||
|
|
darkTheme: AppTheme.dark(),
|
|||
|
|
// 默认深色主题，可在“设置”页切换
|
|||
|
|
themeMode: themeMode,
|
|||
|
|
locale: appLocale.locale,
|
|||
|
|
supportedLocales: const [
|
|||
|
|
Locale('zh', 'CN'),
|
|||
|
|
Locale('en', 'US'),
|
|||
|
|
],
|
|||
|
|
localizationsDelegates: const [
|
|||
|
|
// 必须包含 Flutter 默认的本地化委托，否则 MaterialLocalizations
|
|||
|
|
// 不会被注册，所有 TextField/InputDecoration 会因取 null 而崩溃。
|
|||
|
|
GlobalMaterialLocalizations.delegate,
|
|||
|
|
GlobalWidgetsLocalizations.delegate,
|
|||
|
|
GlobalCupertinoLocalizations.delegate,
|
|||
|
|
_AppLocaleDelegate(),
|
|||
|
|
],
|
|||
|
|
routerConfig: router,
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// [AppLocale] 的轻量 [LocalizationsDelegate]，
|
|||
|
|
/// 使 [AppLocalizations.of] 能按当前 locale 取到对应文案。
|
|||
|
|
class _AppLocaleDelegate extends LocalizationsDelegate<AppLocale> {
|
|||
|
|
const _AppLocaleDelegate();
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
bool isSupported(Locale locale) =>
|
|||
|
|
locale.languageCode == 'zh' || locale.languageCode == 'en';
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
Future<AppLocale> load(Locale locale) async {
|
|||
|
|
return locale.languageCode == 'en' ? AppLocale.en : AppLocale.zh;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
bool shouldReload(covariant LocalizationsDelegate<AppLocale> old) => false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 全局致命错误展示页。
|
|||
|
|
///
|
|||
|
|
/// 当 [FlutterError.onError] / [PlatformDispatcher.onError] / Zone 异常捕获到
|
|||
|
|
/// 未处理异常时，用可读的红色错误页替代默认的灰/白屏，便于真机直接看到根因。
|
|||
|
|
class _FatalErrorScreen extends StatelessWidget {
|
|||
|
|
const _FatalErrorScreen({required this.error});
|
|||
|
|
|
|||
|
|
final String error;
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
Widget build(BuildContext context) {
|
|||
|
|
return Scaffold(
|
|||
|
|
backgroundColor: Colors.red.shade50,
|
|||
|
|
body: SafeArea(
|
|||
|
|
child: Padding(
|
|||
|
|
padding: const EdgeInsets.all(24),
|
|||
|
|
child: Column(
|
|||
|
|
crossAxisAlignment: CrossAxisAlignment.stretch,
|
|||
|
|
children: [
|
|||
|
|
const Icon(Icons.error_outline, size: 48, color: Colors.red),
|
|||
|
|
const SizedBox(height: 16),
|
|||
|
|
const Text(
|
|||
|
|
'应用启动时发生错误',
|
|||
|
|
style: TextStyle(
|
|||
|
|
fontSize: 18,
|
|||
|
|
fontWeight: FontWeight.bold,
|
|||
|
|
color: Colors.red,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
const SizedBox(height: 8),
|
|||
|
|
const Text(
|
|||
|
|
'请将下方错误信息反馈给开发人员：',
|
|||
|
|
style: TextStyle(color: Colors.black87),
|
|||
|
|
),
|
|||
|
|
const SizedBox(height: 12),
|
|||
|
|
Expanded(
|
|||
|
|
child: SingleChildScrollView(
|
|||
|
|
child: SelectableText(
|
|||
|
|
error,
|
|||
|
|
style: const TextStyle(
|
|||
|
|
fontFamily: 'monospace',
|
|||
|
|
fontSize: 12,
|
|||
|
|
color: Colors.black87,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
const SizedBox(height: 12),
|
|||
|
|
FilledButton(
|
|||
|
|
onPressed: _retryApp,
|
|||
|
|
child: const Text('重试'),
|
|||
|
|
),
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// 全局渲染异常兜底页（[ErrorWidget.builder] 使用）。
|
|||
|
|
///
|
|||
|
|
/// 与 [_FatalErrorScreen] 不同，此组件不依赖 MaterialApp/Theme（此时 app 可能
|
|||
|
|
/// 尚未建立），是一个完全自包含、硬编码红色背景的可读错误页，确保任何 widget
|
|||
|
|
/// 渲染异常都能暴露文字而非静默灰屏。
|
|||
|
|
class _ErrorWidgetScreen extends StatelessWidget {
|
|||
|
|
const _ErrorWidgetScreen({required this.message, this.stack});
|
|||
|
|
|
|||
|
|
final String message;
|
|||
|
|
final StackTrace? stack;
|
|||
|
|
|
|||
|
|
@override
|
|||
|
|
Widget build(BuildContext context) {
|
|||
|
|
return Material(
|
|||
|
|
color: Colors.red.shade50,
|
|||
|
|
child: SafeArea(
|
|||
|
|
child: SingleChildScrollView(
|
|||
|
|
padding: const EdgeInsets.all(24),
|
|||
|
|
child: Column(
|
|||
|
|
crossAxisAlignment: CrossAxisAlignment.start,
|
|||
|
|
children: [
|
|||
|
|
const Icon(Icons.error_outline, size: 40, color: Colors.red),
|
|||
|
|
const SizedBox(height: 12),
|
|||
|
|
const Text(
|
|||
|
|
'渲染异常（Widget Error）',
|
|||
|
|
style: TextStyle(
|
|||
|
|
fontSize: 18,
|
|||
|
|
fontWeight: FontWeight.bold,
|
|||
|
|
color: Colors.red,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
const SizedBox(height: 8),
|
|||
|
|
const Text(
|
|||
|
|
'请将下方文字反馈给开发人员：',
|
|||
|
|
style: TextStyle(color: Colors.black87),
|
|||
|
|
),
|
|||
|
|
const SizedBox(height: 8),
|
|||
|
|
SelectableText(
|
|||
|
|
message,
|
|||
|
|
style: const TextStyle(
|
|||
|
|
fontFamily: 'monospace',
|
|||
|
|
fontSize: 12,
|
|||
|
|
color: Colors.black87,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
if (stack != null) ...[
|
|||
|
|
const SizedBox(height: 8),
|
|||
|
|
SelectableText(
|
|||
|
|
stack.toString(),
|
|||
|
|
style: const TextStyle(
|
|||
|
|
fontFamily: 'monospace',
|
|||
|
|
fontSize: 11,
|
|||
|
|
color: Colors.black54,
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
],
|
|||
|
|
],
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
),
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
}
|