1、Flutter打包入门：项目结构解析与双端打包基础

说实话，很多初学者一上来就急着写代码，结果到了打包环节就懵了。我见过太多人卡在这一步——项目结构搞不清，Android和iOS的打包流程完全不一样，开发环境和生产环境更是傻傻分不清楚。今天咱们就把这些基础问题一次性理清楚。

1.1 Flutter项目结构：你得知道每个文件夹是干嘛的

创建一个Flutter项目后，你会看到一堆文件夹。别慌，我来给你拆解一下。

my_flutter_app/
├── android/          # Android原生壳
├── ios/              # iOS原生壳
├── lib/              # 你的Dart代码全在这
├── test/             # 单元测试
├── web/              # Web平台（可选）
├── macos/            # macOS桌面（可选）
├── windows/          # Windows桌面（可选）
├── linux/            # Linux桌面（可选）
├── pubspec.yaml      # 依赖管理，核心文件
└── analysis_options.yaml  # 代码规范配置

lib/ 是你最常打交道的目录。所有业务代码、UI组件、状态管理都放这里。我个人习惯把页面按功能模块分文件夹，比如 lib/pages/、lib/widgets/、lib/models/。

android/ 和 ios/ 这两个目录，说白了就是原生平台的壳。Flutter代码最终会编译成原生代码，嵌入到这两个壳里运行。你不需要精通Android和iOS开发，但至少得知道怎么配置签名、版本号这些东西。

1.2 Android打包基础：从APK到AAB

Android打包有两种产物：APK和AAB。APK是老格式，直接安装到手机上。AAB是Google Play强制要求的新格式，体积更小，按需分发。

打包命令很简单：

# 生成APK（调试版）
flutter build apk --debug

# 生成APK（发布版）
flutter build apk --release

# 生成AAB（发布版，用于Google Play）
flutter build appbundle --release

嗯，这里要注意——发布版必须配置签名。没有签名的APK，手机根本装不上。我曾经帮一个学员排查问题，他折腾了两天，最后发现是签名文件路径写错了。

1.3 iOS打包基础：证书和描述文件是绕不开的坎

iOS打包比Android复杂得多。你需要一个苹果开发者账号（99美元/年），然后配置证书和描述文件。

打包命令：

# 生成iOS项目（必须先执行）
cd ios && pod install

# 打包为IPA（发布版）
flutter build ios --release

# 打包为IPA（真机调试版）
flutter build ios --debug

为什么iOS这么麻烦？说白了，苹果对安全要求极高。每个App都要有唯一的Bundle Identifier，配上对应的证书和描述文件，才能安装到真机上。

我记得第一次给客户打包iOS应用时，光配置证书就花了一整天。后来我总结了一个经验：用Xcode打开 ios/Runner.xcworkspace，在Signing & Capabilities里勾选"Automatically manage signing"，让Xcode自动处理大部分配置。

1.4 开发环境与生产环境：别让测试数据污染了线上

你想想看，开发时用的是测试API、测试数据库，上线后得切换到正式环境。如果代码里写死了API地址，每次打包都要手动改，那不得累死？

Flutter提供了 --dart-define 参数，可以在打包时动态传入环境变量：

# 开发环境
flutter build apk --release --dart-define=ENV=dev

# 生产环境
flutter build apk --release --dart-define=ENV=prod

然后在代码里读取：

const String env = String.fromEnvironment('ENV', defaultValue: 'dev');

String getBaseUrl() {
  switch (env) {
    case 'dev':
      return 'https://dev-api.example.com';
    case 'prod':
      return 'https://api.example.com';
    default:
      return 'https://dev-api.example.com';
  }
}

这样做的好处是，你只需要维护一套代码，打包时通过参数切换环境。我曾经在项目里见过有人用注释来切换环境，结果上线前忘了改回来，导致线上App连的是测试数据库——那场面，别提多尴尬了。

1.5 环境配置的最佳实践

除了API地址，环境配置还应该包括：

• 日志级别：开发环境打印所有日志，生产环境只打印错误
• 调试工具：开发环境启用Flutter DevTools，生产环境禁用
• 第三方服务：比如友盟、Firebase，开发和生产用不同的AppKey

我习惯把这些配置统一放在一个 config.dart 文件里，用工厂模式根据环境返回不同的配置对象。这样代码清晰，也方便后续维护。

下一章，咱们会深入Android打包的细节，包括签名配置、多渠道打包、混淆规则等。这些东西在实际项目中天天要用，早点掌握不吃亏。