在 Flutter 中修改应用的版本号(Version Name)和版本代码(Version Code),你需要分别修改 Android 和 iOS 平台的配置文件。

对于 Android 平台

修改 android/app/build.gradle 文件

  1. 打开 android/app/build.gradle 文件

  2. 找到 defaultConfig 部分

  3. 修改 versionCode 和 versionName

android {
    defaultConfig {
        applicationId "com.example.your_app"
        minSdkVersion flutter.minSdkVersion
        targetSdkVersion flutter.targetSdkVersion
        versionCode 2        // 版本代码(整数,每次更新递增)
        versionName "1.1.0"  // 版本名称(字符串)
    }
}
  • versionCode: 整数,每次发布新版本应该递增(如:1, 2, 3...)

  • versionName: 字符串,用户可见的版本号(如:"1.0.0", "1.1.0")

对于 iOS 平台

修改 ios/Runner.xcodeproj/project.pbxproj 文件

或者通过 Xcode 修改:

  1. 打开 Xcode

  2. 选择 Runner 项目

  3. 在左侧选择 Runner target

  4. 在 General 标签页中修改版本信息

或者直接编辑配置文件:

  1. 打开 ios/Runner/Info.plist 文件

  2. 修改以下键值:

<key>CFBundleShortVersionString</key>
<string>1.1.0</string>  <!-- 版本名称 -->
<key>CFBundleVersion</key>
<string>2</string>       <!-- 版本代码 -->

使用 flutter 命令查看当前版本

flutter pub get
flutter build apk --debug
# 或者查看构建配置

使用包管理工具(推荐)

你可以使用 flutter_version 等第三方包来统一管理版本号:

  1. 在 pubspec.yaml 中添加依赖:

dev_dependencies:
  flutter_version: ^2.0.0
  1. 在项目根目录创建 version.properties 文件:

version=1.1.0
code=2
  1. 通过命令更新版本:

flutter_version bump

注意事项

  1. 版本代码必须递增: 每次发布新版本时,versionCode 必须比上一个版本大

  2. 平台同步: 确保 Android 和 iOS 的版本信息保持一致

  3. 测试: 修改后建议构建测试版本来验证版本号是否正确更新

验证修改

修改后,你可以通过以下方式验证:

# 查看构建信息
flutter build apk --release --build-number=2 --build-name=1.1.0
# 或者在应用中显示版本号
import 'package:package_info_plus/package_info_plus.dart';

void printVersion() async {
  PackageInfo packageInfo = await PackageInfo.fromPlatform();
  print('Version: ${packageInfo.version}');
  print('Build: ${packageInfo.buildNumber}');
}

记得在修改版本号后重新构建应用,新的版本信息才会生效。

更多推荐