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
最佳实践建议
开发流程优化
- 定期运行
flutter doctor
确保开发环境正常 - 使用
flutter analyze
在提交代码前检查代码质量 - 利用热重载 提高开发效率:在运行应用时按
r
热重载,按R
热重启 - 版本管理 在团队开发中统一使用stable渠道
构建优化
- APK大小优化 使用
--split-per-abi
为不同架构生成单独的APK - Web构建 使用
--web-renderer html
提高兼容性 - 性能构建 发布前使用
--release
模式进行最终测试
依赖管理建议
- 定期更新 使用
flutter pub outdated
检查并更新依赖 - 锁定版本 在生产环境中明确指定依赖版本
- 清理缓存 遇到依赖问题时使用
flutter clean
和flutter pub get
通过掌握这些Flutter命令,开发者可以显著提升开发效率,更好地管理项目生命周期。建议将常用命令加入到开发工作流中,形成良好的开发习惯。