新建项目:

// 查询环境
flutter --version

// 新建安卓项目（当前目录）
flutter create --platforms=android .

// flutter 静态代码分析工具
flutter analyze

环境检查

// 检查 Flutter/Android SDK/设备等环境状态
flutter doctor

// 接受Android许可，解决构建阻塞
flutter doctor --android-licenses

// 查看当前 Flutter 版本与通道
flutter --version

// 升级 Flutter 到最新稳定版
flutter upgrade

设备与模拟器

// 列出已连接的设备与模拟器
flutter devices

// 列出现有模拟器并显示可启动的 ID
flutter emulators

// 启动指定模拟器（例如 emulator-5554 ）
flutter emulators --launch <emulator_id>
如：flutter emulators --launch Medium_Phone

// 列出 AVD 名称
%ANDROID_SDK_ROOT%\emulator\emulator.exe -list-avds

// 启动指定 AVD
%ANDROID_SDK_ROOT%\emulator\emulator.exe -avd <avd_name>

// 查看可安装的系统镜像
%ANDROID_SDK_ROOT%\cmdline-tools\latest\bin\sdkmanager.bat --list

// 查看可用设备模板
%ANDROID_SDK_ROOT%\cmdline-tools\latest\bin\avdmanager.bat list device

// 创建 AVD（需先用 sdkmanager 安装对应系统镜像）
%ANDROID_SDK_ROOT%\cmdline-tools\latest\bin\avdmanager.bat create avd -n <name> -k "system-images;android-34;google_apis;x86_64"

运行与调试

// 以 Debug 模式运行到已连接设备/模拟器
flutter run

// 指定设备运行（例如 flutter run -d emulator-5554 ）
flutter run -d <device_id> 

// 以 Release 模式运行以接近真实性能
flutter run --release 

// 以 Profile 模式运行用于性能分析
flutter run --profile 

- 交互快捷键：终端运行时按 r 热重载、 R 热重启、 q 退出

// 查看连接设备的应用日志
flutter logs 

构建与发布

// 生成 Release APK
flutter build apk --release 

// 生成按 ABI 拆分的更小体积 APK
flutter build apk --split-per-abi 

// 生成 AAB（用于 Play 商店）
flutter build appbundle --release 

// 生成 Debug APK 便于快速安装
flutter build apk --debug 

// 构建非调试（Release）版本的 Android APK
flutter build apk --release

依赖、代码质量与测试

// 拉取依赖
flutter pub get 

// 升级依赖到兼容的高版本
flutter pub upgrade 

// 静态分析（当前项目已“无问题”）
flutter analyze 

// 统一代码风格
dart format . 或 flutter format . 

// 运行单元/组件测试（项目含 test/widget_test.dart ）
flutter test 

清理与维护

// 清理构建与缓存文件，解决异常构建问题
flutter clean 

// 修复依赖缓存
flutter pub cache repair
 
// 检查依赖是否有可更新版本
flutter pub outdated 

Android 原生构建（android 子目录）

// 查看可用 Gradle 任务
cd android; .\gradlew tasks 

// 生成 Debug 构建
cd android; .\gradlew assembleDebug 

// 生成 Release 构建（需签名配置）
cd android; .\gradlew assembleRelease 

// 安装到已连接设备
cd android; .\gradlew installDebug 

常用参数（可与 run/build 组合）

// 传入运行时配置（如接口地址、开关）
--dart-define=KEY=VALUE 

// 使用构建风味（需在工程中配置）
--flavor <name> 

// 指定入口文件（默认 lib/main.dart ）
--target <lib/xxx.dart> 

// 明确选择设备
-d <device_id> 

// 输出详细日志便于问题定位
-v 或 --verbose