详细介绍 dotnet new mauiapp 命令的完整使用说明和所有参数。
dotnet new mauiapp 详细使用说明
基本语法
bash
Apply
Run
dotnet new mauiapp [选项] [参数]
基本参数
1. 项目名称和输出路径
bash
Apply
Run
-n|--name <项目名称> # 项目名称
-o|--output <输出路径> # 项目输出路径
2. 框架版本 (-f|--framework)
bash
Apply
Run
-f net8.0 # .NET MAUI 8 (LTS)
-f net9.0 # .NET MAUI 9 (默认)
-f net10.0 # .NET MAUI 10 (预览版)
3. 编程语言 (-lang|--language)
bash
Apply
Run
-lang C# # C# (默认)
-lang F# # F# (部分功能支持)
核心配置参数
设计模式 (-dp|--design-pattern)
| 参数值 | 描述 |
|--------|------|
| Plain | 单页面应用（默认） |
| Hierarchical | 分层导航模式 |
| Tab | 标签页模式 |
| Shell | Shell路由导航 |
| Hybrid | Blazor混合模式 |
| JSHybrid | JavaScript混合模式（.NET 9+） |
| Markup | C# Markup语法 |
| Razor | Razor语法 |
目标平台 (-tp|--target-platform)
| 参数值 | 描述 |
|--------|------|
| All | 所有支持的平台（默认） |
| Mobile | Android和iOS |
| Desktop | Windows和macOS |
| Android | 仅Android |
| iOS | 仅iOS |
| macOS | 仅macOS (Mac Catalyst) |
| Windows | 仅Windows |
| Tizen | 仅Tizen |
| Apple | iOS和macOS |
| Base | 基础框架(.NET 8/9/10) |
MVVM相关参数
bash
Apply
Run
-mvvm|--use-mvvm # 启用MVVM模式 (默认: false)
-icb|--include-compiled-bindings # 包含编译绑定 (默认: false)
NuGet包相关参数
CommunityToolkit包
bash
Apply
Run
-it|--include-toolkit # CommunityToolkit.Maui (默认: false)
-im|--include-markup # CommunityToolkit.Maui.Markup (默认: false)
-imt|--include-mvvm-toolkit # CommunityToolkit.Mvvm (默认: false)
其他包
bash
Apply
Run
-ic|--include-camera # CommunityToolkit.Maui.Camera (默认: false)
-if|--include-foldable # Microsoft.Maui.Controls.Foldable (默认: false)
-ime|--include-media-element # CommunityToolkit.Maui.MediaElement (默认: false)
-inm|--include-maps # Microsoft.Maui.Controls.Maps (默认: false)
-isft|--include-syncfusion-toolkit # Syncfusion.Maui.Toolkit (默认: false)
-ist|--include-shared-toolkit # VijayAnand.Toolkit.Markup (默认: false)
项目结构参数
bash
Apply
Run
-mcl|--maui-class-library # 抽象为单独的MAUI类库 (默认: false)
-rcl|--razor-class-library # 抽象Razor组件为单独类库 (默认: false)
构建和部署参数
bash
Apply
Run
-wu|--windows-unpackaged # Windows未打包应用 (默认: false)
-cc|--conditional-compilation # 条件编译 (默认: false)
-cpm|--central-pkg-mgmt # 中央包管理 (默认: false)
-ni|--nightly # 使用每夜构建包 (默认: false)
-slnx|--use-slnx # 使用XML解决方案格式 (默认: false)
常用命令示例
基础应用创建
bash
Apply
Run
默认创建(.NET 9, 所有平台)
dotnet new mauiapp -o MyApp
指定.NET 8
dotnet new mauiapp -o MyApp -f net8.0
指定项目名称
dotnet new mauiapp -n MyMauiApp -o ./MyMauiApp
不同设计模式
bash
Apply
Run
Shell导航应用
dotnet new mauiapp -o MyApp -dp Shell
Blazor混合应用
dotnet new mauiapp -o MyApp -dp Hybrid
JavaScript混合应用(.NET 9+)
dotnet new mauiapp -o MyApp -dp JSHybrid
C# Markup应用
dotnet new mauiapp -o MyApp -dp Markup
目标平台选择
bash
Apply
Run
仅移动端
dotnet new mauiapp -o MyApp -tp Mobile
仅桌面端
dotnet new mauiapp -o MyApp -tp Desktop
仅Android
dotnet new mauiapp -o MyApp -tp Android
MVVM应用
bash
Apply
Run
基础MVVM
dotnet new mauiapp -o MyApp -mvvm
MVVM + 编译绑定
dotnet new mauiapp -o MyApp -mvvm -icb
MVVM + CommunityToolkit
dotnet new mauiapp -o MyApp -mvvm -imt
包含第三方包
bash
Apply
Run
包含所有CommunityToolkit包
dotnet new mauiapp -o MyApp -it -im -imt
包含媒体和地图功能
dotnet new mauiapp -o MyApp -ime -inm
包含Syncfusion工具包
dotnet new mauiapp -o MyApp -isft
高级配置
bash
Apply
Run
抽象为类库结构
dotnet new mauiapp -o MyApp -mcl
Blazor混合 + Razor类库
dotnet new mauiapp -o MyApp -dp Hybrid -rcl
中央包管理
dotnet new mauiapp -o MyApp -cpm
条件编译
dotnet new mauiapp -o MyApp -cc
每夜构建
dotnet new mauiapp -o MyApp -ni
综合示例
bash
Apply
Run
创建功能完整的Shell应用
dotnet new mauiapp \
-o MyAdvancedApp \
-dp Shell \
-mvvm \
-it -im -imt \
-ime -inm \
-cpm
F#应用
dotnet new mauiapp -o MyFSharpApp -lang F# -dp Hybrid
获取帮助
bash
Apply
Run
查看完整参数列表
dotnet new mauiapp --help
查看所有MAUI模板
dotnet new list | grep -i maui
查看模板详细信息
dotnet new mauiapp -h
注意事项
参数值不区分大小写
布尔参数：只需指定参数名即表示启用
组合使用：多个参数可以组合使用
F#限制：F#模板仅支持部分功能
平台特性：某些功能仅在特定.NET版本可用
这些参数提供了极大的灵活性，让您可以根据项目需求创建各种类型的MAUI应用程序。
