Flutter CLI 命令大全及 flutter create 参数详解
一、Flutter 常用命令简介
| 命令 | 作用描述 |
|---|---|
flutter create <project> |
创建一个新的 Flutter 项目 |
flutter run |
在设备上运行 Flutter 应用 |
flutter build |
构建 Flutter 应用的不同版本（apk, ios 等） |
flutter doctor |
检查环境配置，诊断 Flutter 安装问题 |
flutter clean |
清理构建缓存 |
flutter pub get |
获取依赖包 |
flutter analyze |
代码静态分析 |
flutter test |
运行测试 |
flutter packages pub run build_runner build |
运行代码生成工具 |
二、flutter create 命令详解
flutter create 是用来创建新的 Flutter 项目的命令，支持创建多种类型项目，比如 app、plugin、package 等。
基本用法
flutter create [options] <output directory>
-
<output directory>: 要创建项目的文件夹名称。
主要参数选项
| 参数 | 说明 | 示例 |
|---|---|---|
--template=<type> |
创建项目的类型。常用类型有：app（默认）、plugin、package、module
|
--template=plugin |
--platforms=<platforms> |
指定支持的平台，逗号分隔。支持：android、ios、linux、macos、windows、web
|
--platforms=android,ios,web |
--org=<org> |
定义包的组织标识符，通常是反向域名，用于 Android 包名和 iOS Bundle Identifier | --org=com.example |
--project-name=<name> |
指定项目名，默认使用目录名 | --project-name=my_app |
--description=<desc> |
项目描述 | --description="My cool app" |
--android-language=<lang> |
Android 代码语言，支持 kotlin（默认）和 java
|
--android-language=java |
--ios-language=<lang> |
iOS 代码语言，支持 swift（默认）和 objc
|
--ios-language=objc |
--null-safety |
是否开启 null safety，默认开启 | --null-safety |
--offline |
使用离线缓存，不从网络拉取依赖 | --offline |
--list-templates |
列出所有可用的模板 | flutter create --list-templates |
常用模板类型说明
| 模板类型 | 描述 |
|---|---|
app |
创建 Flutter 应用（默认） |
plugin |
创建 Flutter 插件，包含平台代码 |
package |
创建 Flutter/Dart 包，没有平台代码 |
module |
创建 Flutter 模块，用于集成到已有项目 |
举例说明
-
创建一个 Flutter 应用：
flutter create my_app -
创建一个支持 Android 和 iOS 的插件，使用 Kotlin 和 Swift：
flutter create --template=plugin --platforms=android,ios --android-language=kotlin --ios-language=swift my_plugin -
创建一个 Flutter package（无平台代码）：
flutter create --template=package my_package -
查看所有可用模板：
flutter create --list-templates
三、其他常用 Flutter 命令及作用
| 命令 | 用法示例 | 作用说明 |
|---|---|---|
flutter doctor |
flutter doctor -v |
检查 Flutter 环境及依赖安装情况 |
flutter run |
flutter run |
运行 Flutter 应用，支持热重载 |
flutter build apk |
flutter build apk --release |
构建 Android APK 发布包 |
flutter build ios |
flutter build ios --release |
构建 iOS 应用 |
flutter clean |
flutter clean |
清理构建缓存 |
flutter pub get |
flutter pub get |
获取依赖包 |
flutter pub upgrade |
flutter pub upgrade |
升级依赖包到最新版本 |
flutter analyze |
flutter analyze |
对项目代码进行静态分析 |
flutter test |
flutter test |
运行单元测试 |
flutter format |
flutter format lib/main.dart |
格式化 Dart 代码 |
flutter pub outdated |
flutter pub outdated |
显示依赖包的可升级版本 |
四、flutter create 的模板和平台参数补充说明
| 参数 | 详细说明 |
|---|---|
--template=plugin |
创建插件，生成支持 Android 和 iOS（可指定其他平台）的插件模板。 |
--template=package |
创建纯 Dart 包，不包含原生代码。 |
--template=module |
创建 Flutter 模块，便于集成到现有原生项目中。 |
--platforms= |
逗号分隔，指定插件支持的平台，如 android,ios,web,windows。 |
--android-language |
指定插件 Android 端使用语言 kotlin 或 java。 |
--ios-language |
指定插件 iOS 端使用语言 swift 或 objc。 |
五、总结
-
flutter create是你启动 Flutter 项目和插件的关键命令，掌握它能帮你快速搭建项目基础结构。 - 你可以根据需求灵活指定模板和平台支持。
- 结合其他 Flutter CLI 命令，你可以高效地管理项目依赖、构建、调试和测试。
附录
-
查看所有 Flutter 命令及说明：
flutter --help -
查看某个命令的详细帮助：
flutter create --help
