降低 Flutter 应用的包体积（APK / AAB / IPA 文件大小）是 发布到生产环境时非常重要的优化目标，特别是对于国内 Android 厂商上架、Google Play 限制、以及用户下载转化率而言。

一、🔍 为什么需要减小 Flutter 应用包体积？

二、📦 Flutter 应用包体积主要由哪些部分组成？

一个典型的 Flutter 应用包（尤其是 Release 模式）包含：

1. Flutter 引擎 & Framework（Dart 代码运行时）

• 包含 Skia 图形引擎、Dart VM（Release 模式下是 AOT 编译）、基础库等
• 这部分是 Flutter 的核心，无法删除，但可以优化选择架构

2. 你的 Dart 业务代码（AOT 编译后的本地代码）

• 通过 flutter build apk/aab/ios 编译为机器码，体积随业务逻辑增加

3. 资源文件（图片、字体、音频、视频、json 等）

• assets 目录下的所有资源会被打包进应用

4. 第三方依赖库（插件 / packages）

• 每个 pub 包可能引入额外的 Dart 代码、原生代码（Android .so / iOS .a）、资源

5. 原生平台代码（Android/iOS 原生部分）

• 包括 Android 的 lib/ 下的 .so 文件（armeabi-v7a, arm64-v8a 等）
• iOS 的静态库、动态库、资源、Bitcode 等

三、🛠️ 通用优化策略（Android & iOS）

✅ 1. 使用 Release 模式构建（而非 Profile / Debug）

• Debug 模式 包含调试信息、JIT、未优化代码，体积巨大且慢
• Profile 模式 适合性能分析，但仍比 Release 大
• Release 模式 启用了 Dart AOT、代码压缩、去除调试符号，是发布必备

🔧 构建命令：

# Android Release
flutter build apk --release
# 或者推荐使用 AAB（Google Play 推荐格式）
flutter build appbundle --release

# iOS Release
flutter build ios --release

✅ 2. 仅保留必要的 CPU 架构（Android 特有，可显著瘦身）

Android 设备支持多种 CPU 架构：如 armeabi-v7a、arm64-v8a、x86、x86_64。

但绝大多数现代设备都是 arm64-v8a，因此可以 只打包 arm64 架构，去掉 armeabi-v7a / x86 等，可减少 30%~50% 的原生库体积！

方法：修改 android/app/build.gradle

android {
    ...
    defaultConfig {
        ndk {
            abiFilters 'arm64-v8a'  // 只保留 arm64
            // 如需兼容更多设备，可以加上 'armeabi-v7a'
        }
    }
}

✅ 推荐：仅保留 arm64-v8a，可最大程度减少体积

⚠️ 如果你仍需兼容旧设备，可以加上 'armeabi-v7a'，但会增大包体积。

📌 iOS 无需此步骤，Xcode 默认只打包当前设备需要的架构（如 arm64）。

✅ 3. 启用代码压缩与资源压缩（Android & iOS）

Android：

• Flutter 默认在 Release 模式下已经对 Dart 代码进行了 AOT 编译和压缩
• 你还可以启用 ProGuard / R8（Android 代码混淆与压缩，但对 Flutter/Dart 代码影响较小，主要针对 Java/Kotlin 插件）

在 android/app/build.gradle 中启用 R8（默认已启用）：

buildTypes {
    release {
        minifyEnabled true    // 混淆与优化（对 Java 代码）
        shrinkResources true  // 删除未使用的资源
    }
}

⚠️ 注意：R8 对 Flutter 自身的 Dart 代码优化有限，但可以优化插件中的 Java/Kotlin 代码和资源。

iOS：

• Xcode 在 Release 模式下会自动启用 Bitcode（可选）、代码优化、资源压缩
• 你可以在 Xcode 的 Build Settings 中检查：

• Optimization Level（推荐：[-Osize] 或 [-Os]）
• Strip Debug Symbols During Copy / Linking
• Enable Bitcode（根据需求，Apple 已经不再要求，可以关闭以减小体积）

✅ 4. 移除未使用的资源（图片、字体、json 等）

检查 pubspec.yaml 中的 assets: 部分，只保留真正被使用的资源。

flutter:
  assets:
    - assets/images/logo.png   # 确保这些资源确实被使用
    # ❌ 不要遗留未使用的图片、字体、音频等

🧹 清理未使用的资源文件，它们虽然不会被主动引用，但一旦在 assets 中声明就会被打包！

可使用工具扫描未使用的资源（如 flutter_assets_linter 或手动检查）。

✅ 5. 压缩图片等资源文件

• 使用 WebP 格式 替代 PNG/JPG（WebP 通常体积更小，质量相当）
• 使用 tinypng.com 或 squash、imagemin 等工具压缩图片
• 避免在 assets 中放入超大分辨率的图片（如 4K 图片用于小图标）

✅ 推荐将图片放入 assets 前先进行压缩优化

✅ 6. 移除未使用的第三方依赖（pub packages）

检查 pubspec.yaml 中的依赖项，删除不再使用的包。

每个 package 都可能引入：

• Dart 代码
• 原生代码（Android .so / iOS 库）
• 资源文件

🔍 使用 flutter pub deps 查看依赖树，评估是否可以移除或替换为更轻量的包。

✅ 7. 使用更轻量的插件 / 避免引入不必要原生代码

有些插件（特别是功能复杂的，如图表、地图、视频等）会引入：

• 大型原生库（如 Google Maps SDK、FFmpeg、视频播放器等）
• 多 ABI 架构的 .so 文件（Android）
• 大量资源

✅ 评估是否真的需要该功能，能否用轻量替代方案，或自己实现部分功能

✅ 8. 拆分 APK（Android only）—— 使用 App Bundle（推荐）

Google Play 强烈推荐使用 App Bundle (.aab) 格式发布，它会：

• 按设备 CPU 架构、语言、屏幕密度动态下发最优 APK
• 用户下载的包比完整 APK 小 30%~50%

🔧 构建命令：

flutter build appbundle --release

然后上传到 Google Play Console 即可，Play 会自动为用户生成优化 APK。

⚠️ 如果你必须生成 APK，可以使用 --split-per-abi 来拆分成多个架构的 APK：

flutter build apk --release --split-per-abi

会生成：arm64-v8a.apk、armeabi-v7a.apk 等，你可以只上传需要的架构。

✅ 9. iOS 包体积优化补充

对于 iOS，除了上述通用优化，还可以：

• 移除未使用的字体
• 检查 Assets.xcassets 中是否有未使用的图片
• 在 Xcode 中检查：

• Strip Linked Product
• Make Strings Files Non-Localized
• Remove Debug Symbols
• Enable Bitcode（可关闭，除非有特殊需求）

四、📊 如何查看 Flutter 应用包内容与体积分布？

Android：

• 使用 Android Studio 的 APK Analyzer 打开生成的 APK 或 AAB
• 或使用命令行解压 APK 查看各部分占比：

unzip -l build/app/outputs/flutter-apk/app-release.apk

iOS：

• 使用 Xcode 查看 Archive 中的 IPA 内容
• 或解压 IPA（它是一个 zip 文件）查看 Payload/

五、✅ 总结 Checklist：如何有效降低 Flutter 应用包体积？

🎯 一句话总结：

要减小 Flutter 应用的包体积，关键是：使用 Release 模式构建、仅保留必要的 CPU 架构、移除未使用的资源与依赖、优化图片、使用 App Bundle，并通过工具分析体积构成，有针对性地裁剪。