1

flutter_app/lib/update/update_screen.dart

@@ -46,8 +46,12 @@ class _UpdateScreenState extends State<UpdateScreen> {
   String? _message;
   StreamSubscription<InstallEvent>? _installSub;
 
+  /// 安装超时兜底：确认框未处理/系统无回调时避免永久卡「安装中」
+  Timer? _installTimer;
+
   @override
   void dispose() {
+    _installTimer?.cancel();
     _installSub?.cancel();
     _client.close();
     super.dispose();
@@ -125,6 +129,15 @@ class _UpdateScreenState extends State<UpdateScreen> {
       _message = null;
     });
     await _installSub?.cancel();
+    // 安装超时兜底：确认框未处理/系统无回调时避免永久卡「安装中」
+    _installTimer?.cancel();
+    _installTimer = Timer(const Duration(seconds: 120), () {
+      if (!mounted) return;
+      setState(() {
+        _stage = _Stage.failed;
+        _message = '安装超时，请重试';
+      });
+    });
     _installSub = ApkInstaller.progress().listen((e) {
       if (!mounted) return;
       switch (e.event) {
@@ -132,6 +145,7 @@ class _UpdateScreenState extends State<UpdateScreen> {
           setState(() => _progress = e.progress.toDouble());
           break;
         case 'finished':
+          _installTimer?.cancel();
           final ok = e.success == true;
           setState(() {
             _stage = ok ? _Stage.finished : _Stage.failed;
@@ -139,6 +153,8 @@ class _UpdateScreenState extends State<UpdateScreen> {
           });
           break;
         case 'failed':
+          _installTimer?.cancel();
+          debugPrint('UpdateScreen: install failed: ${e.error}');
           setState(() {
             _stage = _Stage.failed;
             _message = e.error ?? '安装失败，请重试';
@@ -146,16 +162,30 @@ class _UpdateScreenState extends State<UpdateScreen> {
           break;
       }
     }, onError: (Object _) {
+      _installTimer?.cancel();
       if (!mounted) return;
       setState(() {
         _stage = _Stage.failed;
         _message = '安装失败，请重试';
       });
     });
-    final result = await ApkInstaller.install(_apkFile.path);
+    final String result;
+    try {
+      result = await ApkInstaller.install(_apkFile.path);
+    } catch (_) {
+      // 原生安装通道异常（如会话创建失败）：不捕获则 UI 永久停在「安装中」
+      _installTimer?.cancel();
+      if (!mounted) return;
+      setState(() {
+        _stage = _Stage.failed;
+        _message = '安装启动失败，请重试';
+      });
+      return;
+    }
     if (!mounted) return;
     if (result == 'permission_required') {
       // 原生侧已拉起系统设置页；APK 已缓存，用户开启后返回再点直达安装
+      _installTimer?.cancel();
       setState(() {
         _stage = _Stage.failed;
         _message = '请在系统设置中允许「安装未知应用」，返回后再次点击「立即更新」（APK 已缓存，无需重新下载）';