Debian环境下Flutter如何进行版本控制

Debian环境下Flutter版本控制实践

一版本控制的范围与原则

区分两类“版本”：
- SDK版本：Flutter/Dart工具链本身，影响编译、热重载、插件兼容性与命令行行为。
- 项目代码版本：应用源码与依赖，用Git管理，通过pubspec.yaml锁定依赖版本。
推荐原则：
- 每个项目固定一个Flutter SDK版本，跨开发者与CI保持一致。
- 使用语义化版本与变更日志，便于回滚与协作。
- 将SDK版本信息写入项目，使环境可重建、可审计。

二方案一使用FVM进行SDK版本管理（推荐）

安装FVM（Dart SDK已就绪时）
- 执行：dart pub global activate fvm，并将$HOME/.pub-cache/bin加入PATH，验证：fvm --version。
常用命令
- 安装版本：fvm install <version|channel>
- 项目指定版本：cd <project> && fvm use <version|channel>
- 全局版本：fvm global <version|channel>
- 查看已装/可用：fvm list / fvm releases
- 以项目指定版本运行命令：fvm flutter <command>（如：fvm flutter doctor、fvm flutter pub get）
项目集成与忽略
- fvm use会在项目根目录生成**.fvm/fvm_config.json**；建议将其加入版本控制，以便团队统一版本。
- 将**.fvm/flutter_sdk加入.gitignore**，避免将庞大的SDK二进制提交到仓库。
与IDE/调试器配合
- 在VS Code选择FVM工作区解释器（Flutter: Change SDK），或在Android Studio设置Flutter SDK路径为项目下的.fvm/flutter_sdk。
- 使用FVM后，调试/运行请通过fvm flutter或在IDE中正确指向FVM SDK，以确保断点与热重载正常。

三方案二使用Git标签在单一SDK中切换版本

四方案三多SDK目录或符号链接切换

多目录法
- 将不同版本解压到如**/opt/flutter-3.7.7**、/opt/flutter-3.22.0，按需修改PATH或创建别名（alias）切换。
符号链接法
- 统一SDK目录（如**/opt/flutter**）为符号链接，切换版本时仅替换链接目标：
  - ln -sfn /opt/flutter-3.22.0 /opt/flutter
  - 验证：flutter --version && flutter doctor
适用场景：对“当前全局版本”有明确控制需求，或需在同一终端会话中快速切换。

五项目级落地与CI建议

锁定依赖与SDK版本
- 在pubspec.yaml中固定关键依赖版本；使用fvm use 后提交.fvm/fvm_config.json到Git，保证团队与CI使用相同SDK。
Debian系统依赖
- 保持系统与构建工具更新：sudo apt update && sudo apt upgrade，以避免因系统库导致构建或驱动问题。
持续集成示例（GitHub Actions）
- 使用subosito/flutter-action设置指定Flutter版本，执行flutter pub get与测试/构建：
  - 示例：
    - name: Flutter CI
    - on: [push]
    - jobs:
      - build:
        
        runs-on: ubuntu-latest
        
        steps:
        
        uses: actions/checkout@v4
        
        uses: subosito/flutter-action@v2 with: flutter-version: ‘3.22.0’ # 或 ${{ env.FLUTTER_VERSION }}
        
        run: flutter pub get
        
        run: flutter test
- 若使用FVM，可在CI中先fvm install <version> && fvm use <version>，再用fvm flutter执行命令。

最新问答