标签 Flutter 下的文章

Flutter 应用的版本号是在 pubspec.yaml 文件中的 version 字段定义。

更新步骤

  1. 在 pubspec.yaml 文件顶部找到 version: A.B.C+X 这一行,修改对应的数字。

    • A.B.C:用户可见的版本号(如 1.2.0),对应 Android 的 versionName 和 iOS 的 CFBundleShortVersionString。
    • +X:构建号(如 +5),必须是递增的正整数。对应 Android 的 versionCode 和 iOS 的 CFBundleVersion。每次提交到应用商店,这个构建号必须增加,否则会被拒绝。
  2. 修改后,在项目根目录运行以下命令同步依赖,让 Flutter 重新获取配置:

    flutter pub get

    执行后,相关平台的原生工程文件会自动更新。

自动化工具

如果觉得手动改容易漏,可以使用社区工具 flutter_deploy。它能一条命令自动递增构建号,并同步更新 iOS 的 Info.plist 等原生文件。

# 自动递增构建号并同步 iOS 文件
flutter_deploy --bump

注意

  • 应用商店通常只接受比线上版本更高的构建号,建议每次发布前都检查一下。
  • 构建时也可以通过 --build-name 和 --build-number 参数临时覆盖版本号,但主要用于 CI 环境。