目录

Flutter开发者必备:完整命令行工具指南

Flutter提供了丰富的命令行工具来简化开发流程。本文将详细介绍Flutter CLI的各种命令,帮助开发者提高工作效率。

环境检查与配置

系统诊断

# 检查Flutter安装状态和系统配置
flutter doctor

# 详细检查(显示所有组件状态)
flutter doctor -v

# 检查特定平台的配置
flutter doctor --android-licenses

版本管理

# 查看当前Flutter版本
flutter --version

# 切换Flutter渠道
flutter channel stable    # 稳定版
flutter channel beta      # 测试版
flutter channel dev       # 开发版

# 升级Flutter SDK
flutter upgrade

# 降级到特定版本
flutter downgrade

项目创建与管理

创建新项目

# 创建基础应用
flutter create my_app

# 创建指定平台的应用
flutter create --platforms android,ios my_app

# 创建包含示例代码的应用
flutter create --sample flutter.widgets.Container my_app

# 创建Flutter包
flutter create --template=package my_package

# 创建Flutter插件
flutter create --template=plugin my_plugin

项目配置

# 清理项目缓存
flutter clean

# 获取项目依赖
flutter pub get

# 重新生成文件(如需要)
flutter packages get

依赖包管理

基础依赖操作

# 添加依赖包
flutter pub add http
flutter pub add provider --dev  # 添加开发依赖

# 移除依赖包
flutter pub remove http

# 获取所有依赖
flutter pub get

# 升级依赖包
flutter pub upgrade
flutter pub upgrade --major-versions  # 升级主版本

依赖分析

# 检查过时的依赖
flutter pub outdated

# 显示依赖树
flutter pub deps

# 分析依赖关系
flutter pub deps --style=compact

开发与调试

设备管理

# 列出所有可用设备
flutter devices

# 列出模拟器
flutter emulators

# 启动指定模拟器
flutter emulators --launch Pixel_4_API_30

# 创建Android模拟器
flutter emulators --create --name test_emulator

运行与调试

# 运行应用(热重载模式)
flutter run

# 在指定设备上运行
flutter run -d chrome           # Web浏览器
flutter run -d "iPhone 12"      # iOS模拟器

# 以调试模式运行
flutter run --debug

# 以性能模式运行
flutter run --profile

# 以发布模式运行
flutter run --release

# 运行时启用详细日志
flutter run --verbose

代码质量检查

# 分析代码问题
flutter analyze

# 格式化代码
flutter format .
flutter format lib/main.dart    # 格式化指定文件

# 运行测试
flutter test
flutter test test/widget_test.dart  # 运行指定测试

# 运行测试并生成覆盖率报告
flutter test --coverage

构建与发布

Android构建

# 构建APK(调试版)
flutter build apk --debug

# 构建APK(发布版)
flutter build apk --release

# 构建App Bundle(推荐用于Google Play)
flutter build appbundle

# 构建指定架构的APK
flutter build apk --split-per-abi

iOS构建

# 构建iOS应用
flutter build ios

# 构建用于发布的iOS应用
flutter build ios --release

# 构建IPA文件
flutter build ipa

Web构建

# 构建Web应用
flutter build web

# 构建Web应用并指定基础URL
flutter build web --base-href /my-app/

性能监控与优化

性能分析

# 启动性能监控
flutter run --profile

# 生成性能报告
flutter build apk --analyze-size

# 检查应用大小
flutter build apk --target-platform android-arm64 --analyze-size

日志与调试

# 查看应用日志
flutter logs

# 截取应用截图
flutter screenshot

# 连接到Dart Observatory
flutter run --observatory-port=8888

工具与实用命令

配置管理

# 查看Flutter配置
flutter config

# 启用/禁用功能
flutter config --enable-web
flutter config --enable-macos-desktop
flutter config --enable-windows-desktop
flutter config --enable-linux-desktop

项目维护

# 修复项目问题
flutter doctor --fix

# 预缓存工件
flutter precache

# 清理全局缓存
flutter pub cache clean

最佳实践建议

开发流程优化

  1. 定期运行 flutter doctor 确保开发环境正常
  2. 使用 flutter analyze 在提交代码前检查代码质量
  3. 利用热重载 提高开发效率:在运行应用时按 r 热重载,按 R 热重启
  4. 版本管理 在团队开发中统一使用stable渠道

构建优化

  1. APK大小优化 使用 --split-per-abi 为不同架构生成单独的APK
  2. Web构建 使用 --web-renderer html 提高兼容性
  3. 性能构建 发布前使用 --release 模式进行最终测试

依赖管理建议

  1. 定期更新 使用 flutter pub outdated 检查并更新依赖
  2. 锁定版本 在生产环境中明确指定依赖版本
  3. 清理缓存 遇到依赖问题时使用 flutter cleanflutter pub get

通过掌握这些Flutter命令,开发者可以显著提升开发效率,更好地管理项目生命周期。建议将常用命令加入到开发工作流中,形成良好的开发习惯。