跳到正文
CH 17综合与交付Flutter9 分钟阅读

综合项目(下):测试、性能优化、打包发布

第 17 章 · 综合项目(下):测试、性能优化、打包发布

本章示例examples/ch16-bookmarks/(与 ch16 同一个工程)在线阅读源码下载 zip

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 测试金字塔:本例的三层

text
        ▲  集成测试(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 十秒级 真实环境装配问题 覆盖率低

分工原则:

  1. 能在单元层测的,绝不下沉到 widget 层——widget 测试慢且脆弱。
  2. 网络与数据库永远不真实(单元/widget 层),用 MockClient 和 AppDatabase.memory()。
  3. 集成测试只验证"装配":依赖能不能连上、真实设备上会不会崩,不做穷举。

单元测试:仓储与解析

dart
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 测试:只替换最底层

dart
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);     // 防抖后过滤
});

集成测试:真实设备/桌面

dartintegration_test/app_test.dart源文件
// 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):

bash
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)。超了就是掉帧。

① 减少重建范围

dart
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:

dart
return RepaintBoundary(child: ListTile(...));

代价是更多图层(内存上升),所以只对"会被频繁重绘的列表项"用,不要无脑包。

② 防抖:输入流畅度的关键

dart
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() 是关键成本)。实测的过滤成本有性能测试兜底:

dart
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 而不是猜

bash
flutter run --profile -d macos
# 打开 DevTools → Performance:看 frame chart 里的 build/layout/paint 时间
# → CPU Profiler:看热点函数
# → Memory:看是否有对象持续增长(泄漏)

三条经验:

  • debug 模式的性能数据不可用(JIT + 断言),必须 --profile;
  • "卡"先看是 build 慢(widget 逻辑)还是 raster 慢(绘制/图像);
  • 列表卡顿多半是"构建了太多不可见项"或"每帧重建整行"。

17.4 打包发布

版本号

yamlpubspec.yaml源文件
# pubspec.yaml
version: 1.2.0+37      # 语义版本 + build number
平台 映射
Android versionName=1.2.0、versionCode=37
iOS CFBundleShortVersionString、CFBundleVersion
macOS 同上(Info.plist)

build number 必须单调递增,否则商店拒收。

编译期配置

dart
factory AppConfig.fromEnvironment() => const AppConfig(
      baseUrl: String.fromEnvironment('BOOKMARKS_API',
          defaultValue: 'https://jsonplaceholder.typicode.com'),
    );
bash
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

bash
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

本次实测:

text
✓ Built build/macos/Build/Products/Release/ch16_bookmarks.app (48.3MB)
real 0m39.8s

release 产物双击/命令行启动均正常(Impeller/Metal 渲染)。

Android

bash
# 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

bash
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。

代码混淆与符号表

bash
flutter build apk --release --obfuscate --split-debug-info=build/symbols
  • 必须保存 symbols/,否则线上崩溃堆栈无法还原;
  • 用 flutter symbolize -i <stack> -d build/symbols 还原。

应用图标与启动图

yaml
dev_dependencies:
  flutter_launcher_icons: ^0.14.0
bash
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 一键验证(贯穿全书的工具)

bash
./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
// 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
// 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 丢了无法还原堆栈

三句话:

  1. 测试金字塔的关键不是数量,是边界:底层测逻辑,中层测交互,顶层测装配。
  2. 性能优化先测量:--profile + DevTools,再动代码;把阈值写成测试防退化。
  3. 发布是一次清单执行,不是一次构建:版本、配置、安全、体积、符号表、回滚,缺一不可。

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 过来的迁移要点,最终可以压缩成五条:

  1. 内存:GC 接管了分配/释放,但"订阅、controller、Ticker"仍然要手动释放。
  2. 并发:单线程事件循环负责交错,真并行只有 isolate;没有共享内存,也就没有锁。
  3. 类型:更严格的静态检查 + 空安全;dynamic/!/late 都是"关掉检查"的逃生门。
  4. UI:声明式,Widget 是配置,State 是对象,build 必须是纯函数。
  5. 互操作:算法与性能走 FFI,系统能力走平台通道,两者都以 C ABI/消息为边界,内存所有权是共同的难点。

这套教程到这里结束。剩下的路是读源码:flutter/flutter 的 widgets/ 与 rendering/,以及 riverpod/drift 的实现——你现在具备读懂它们的全部前置知识。