Flutter版本管理插件bumper的使用

Flutter版本管理插件bumper的使用

bumper 是一个简单的命令行工具（CLI），可以自动更新你的项目版本，包括主版本、次版本、修订版本和构建版本。

功能

  • 自动更新 pubspec.yaml 文件中的版本。
  • 支持主版本、次版本、修订版本和构建版本的递增。
  • 通过终端提供交互式菜单来选择版本类型。
  • 使用彩色输出以便更好地阅读。

安装

在项目的依赖项中添加 bumper：

dart pub add bumper

或者在 pubspec.yaml 文件中添加以下内容：

dependencies:
  bumper: ^0.1.1

使用

安装完成后，你可以在项目的根目录下通过命令行运行该工具。

示例

假设当前项目的版本为 0.0.0+0。

主版本递增

dart run bumper major

输出：

Bumped to: 1.0.0+1

次版本递增

dart run bumper minor

输出：

Bumped to: 0.1.0+1

修订版本递增

dart run bumper patch

输出：

Bumped to: 0.0.1+1

构建版本递增（不改变应用版本）

dart run bumper build

输出：

Bumped to: 0.0.0+1

交互式版本类型选择

如果你不传递任何参数运行命令，将会出现一个菜单：

dart run bumper

菜单选项如下：

-> major
- minor
- patch
- build

使用箭头键导航并按回车键选择。

要求

  • Dart SDK 3.5.3 或更高版本。
  • 项目的根目录下有一个 pubspec.yaml 文件。

工作原理

  • 该工具会在 pubspec.yaml 文件中查找 version: 行。
  • 提取当前版本，格式为 X.Y.Z+N。
  • 根据所选的版本类型（主版本、次版本、修订版本、构建版本），递增相应的部分。
  • 然后将新的版本覆盖到 pubspec.yaml 文件中。

限制

  • 目前仅支持版本格式 X.Y.Z+N。
  • 不支持没有 pubspec.yaml 文件的项目。
  • 不支持包项目（因为包没有构建号）。

贡献

欢迎贡献！如果你有建议或发现了问题：

  • 在仓库中打开一个问题。
  • 创建一个包含你改进的拉取请求。

许可证

该项目采用 MIT 许可证。详情见 LICENSE 文件。

以下是使用 bumper 的示例代码：

import 'dart:io';

void main() {
  stdout.writeln('这是一个如何使用 `bumper` 工具的示例：');
  stdout.writeln('要递增版本的一部分，运行以下命令：');
  stdout.writeln('dart run bumper major');
  stdout.writeln('或者简单地运行 `dart run bumper` 以交互选择。');
}

更多关于Flutter版本管理插件bumper的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter版本管理插件bumper的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是如何在Flutter项目中使用flutter_version_bumper插件进行版本管理的示例代码和步骤。flutter_version_bumper插件允许你通过命令行工具自动增加你的Flutter应用的版本号。

步骤 1: 添加依赖

首先，你需要在你的pubspec.yaml文件中添加flutter_version_bumper依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_version_bumper: ^x.y.z  # 替换为最新版本号

然后运行flutter pub get来安装依赖。

步骤 2: 配置pubspec.yaml

确保你的pubspec.yaml文件中的版本格式正确，例如：

version: 1.0.0+1

步骤 3: 使用命令行工具

flutter_version_bumper提供了一个命令行工具，可以通过运行以下命令来增加版本号：

flutter pub run flutter_version_bumper:main [patch|minor|major|prepatch|preminor|premajor|prerelease]
  • patch：增加补丁版本号（例如，从1.0.0变为1.0.1）
  • minor：增加小版本号（例如，从1.0.0变为1.1.0）
  • major：增加主版本号（例如，从1.0.0变为2.0.0）
  • prepatch, preminor, premajor：增加预发布版本的补丁、小或主版本号
  • prerelease：增加预发布标签（例如，从1.0.0-alpha.1变为1.0.0-alpha.2）

示例

假设你当前的版本号是1.0.0+1，并且你想要增加补丁版本号：

flutter pub run flutter_version_bumper:main patch

运行上述命令后，你的pubspec.yaml文件中的版本号将自动更新为1.0.1+1。

自动化脚本（可选）

你也可以创建一个脚本来自动化这个过程。例如，创建一个名为bump_version.sh的脚本文件：

#!/bin/bash

# 增加补丁版本号
flutter pub run flutter_version_bumper:main patch

# 提交更改
git add pubspec.yaml
git commit -m "Bump version to $(grep -oP '(?<=version: )\K.*' pubspec.yaml)"

# 标记新版本
git tag -a v$(grep -oP '(?<=version: )\K[^+]*' pubspec.yaml) -m "Version v$(grep -oP '(?<=version: )\K[^+]*' pubspec.yaml)"
git push origin --tags

确保该脚本具有执行权限：

chmod +x bump_version.sh

然后你可以通过运行./bump_version.sh来自动化版本更新和提交过程。

注意事项

  • 在运行版本更新命令之前，确保你的工作目录是干净的（没有未提交的更改）。
  • 自动化脚本中的grep命令用于从pubspec.yaml文件中提取版本号，确保你的pubspec.yaml文件格式正确。

通过上述步骤，你可以轻松地在Flutter项目中使用flutter_version_bumper插件进行版本管理。

回到顶部