Linux下Flutter代码怎么管理

Linux下Flutter代码管理实战指南

一 环境与版本管理

• 安装与验证：下载 Flutter SDK 至如 /opt/flutter，将 /opt/flutter/bin 加入 PATH，执行 flutter doctor 检查环境。
• 多版本切换：
  • 手动方式：在 ~/flutter 目录中切换版本标签（如 git checkout 1.22.6），随后运行 flutter doctor 完成工具链同步。
  • 推荐方式：使用 FVM（Flutter Version Manager） 管理全局与项目级版本，支持 fvm use 、按项目锁定版本，并可配合 Sidekick GUI 使用。
• 升级与维护：使用 flutter upgrade 升级 Flutter 框架；如使用 Android Studio，在 Help → Check for Updates 中保持 IDE 与工具链最新。

二 依赖与资源管理

• 依赖管理（pubspec.yaml）：
  • 添加/移除：在 dependencies 中声明包（如 http: ^0.13.3），保存后执行 flutter pub get；移除后再次 flutter pub get 同步；查看包信息用 flutter pub info <package_name>。
  • 快捷操作：flutter pub add <package_name>、flutter pub remove <package_name>。
  • 版本锁定：pubspec.lock 会自动生成并锁定依赖版本，确保不同环境构建一致性，通常无需手动编辑。
  • 来源多样：支持 Pub 仓库、本地路径依赖（path）与 Git 依赖（git + path）。
• 资源管理：
  • 声明资源：在 pubspec.yaml 的 flutter/assets 下列出资源（如图片、JSON）。
  • 加载方式：文本用 rootBundle.loadString 或 DefaultAssetBundle.of(context).loadString；图片用 Image.asset 或 AssetImage。
  • 多分辨率：按 1.0x / 2.0x / 3.0x 目录组织同名图片以适配像素密度。
  • 包内资源：通过 AssetImage(‘icons/heart.png’, package: ‘my_icons’) 指定包名加载。

三 代码结构与平台配置

• 代码组织：按功能拆分 lib/（如 models、views、viewmodels、services），遵循 Dart 风格与注释规范，降低耦合、便于维护。
• 平台资源与配置：应用图标、启动页等平台相关资源需在各自平台工程中设置（例如 Android 的 AndroidManifest.xml 中 android:icon 与 meta-data 配置）。

四 版本控制与发布流程

• Git 基础：在项目根目录执行 git init，配置 user.name / user.email，使用 git add .、git commit -m “…”、git remote add origin 、git push -u origin master；通过 git branch / checkout / merge 进行分支管理。
• 分支策略：按功能/修复创建分支（如 feature/、hotfix/），合并前进行 Code Review 与 CI 校验，保持 main/master 稳定可发布。
• 持续集成（GitHub Actions 示例）：
  • 使用 actions/checkout@v2 拉取代码。
  • 通过 subosito/flutter-action@v1 设置 Flutter（如 channel: stable）。
  • 执行 flutter pub get 与端到端测试（如 flutter drive --target=test_driver/app_test.dart）。
• 发布与优化：
  • 构建发布：使用 –release 模式启用 AOT 与 树摇优化，减小包体并提升运行时性能。
  • 安全加固：启用 SSL/TLS 与 证书固定（SSL Pinning），配置 网络安全策略，必要时进行 代码混淆。

五 嵌入式 Linux 与多工程协作

• 嵌入式 Linux 场景：使用 flutter-embedded-linux 提供的工程模板与脚本（如 bin/run.sh、build.sh、debug.sh），结合 CMakeLists.txt 与 pubspec.yaml 管理构建与依赖，适合在 Yocto/嵌入式发行版 中集成与部署。
• 多工程/插件协作：通过 本地路径依赖 或 Git 依赖 将通用组件抽取为 package，在多个 Flutter 工程间复用，便于统一规范与版本对齐。