Skip to content

Commit 99e3baf

Browse files
committed
fix(android): 修复 release 启动永久白屏(shared_preferences_android 2.5.0 JNI×R8)
- dependency_overrides 封顶 shared_preferences_android <2.5.0:2.5.0 起 Android 实现改走 JNI,R8 重命名 kotlin.coroutines.Continuation 导致 release 启动即抛 NoSuchMethodError,runApp 挂在 SharedPreferences.getInstance 前永不执行 (上游回归 flutter/flutter#194649) - main() 初始化失败落 StartupFailureScreen(显示原因+重试),不再永久白屏 - build.gradle.kts 缺 signing.properties 时按 Flutter 模板默认回退 debug 签名 (cherry picked from commit 6425609)
1 parent 2551d89 commit 99e3baf

6 files changed

Lines changed: 79 additions & 3 deletions

File tree

‎android/app/build.gradle.kts‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,8 @@ android {
7070
if (storeFileProp != null) {
7171
signingConfig = signingConfigs.getByName("release")
7272
} else {
73-
println(">>> Release build signing config not applied.") // Optional: warning
73+
println(">>> signing.properties not found, falling back to debug signing.")
74+
signingConfig = signingConfigs.getByName("debug")
7475
}
7576
}
7677
}
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
import 'package:flutter/material.dart';
2+
3+
import 'error_retry_widget.dart';
4+
5+
/// 启动初始化失败兜底页:展示原因并提供重试,替代失败时的永久白屏。
6+
///
7+
/// 重试回调由启动入口注入,重跑初始化成功后的 runApp 由入口闭环。
8+
class StartupFailureScreen extends StatelessWidget {
9+
const StartupFailureScreen({
10+
super.key,
11+
required this.error,
12+
required this.onRetry,
13+
});
14+
15+
final Object error;
16+
final VoidCallback onRetry;
17+
18+
@override
19+
Widget build(BuildContext context) {
20+
return MaterialApp(
21+
debugShowCheckedModeBanner: false,
22+
home: Scaffold(
23+
body: SafeArea(
24+
child: ErrorRetryWidget(
25+
message: '启动初始化失败:$error',
26+
onRetry: onRetry,
27+
),
28+
),
29+
),
30+
);
31+
}
32+
}

‎lib/main.dart‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ import 'package:jade/core/storage/testing/in_memory_secure_store.dart';
1919
import 'package:jade/core/providers/following_tags_provider.dart';
2020
import 'package:jade/core/services/following_tags_service.dart';
2121
import 'package:jade/core/services/following_tags_store.dart';
22+
import 'package:jade/core/widgets/startup_failure_screen.dart';
2223
import 'package:jade/features/search/index.dart';
2324

2425
export 'package:jade/app.dart' show MyApp;
@@ -40,7 +41,21 @@ Future<void> mainForTest({
4041
void main() async {
4142
WidgetsFlutterBinding.ensureInitialized();
4243
MediaKit.ensureInitialized();
43-
runApp(await _buildEntry());
44+
await _bootstrap();
45+
}
46+
47+
/// 启动初始化:成功即运行主应用;失败停留在错误页而非永久白屏,
48+
/// 重试时重新执行同一初始化流程。
49+
Future<void> _bootstrap() async {
50+
late final Widget entry;
51+
try {
52+
entry = await _buildEntry();
53+
} catch (error, stackTrace) {
54+
debugPrint('启动初始化失败: $error\n$stackTrace');
55+
runApp(StartupFailureScreen(error: error, onRetry: _bootstrap));
56+
return;
57+
}
58+
runApp(entry);
4459
}
4560

4661
Future<Widget> _buildEntry({

‎pubspec.lock‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -937,7 +937,7 @@ packages:
937937
source: hosted
938938
version: "2.5.5"
939939
shared_preferences_android:
940-
dependency: transitive
940+
dependency: "direct overridden"
941941
description:
942942
name: shared_preferences_android
943943
sha256: "20cbd561f743a342c76c151d6ddb93a9ce6005751e7aa458baad3858bfbfb6ac"

‎pubspec.yaml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,3 +103,9 @@ flutter_launcher_icons:
103103
ios: false
104104
image_path: "assets/icon/icon.png"
105105
min_sdk_android: 21
106+
107+
# shared_preferences_android 2.5.0 起 Android 实现改走 JNI;R8 混淆会重命名
108+
# kotlin.coroutines.Continuation 等符号,release 构建启动即抛 NoSuchMethodError
109+
# 并永久白屏(flutter/flutter#194649)。上游补齐 consumer keep rules 前封顶 2.4.x。
110+
dependency_overrides:
111+
shared_preferences_android: ">=2.4.10 <2.5.0"
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
import 'package:flutter_test/flutter_test.dart';
2+
import 'package:jade/core/widgets/startup_failure_screen.dart';
3+
4+
void main() {
5+
testWidgets('展示初始化失败原因并可触发重试', (tester) async {
6+
var retries = 0;
7+
await tester.pumpWidget(
8+
StartupFailureScreen(
9+
error: const FormatException('bad key'),
10+
onRetry: () => retries++,
11+
),
12+
);
13+
14+
expect(find.textContaining('启动初始化失败'), findsOneWidget);
15+
expect(find.textContaining('bad key'), findsOneWidget);
16+
expect(find.text('重试'), findsOneWidget);
17+
expect(retries, 0);
18+
19+
await tester.tap(find.text('重试'));
20+
expect(retries, 1);
21+
});
22+
}

0 commit comments

Comments
 (0)