import 'package:cupertino_ui/cupertino_ui.dart'; import 'package:flutter_riverpod/flutter_riverpod.dart'; import 'package:go_router/go_router.dart'; import 'package:ttstd_family_care/core/widgets/app_page_scaffold.dart'; import '../../../core/storage/token_storage.dart'; import '../../../l10n/app_localizations.dart'; /// 启动页。 /// /// 仅负责首屏展示与路由决策(登录态判断),不含业务请求。 class SplashPage extends ConsumerStatefulWidget { const SplashPage({super.key}); @override ConsumerState createState() => _SplashPageState(); } class _SplashPageState extends ConsumerState { bool _navigated = false; @override void initState() { super.initState(); // 首帧绘制后做一次性的路由决策。 // 不使用 Future.delayed 做跳转:App 进后台再回前台时计时器可能被挂起, // 导致恢复后跳转不可靠、画面卡在第一屏。改用首帧回调 + 幂等保护。 WidgetsBinding.instance.addPostFrameCallback((_) => _decideRoute()); } void _decideRoute() { if (_navigated || !mounted) return; _navigated = true; try { final target = TokenStorage.isLoggedIn ? '/home' : '/login'; context.go(target); _repaintAfterNavigation(); } catch (_) { // 极端情况下的路由异常不应卡死首屏,重试一次。 if (mounted) { _navigated = false; WidgetsBinding.instance.addPostFrameCallback((_) => _decideRoute()); } } } /// 规避 Impeller(OpenGLES) 冷启动首帧的字形图集纹理错位: /// 首屏可能整块图标/文字残缺,且未变化的图层不会再绘制,画面会一直残缺, /// 直到触发一次重排/重绘(如切页、旋转)才恢复。首个页面绘制完成后主动把 /// 整棵渲染树标记为待重绘,强制重新录制并重新光栅化一次。 static void _repaintAfterNavigation() { WidgetsBinding.instance.addPostFrameCallback((_) { for (final view in WidgetsBinding.instance.renderViews) { _markNeedsPaint(view); } }); } static void _markNeedsPaint(RenderObject object) { object.markNeedsPaint(); object.visitChildren(_markNeedsPaint); } @override Widget build(BuildContext context) { final l10n = AppLocalizations.of(context); return AppPageScaffold( backgroundColor: CupertinoColors.systemBackground, child: Center( child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ const Icon( CupertinoIcons.heart_fill, size: 64, color: CupertinoColors.activeBlue, ), const SizedBox(height: 16), Text( l10n.appTitle, style: const TextStyle(fontSize: 20, fontWeight: FontWeight.w600), ), SizedBox(height: 8), CupertinoActivityIndicator(), ], ), ), ); } }