综合项目(下):测试、性能优化、打包发布
第 17 章 · 综合项目(下):测试、性能优化、打包发布
run
已验证
- flutter analyze 0 告警、flutter test 20 个用例全绿、
- 完整工程已打包:打包下载
本章目录 · 25 节
17.1 本章目标
- 建立完整的测试金字塔:单元 / widget / 设备端集成测试,各测什么、边界在哪;
- 做可量化的性能优化:防抖、
const、RepaintBoundary、ListView.builder、把重活丢 isolate; - 写性能回归测试(把可接受成本变成断言);
- 完成一次真实打包发布:版本号、
--dart-define、release 构建、签名/公证、Android App Bundle、iOS Archive; - 有一份可执行的发布检查清单。
17.2 测试金字塔:本例的三层
▲ 集成测试(integration_test/)
╱ ╲ 1 个:真实网络 + 真实 SQLite,验证"整条链路"
╱───╲
╱ ╲ widget 测试(test/app_test.dart)
╱───────╲ 7 个:路由 + 状态 + UI 交互,替换掉数据库/网络
╱ ╲
╱───────────╲ 单元测试(test/repository_test.dart、performance_test.dart)
╱─────────────╲ 13 个:领域逻辑、仓储、远程解析、性能阈值
| 层 | 数量 | 跑多快 | 能抓到什么 | 抓不到什么 |
|---|---|---|---|---|
| 单元 | 13 | 毫秒 | 业务规则、SQL 语义、解析、性能退化 | UI 布局、路由 |
| widget | 7 | 秒 | 交互流程、三态、导航 | 原生插件、真实网络 |
| 集成 | 1 | 十秒级 | 真实环境装配问题 | 覆盖率低 |
分工原则:
- 能在单元层测的,绝不下沉到 widget 层——widget 测试慢且脆弱。
- 网络与数据库永远不真实(单元/widget 层),用
MockClient和AppDatabase.memory()。 - 集成测试只验证"装配":依赖能不能连上、真实设备上会不会崩,不做穷举。
单元测试:仓储与解析
late AppDatabase db;
setUp(() => db = AppDatabase.memory());
tearDown(() => db.close());
test('importFromRemote 统计新增数,重复导入为 0', () async {
final FakeRemoteApi remote = FakeRemoteApi(drafts: sampleDrafts);
final DriftBookmarkRepository repo = DriftBookmarkRepository(db, remote);
expect(await repo.importFromRemote(), 2);
expect(await repo.importFromRemote(), 0); // 已去重
expect(await db.watchAllRows().first, hasLength(2));
});
widget 测试:只替换最底层
Widget testApp({required AppDatabase db, required BookmarkRemoteApi remote}) => ProviderScope(
overrides: [
databaseProvider.overrideWithValue(db),
remoteApiProvider.overrideWithValue(remote),
],
child: const BookmarksApp(),
);
testWidgets('搜索:命中与空结果文案区分', (WidgetTester tester) async {
await pumpApp(tester, remote: FakeRemoteApi(drafts: sampleDrafts));
await tester.tap(find.byKey(const Key('sync')));
await tester.pumpAndSettle();
await tester.enterText(find.byKey(const Key('search')), 'flutter');
await tester.pump(const Duration(milliseconds: 50));
expect(find.text('Dart 官网'), findsOneWidget); // 防抖未生效
await tester.pump(const Duration(milliseconds: 200));
expect(find.text('Dart 官网'), findsNothing); // 防抖后过滤
});
集成测试:真实设备/桌面
// examples/ch16-bookmarks/integration_test/app_test.dart
void main() {
IntegrationTestWidgetsFlutterBinding.ensureInitialized();
testWidgets('冷启动 → 真实同步 → 搜索 → 打开详情', (WidgetTester tester) async {
// 只有数据库换成内存;网络是真实的
...
await tester.tap(find.byKey(const Key('sync')));
await tester.pumpAndSettle(const Duration(seconds: 3));
expect(find.byKey(const Key('bookmark-list')), findsOneWidget);
});
}
运行方式(不是 flutter test):
flutter test integration_test/app_test.dart -d macos
集成测试会真的访问外网,CI 里应该起一个本地 mock 服务器,把
BOOKMARKS_API指过去(--dart-define)。
三个测试坑(本书都踩过)
| 现象 | 原因 | 解法 |
|---|---|---|
Timer is still pending |
drift 的 watch 订阅在测试结束时还活着 |
测试结尾 pumpWidget(SizedBox()) 卸载 + db.close() |
pumpAndSettle 卡几分钟 |
界面里有无限动画(loading 圈)或 stream 永不静默 | 用 pump(Duration) 精确推进;确保加载态会结束 |
| 断言 URL 合法却失败 | Uri.hasAbsolutePath 对 https://a.test 为 false |
用 scheme + host 判断 |
17.3 性能:先测量,再优化
Flutter 的性能预算很具体:一帧 16.6ms(60Hz)/ 8.3ms(120Hz)。超了就是掉帧。
① 减少重建范围
final AsyncValue<List<Bookmark>> filtered = ref.watch(filteredBookmarksProvider);
...
itemBuilder: (BuildContext context, int index) {
final Bookmark bookmark = items[index];
return BookmarkTile( // 独立 widget + ValueKey
key: ValueKey<int>(bookmark.id),
bookmark: bookmark,
onTap: () => context.push('/bookmark/${bookmark.id}'),
onToggleFavorite: () => ref.read(bookmarkActionsProvider).toggleFavorite(bookmark),
);
},
| 手段 | 效果 |
|---|---|
拆成 BookmarkTile(独立 StatelessWidget) |
父级重建时子级可被短路 |
ValueKey(id) |
列表重排时复用 Element,不重建 State |
const 构造 |
编译期常量,identical 相等 → 整棵子树跳过 |
ListView.builder |
只构建可见项(不是 20000 项全建) |
RepaintBoundary |
列表项独立图层,滚动不连带重绘 |
BookmarkTile 用了 RepaintBoundary:
return RepaintBoundary(child: ListTile(...));
代价是更多图层(内存上升),所以只对"会被频繁重绘的列表项"用,不要无脑包。
② 防抖:输入流畅度的关键
class SearchQuery extends Notifier<String> {
Timer? _timer;
@override
String build() {
ref.onDispose(() => _timer?.cancel());
return '';
}
void set(String value) {
_timer?.cancel();
_timer = Timer(const Duration(milliseconds: 150), () => state = value);
}
}
不防抖时,每敲一个字符就过滤 20k 条书签(toLowerCase() 是关键成本)。实测的过滤成本有性能测试兜底:
test('过滤 20k 条书签 < 200ms', () {
final List<Bookmark> items = buildItems(20000);
final Stopwatch sw = Stopwatch()..start();
final List<Bookmark> filtered = items.where((b) => ...).toList();
sw.stop();
expect(sw.elapsedMilliseconds, lessThan(200), reason: '过滤出现数量级退化');
});
阈值留足余量(CI 机器可能慢 5 倍),目的是拦住数量级退化,不是精确计时。
③ 别在 build 里干活
| 反例 | 后果 | 正解 |
|---|---|---|
build 里 jsonDecode |
每次重建都解析 | 在 provider 里解析一次 |
build 里 http.get |
重复请求 | StreamProvider/AsyncNotifier |
build 里 toLowerCase() 大列表 |
每帧 O(n) | 派生 provider(自动缓存) |
build 里 DateTime.now() |
重建时值变动,破坏 const |
一次求值存状态 |
④ 重活丢 isolate
ch08 的结论在真实项目里同样成立:超过 16ms 的纯计算(大 JSON、图片处理、全文搜索)用 Isolate.run。注意只传可发送的数据,Pointer/NativeCallable 不能跨 isolate(ch10)。
⑤ 用 DevTools 而不是猜
flutter run --profile -d macos
# 打开 DevTools → Performance:看 frame chart 里的 build/layout/paint 时间
# → CPU Profiler:看热点函数
# → Memory:看是否有对象持续增长(泄漏)
三条经验:
- debug 模式的性能数据不可用(JIT + 断言),必须
--profile; - "卡"先看是 build 慢(widget 逻辑)还是 raster 慢(绘制/图像);
- 列表卡顿多半是"构建了太多不可见项"或"每帧重建整行"。
17.4 打包发布
版本号
# pubspec.yaml
version: 1.2.0+37 # 语义版本 + build number
| 平台 | 映射 |
|---|---|
| Android | versionName=1.2.0、versionCode=37 |
| iOS | CFBundleShortVersionString、CFBundleVersion |
| macOS | 同上(Info.plist) |
build number 必须单调递增,否则商店拒收。
编译期配置
factory AppConfig.fromEnvironment() => const AppConfig(
baseUrl: String.fromEnvironment('BOOKMARKS_API',
defaultValue: 'https://jsonplaceholder.typicode.com'),
);
flutter build macos --release --dart-define=BOOKMARKS_API=https://api.example.com
flutter build apk --release --dart-define=BOOKMARKS_API=https://api.example.com
不要把 baseUrl/token 写进代码分支,更不要用 kReleaseMode 散落各处做环境判断。
macOS
flutter build macos --release
# 产物:build/macos/Build/Products/Release/ch16_bookmarks.app
| 步骤 | 要点 |
|---|---|
| 签名 | Xcode → Signing & Capabilities → Team;或 codesign 手动签名 |
| 公证(分发到外部用户) | xcrun notarytool submit ... --wait + xcrun stapler staple |
| 沙箱 | 默认开启;文件路径见 ch14(~/Library/Containers/...) |
| 分发方式 | DMG / PKG(create-dmg 等工具) |
| FFI 动态库(ch10) | 放进 Contents/Frameworks/,并加 @rpath |
本次实测:
✓ Built build/macos/Build/Products/Release/ch16_bookmarks.app (48.3MB)
real 0m39.8s
release 产物双击/命令行启动均正常(Impeller/Metal 渲染)。
Android
# 1) 生成签名密钥(只做一次)
keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
# 2) android/key.properties 指向密钥(不要提交到 git)
# 3) 构建
flutter build appbundle --release --dart-define=BOOKMARKS_API=https://api.example.com
# 产物:build/app/outputs/bundle/release/app-release.aab(上架 Google Play)
# 或 flutter build apk --release --split-per-abi(直接分发)
要点:minSdkVersion、proguard(--obfuscate --split-debug-info=build/symbols)、ndkVersion 与 FFI 的 ABI 对齐(ch10)。
iOS
flutter build ipa --release --dart-define=BOOKMARKS_API=https://api.example.com
# 产物:build/ios/ipa/*.ipa → Transporter / Xcode Organizer 上传 TestFlight
要点:证书 + Provisioning Profile、Info.plist 权限文案、--obfuscate 后保留 dsym。
代码混淆与符号表
flutter build apk --release --obfuscate --split-debug-info=build/symbols
- 必须保存
symbols/,否则线上崩溃堆栈无法还原; - 用
flutter symbolize -i <stack> -d build/symbols还原。
应用图标与启动图
dev_dependencies:
flutter_launcher_icons: ^0.14.0
dart run flutter_launcher_icons
(本项目为保持依赖精简没有配置图标,发布前必须补上,否则商店会拒绝默认图标。)
17.5 发布检查清单
| 类别 | 检查项 |
|---|---|
| 质量 | flutter analyze 0 告警;flutter test 全绿;verify_all.sh 通过 |
| 版本 | pubspec.yaml 的 version/build number 已递增;商店元数据已更新 |
| 配置 | --dart-define 指向生产环境;无调试开关(debugPrint/测试入口) |
| 安全 | 无硬编码 token;日志脱敏;HTTPS;证书校验开启 |
| 大小 | 检查产物体积(iOS/Android 用 --split-debug-info;图片压缩) |
| 性能 | --profile 下首屏与滚动无持续掉帧;冷启动 < 2s(桌面/中端机) |
| 兼容 | 最低系统版本;深色模式;窗口缩放(桌面);横竖屏(移动) |
| 发布物 | 图标/启动图/截图/隐私政策;macOS 公证;Android AAB 签名;iOS Archive |
| 回滚 | 保留上一版本与符号表;后端兼容旧客户端(至少一个版本) |
17.6 一键验证(贯穿全书的工具)
./scripts/verify_all.sh # 所有示例:pub get + analyze + test
./scripts/verify_all.sh --build # 额外做桌面端真实构建
./scripts/verify_all.sh ch16 # 只验证综合项目
本项目在这套脚本下:analyze 0 告警、20 个测试全绿、release 构建通过。
附:C/Go 代码对照:基准测试
// Go:testing.B 自动决定迭代次数,-benchmem 给出内存分配
func BenchmarkFilter(b *testing.B) {
items := buildItems(20000)
b.ResetTimer()
for i := 0; i < b.N; i++ {
_ = filter(items, "flutter")
}
}
// go test -bench . -benchmem
// Dart:没有内置 bench 框架,用 Stopwatch + 阈值断言做"防退化"
test('过滤 20k 条书签 < 200ms', () {
final items = buildItems(20000);
final sw = Stopwatch()..start();
final filtered = items.where((b) => b.matches('flutter')).toList();
sw.stop();
expect(filtered, isNotEmpty);
expect(sw.elapsedMilliseconds, lessThan(200), reason: '过滤出现数量级退化');
});
Go 的基准给出"每次操作耗时/分配",适合精确优化;Dart 这边把 Stopwatch 断言放进测试,主要用来拦住数量级退化(阈值要留足 CI 余量)。性能分析仍要用 DevTools(CPU/Frame chart),不要靠猜。
17.7 本章小结 + C/Go 对照清单
| 主题 | Go / C 的做法 | Flutter | 陷阱 |
|---|---|---|---|
| 单测 | testing / CUnit |
package:test |
测到了实现细节而非行为 |
| UI 测试 | 手工/难 | widget test | 把网络/DB 带进 widget 测试 |
| 集成测试 | e2e 脚本 | integration_test |
忘了它不是 flutter test |
| 基准测试 | testing.B / 手写计时 |
Stopwatch + 阈值断言 | 阈值太紧 → CI 抖动 |
| 性能预算 | 无固定值 | 16.6ms/帧 | debug 模式测性能 |
| 构建 | make / go build -ldflags |
flutter build <target> --release |
忘递增 build number |
| 配置注入 | env / -X ldflags |
--dart-define |
密钥进代码 |
| 符号表 | -g + 保存 |
--split-debug-info |
丢了无法还原堆栈 |
三句话:
- 测试金字塔的关键不是数量,是边界:底层测逻辑,中层测交互,顶层测装配。
- 性能优化先测量:
--profile+ DevTools,再动代码;把阈值写成测试防退化。 - 发布是一次清单执行,不是一次构建:版本、配置、安全、体积、符号表、回滚,缺一不可。
17.8 全书回顾:你现在掌握的能力
| 阶段 | 章节 | 能力 |
|---|---|---|
| 起步 | ch01–ch02 | Dart 语法心智(值/常量/函数)、Widget 与热重载 |
| 数据与类型 | ch03–ch04 | 类型系统、null 安全、集合、约束驱动的布局 |
| 异步与事件 | ch05–ch07 | Future/Stream、生命周期、动画 |
| 工程化 | ch08–ch13 | mixin/extension/isolate、路由/资源/主题、FFI(C/Rust/Go)、Riverpod、JSON、网络 |
| 交付 | ch14–ch17 | 持久化、平台通道、分层架构、测试/性能/发布 |
从 C/Go 过来的迁移要点,最终可以压缩成五条:
- 内存:GC 接管了分配/释放,但"订阅、controller、Ticker"仍然要手动释放。
- 并发:单线程事件循环负责交错,真并行只有 isolate;没有共享内存,也就没有锁。
- 类型:更严格的静态检查 + 空安全;
dynamic/!/late都是"关掉检查"的逃生门。 - UI:声明式,Widget 是配置,State 是对象,
build必须是纯函数。 - 互操作:算法与性能走 FFI,系统能力走平台通道,两者都以 C ABI/消息为边界,内存所有权是共同的难点。
这套教程到这里结束。剩下的路是读源码:flutter/flutter 的 widgets/ 与 rendering/,以及 riverpod/drift 的实现——你现在具备读懂它们的全部前置知识。