Loading...
Site Owner
发布于 2026-05-22
系统讲解Flutter JIT/AOT编译模式、Tree Shaking原理、延迟加载组件、ProGuard混淆及包体积瘦身策略
模块：模块九 · 性能优化
前置知识：Flutter 构建流程、Dart AOT/JIT
理解 Flutter 的两种编译模式，是包体积优化的基础：
| 特性 | JIT（Debug 模式） | AOT（Release 模式） |
|---|---|---|
| 编译时机 | 运行时即时编译 |
| 构建时提前编译为机器码 |
| 启动速度 | 慢（需要编译） | 快（直接执行机器码） |
| 执行性能 | 一般（有 JIT 开销） | 最优 |
| 包大小 | 含 Dart VM（~7MB） | 含 AOT 快照（更大但执行快） |
| 热重载 | ✅ 支持 | ❌ 不支持 |
| Tree Shaking | ❌ 无（运行时用什么编什么） | ✅ 有（死代码删除） |
| 适用场景 | 开发调试 | 生产发布 |
# 不同构建模式对比
flutter build apk --debug # JIT，含 Dart VM，巨大但支持热重载
flutter build apk --profile # AOT，但保留 Profile 钩子（DevTools 用）
flutter build apk --release # AOT + Tree Shaking + 混淆（最终发布）
AOT 编译时，Dart 编译器会自动进行 Tree Shaking，删除从未被引用的代码：
// lib/utils/math_utils.dart
// 假设这些函数只有部分被使用
double add(double a, double b) => a + b; // ✅ 被引用 → 保留
double subtract(double a, double b) => a - b; // ❌ 未被引用 → Tree Shaking 删除
double multiply(double a, double b) => a * b; // ❌ 未被引用 → 删除
// 结论：没有被任何代码调用的函数，AOT 编译后不会出现在最终产物中
注意：Tree Shaking 的限制：
// ⚠️ 通过字符串/反射访问的代码无法被 Tree Shaking
// Dart 的 dart:mirrors 反射会阻止 Tree Shaking
// ❌ 使用反射（不推荐，且在 Flutter AOT 中不可用）
// final mirror = reflect(SomeClass());
// ✅ 改用代码生成（json_serializable、freezed 等）
// 生成的代码是静态的，Tree Shaking 可以工作
# 生成详细的包体积报告
flutter build apk --analyze-size --target-platform android-arm64
# iOS
flutter build ios --analyze-size
# 输出示例：
# ════════════════════════════════════════
# app-release.apk (total compressed)
# ────────────────────────────────────────
# assets/ 12.3 MB
# assets/images/ 8.1 MB ← 图片资源
# assets/fonts/ 0.8 MB ← 字体文件
# lib/ 18.2 MB
# lib/arm64-v8a/ 18.2 MB ← AOT 编译代码
# META-INF/ 0.1 MB
# ════════════════════════════════════════
# Total: 30.6 MB
# --analyze-size 会输出一个 JSON 格式的详细报告
# 使用 Dart DevTools size analysis 工具可视化
flutter build apk --analyze-size 2>&1 | tee size_report.txt
# 重点关注：
# Flutter 编译优化与包体积控制
# Flutter 编译优化与包体积控制
# 3. Flutter engine（libflutter.so）：引擎体积（固定约 8MB）
# Release 构建时开启混淆 + 分离调试信息
flutter build apk \
--obfuscate \
--split-debug-info=./debug_symbols \
--target-platform android-arm64 \
--release
# 参数说明：
# --obfuscate ：混淆 Dart 类名、函数名（压缩包体积 + 防逆向）
# --split-debug-info ：将调试符号（.dSYM/.so）单独输出
# 不打入 APK，减小包体积，但保留崩溃解析能力
混淆对崩溃日志的影响：
# 混淆后的崩溃日志（难以阅读）：
# #0 _a.b (package:my_app/src/_c.dart:42:13)
# 使用 symbolize 还原（需要 split-debug-info 输出的符号文件）
flutter symbolize \
--debug-info=./debug_symbols/app.android-arm64.symbols \
--input=obfuscated_stacktrace.txt
// 将不常用的功能模块延迟加载，减小首屏包体积
// 注意：仅在 Flutter Web 上完全支持；原生平台目前有限支持
// lib/features/advanced_chart/advanced_chart.dart
library advanced_chart;
class AdvancedChart extends StatelessWidget {
@override
Widget build(BuildContext context) => const Placeholder();
}
// 在需要的地方按需加载
import 'package:my_app/features/advanced_chart/advanced_chart.dart'
deferred as advancedChart;
class AnalyticsDashboard extends StatefulWidget {
@override
State<AnalyticsDashboard> createState() => _AnalyticsDashboardState();
}
class _AnalyticsDashboardState extends State<AnalyticsDashboard> {
bool _isChartLoaded = false;
Object? _loadError;
Future<void> _loadChart() async {
try {
await advancedChart.loadLibrary(); // 异步加载库
if (mounted) {
setState(() => _isChartLoaded = true);
}
} catch (e) {
if (mounted) {
setState(() => _loadError = e);
}
}
}
@override
Widget build(BuildContext context) {
if (_loadError != null) {
return Center(child: Text('加载失败：$_loadError'));
}
if (!_isChartLoaded) {
return Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
const CircularProgressIndicator(),
ElevatedButton(
onPressed: _loadChart,
child: const Text('加载高级图表'),
),
],
),
);
}
// 加载完成后才使用
return advancedChart.AdvancedChart();
}
}
# 使用工具压缩图片资源
# PNG：pngquant（有损）或 optipng（无损）
pngquant --quality=75-90 assets/images/*.png
# JPEG：mozjpeg
cjpeg -quality 85 -outfile output.jpg input.jpg
# WebP（推荐，同等质量下体积更小）
cwebp -q 80 input.png -o output.webp
# pubspec.yaml：使用 WebP 格式
flutter:
assets:
- assets/images/hero.webp # 比 PNG 小 30-50%
- assets/images/background.webp
# 如果只用到部分字符，使用字体子集化工具
# pyftsubset（fonttools）
pyftsubset NotoSansCJK.ttc \
--text-file=used_chars.txt \ # 实际用到的字符列表
--output-file=NotoSansCJK-subset.ttf \
--flavor=woff2 # Web 端用 woff2，原生端用 ttf
// Flutter 内置了字体子集优化（--tree-shake-icons）
// 自动删除未使用的 Material Icons 字符
// 默认在 release 模式开启
# 查看字体子集化效果
flutter build apk --release --verbose 2>&1 | grep "Shaking fonts"
# pubspec.yaml：只打包需要的资源（避免打包整个目录）
flutter:
assets:
# ❌ 避免：整目录打包（包含未使用的文件）
# - assets/
# ✅ 推荐：明确列出需要的文件或子目录
- assets/images/
- assets/fonts/app_font.ttf
- assets/config/prod.json
# ❌ 传统 APK：包含所有 ABI 和屏幕密度的资源
flutter build apk --release
# 大小：~30MB（包含 arm32 + arm64 + x86_64 的代码）
# ✅ Android App Bundle (AAB)：Google Play 按需下发
flutter build appbundle --release
# 大小：~15MB（下发时只给用户设备匹配的 ABI）
# ✅ Split APK：按 ABI 分包（如果必须用 APK）
flutter build apk --split-per-abi --release
# 生成：
# build/app/outputs/flutter-apk/app-arm64-v8a-release.apk (~10MB)
# build/app/outputs/flutter-apk/app-armeabi-v7a-release.apk (~9MB)
# build/app/outputs/flutter-apk/app-x86_64-release.apk (~10MB)
# iOS App Thinning（Xcode 自动处理）：
# - Bitcode：允许 App Store 重新编译针对特定设备优化的二进制
# - Slicing：只下发设备所需的资源（@1x、@2x、@3x 图片）
# - On-Demand Resources：游戏等大资源按需下载
# Flutter 构建 iOS
flutter build ios --release
# 使用 Archive 导出时选择 "App Thinning" 选项以启用完整优化
初始状态分析：
flutter build apk --analyze-size 2>&1
# 输出：
# Total compressed download size: 28.5 MB
#
# app-release.apk (total compressed)
# assets/ 9.2 MB
# images/banner.png 4.1 MB ← 超大未压缩 PNG
# images/icons/ 1.8 MB ← 图标未优化
# fonts/ 3.1 MB ← 全量字体文件
# lib/arm64-v8a/ 15.8 MB
# libflutter.so 3.2 MB ← 引擎（不可减少）
优化步骤：
# 步骤 1：压缩大图
pngquant --quality=75-85 assets/images/banner.png
# banner.png: 4.1MB → 0.8MB（节省 3.3MB）
# 步骤 2：转换为 WebP
cwebp -q 80 assets/images/icons/*.png -o assets/images/icons/
# icons/: 1.8MB → 0.6MB（节省 1.2MB）
# 步骤 3：字体子集化
# 中文字体只保留 App 用到的 2000 个汉字
pyftsubset fonts/NotoSansCJK.ttc --text-file=used_chars.txt
# fonts/: 3.1MB → 0.4MB（节省 2.7MB）
# 步骤 4：开启混淆（减少符号表体积）
flutter build apk \
--obfuscate \
--split-debug-info=./symbols \
--split-per-abi \
--release
# 优化后：
# Total: 21.5 MB（减少 7MB，降幅 24.6%）
// 使用 --dart-define 传递编译时常量（比 .env 文件更安全）
flutter build apk \
--dart-define=APP_ENV=production \
--dart-define=API_BASE_URL=https://api.example.com \
--dart-define=ENABLE_ANALYTICS=true \
--release
// 在代码中读取编译时常量
const String appEnv = String.fromEnvironment('APP_ENV', defaultValue: 'development');
const String apiBaseUrl = String.fromEnvironment(
'API_BASE_URL',
defaultValue: 'https://dev-api.example.com',
);
const bool enableAnalytics = bool.fromEnvironment('ENABLE_ANALYTICS');
// 编译时常量的优势：
// 1. Tree Shaking 可以删除 if (appEnv == 'development') 的死分支
// 2. 不像 .env 那样暴露在运行时（但也不是完全安全）
# Gradle 缓存（Android）
# ~/.gradle/caches/ 缓存 Gradle 依赖和构建中间产物
# CI 中缓存这个目录可以大幅减少构建时间
# Pub 缓存
# ~/.pub-cache/ 缓存 pub 包
# CI 中缓存：
# key: ${{ hashFiles('pubspec.lock') }}
# path: ~/.pub-cache
# Flutter 工具链缓存
# CI 中缓存 Flutter SDK 目录
# key: ${{ env.FLUTTER_VERSION }}
# path: ~/flutter
| 优化项 | 预期收益 | 工具 |
|---|---|---|
| PNG → WebP 转换 | 30-50% 图片体积减少 | cwebp |
| PNG 有损压缩 | 20-40% | pngquant |
| 字体子集化 | 60-80% 字体体积减少 | pyftsubset |
| AAB 替代 APK | 30-50% 下发体积 | flutter build appbundle |
| Split ABI APK | 40% 单包体积 | --split-per-abi |
| 代码混淆 | 3-8% 代码段体积 | --obfuscate |
| 延迟加载 | 10-30% 首屏体积 | deferred import |
| 删除未使用依赖 | 不定 | dart pub deps |
✅ 能读懂 --analyze-size 的输出报告，定位体积大头
✅ 能说明 AOT 和 JIT 编译模式的适用场景
✅ 能通过延迟加载将首屏包体积减少 20%
✅ 能配置 --split-debug-info 并用 flutter symbolize 还原混淆堆栈
✅ 理解 Android App Bundle 相比 APK 的体积优势及原理
上一篇：27. 内存优化 | 下一篇：29. 应用架构模式