简介
目标
设置开发环境并生成第一个 .NET 多平台应用 UI (.NET MAUI)应用。
先决条件
无。
完成时间
10分钟 + 下载/安装时间
方案
在 Windows 和 Android 上运行的移动和桌面应用,它显示消息: "Hello, World!"
。
本地预配向导和预配代理。
下载并安装 Visual Studio 2022 预览版。
下载 Visual Studio 2022 预览版
在安装过程中,应选择“.NET Multi-platform App UI 开发”工作负载。使用上面的链接时应预先正确选择所有先决条件,如下图所示:

Visual Studio 中的工具支持仍处于预览状态,因此 .NET MAUI 仅在 Visual Studio 2022 预览版上提供,而在 Visual Studio 2022 上不可用。
已有 Visual Studio 2022 预览版?
如果已有 Visual Studio 2022 预览版,则可以更新安装以添加 .NET MAUI 支持。
更新 Visual Studio 2022 预览版
若要手动添加所需的工作负荷,请执行以下操作:
- 选择 Windows 徽标键,键入 Visual Studio 安装程序,然后按“输入”。
- 如果出现提示,则请允许安装程序进行自我更新。
- 如果 Visual Studio 2022 预览版的更新可用,则将显示更新 按钮。选择该按钮以在修改安装前进行更新。
- 找到 Visual Studio 2022 预览安装并选择修改。
- 选择“NET Multi-Platform App UI 开发”。
- 选择修改按钮。
创建应用
新建 .NET MAUI 应用:
- 打开 Visual Studio 2022 预览版。
- 选择创建新项目按钮。
- 从项目类型下拉菜单中选择 MAUI。
-
选择“.NET MAUI 应用”模板并选择“下一步”按钮。

-
输入 MyFirstMauiApp 作为项目名称,然后选择创建按钮。

Visual Studio 创建新项目。如果收到 Windows 安全中心警报,警告防火墙阻止了某些功能,请选择“允许访问”按钮。
还原 NuGet 包
NuGet 是一个包管理器,它将引入新应用的依赖项。
包还原过程将自动启动。请等候,直到 已还原 或 就绪 消息显示在屏幕左下角的状态栏中。

运行应用
本教程将首先重点介绍如何将 .NET MAUI 应用程序部署到本地 Windows 计算机。然后可以选择设置 Android 设备或仿真器。
设置用于开发的 Windows
如果要开发 Windows 应用程序,将需要启用开发人员模式,以便在 Windows 11 或 Windows 10 上旁加载应用程序。
启用开发人员模式
- 在 Windows 上,转到设置应用程序。
- 搜索开发人员设置,可在 Windows 11 的隐私与安全或 Windows 10 中的更新与安全中的开发人员选项下找到它。
-
在“开发人员模式”下打开开关。

-
显示了使用开发人员功能对话框。选择是确认要启用开发人员模式。

在 Windows 上运行
现在可以运行 .NET MAUI 应用并将其部署到 Windows。
在工具栏中,应会看到默认将 Windows 计算机设置为调试目标。

要运行应用,请从主菜单中选择“调试”>“开始调试”(或按 F5)。

恭喜你已生成并运行自己第一个 .NET MAUI 应用!
编辑代码
当使用 .NET MAUI 开发应用程序时,在调试应用程序时可使用 XAML 热重载。这意味着可以在应用程序运行时更改 XAML 用户界面(UI),并且 UI 将自动更新。
返回到 Visual Studio,并使应用保持运行状态。在解决方案资源管理器中,双击 MyFirstMauiApp
项目中的 MainPage.xaml
文件。
目前,第一个 Label
的 Text
设置为 Hello, World!
如以下代码所示:
MainPage.xaml
<Label
Text="Hello, World!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" >
将文本更新为 Hello, .NET MAUI!
:
MainPage.xaml
<Label
Text="Hello, .NET MAUI!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" >
在你进行更改时,应用 UI 会自动更新。

使用 .NET MAUI 开发应用程序时,还可以使用 .NET 热重载重新加载 C# 代码。让我们修改应用程序中的逻辑,将计数递增 10 而不是 1。
打开 MainPage.xaml.cs
(此文件嵌套在 MainPage.xaml 下,或者可以右键单击并从菜单中选择“查看代码”)。

The OnCounterClicked
method on that file currently has the following code:
MainPage.xaml.cs
private void OnCounterClicked(object sender, EventArgs e)
{
count++;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
更新 count++;
,让它按 10 递增,方法是将其更改为 count += 10;
。
MainPage.xaml.cs
private void OnCounterClicked(object sender, EventArgs e)
{
count += 10;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
若要应用代码更改,请在 Visual Studio 中选择热重载按钮,或选择 ALT+F10。

选择“单击我”按钮,你讲看到其按 10 递增。干的好! 现在可以关闭正在运行的应用。
配置 Android 设备
可以根据开发环境决定部署到一个或多个平台。你刚刚运行应用并将其部署到 Windows。现在,我们来设置一个 Android 设备或仿真器。
Android SDK 安装
在调试下拉菜单中的“框架”下选择 "net6.0-android”。

生成项目需要特定版本的 Android SDK。如果尚未接受 Android SDK 许可证,则会在“错误列表”窗口上看到以下错误消息。

双击消息以启动许可证接受过程。为每个出现的许可证单击“接受”,然后将开始自动安装。

设置 Android Emulator
如果没有要部署到的 Android 设备,则可以设置 Android Emulator。如果已执行此操作,则可以跳过此步骤。
如果是首次生成 .NET MAUI 应用程序,你将会在调试菜单中看到 "Android Emulator"。单击它将启动创建过程。

这将显示用户帐户控制提示。如果选择“是”按钮,将启动仿真器创建过程。如果选择“创建”,则会创建具有默认设置的仿真器。

此时,系统可能会提示你同意 Android Emulator 的许可协议。请阅读并选择“接受”以继续此流程。此操作会下载仿真程序映像并完成创建,以便在 Visual Studio 中使用仿真程序。
创建仿真程序后,将会看到一个按钮,显示“开始”。单击此按钮。

你可能会收到启用 Windows 虚拟机监控程序平台的提示。按照文档操作,以启用加速来提高性能(强烈建议)。

Android 仿真器将启动。等待它完全启动后,你将看到它会显示在 Visual Studio 调试菜单中。这可能需要一些时间。

你的 Android 仿真器现已创建并可供使用。下次运行 Visual Studio 时,仿真器将直接显示在调试目标窗口中,并在选择它时启动。如果遇到任何问题或模拟器存在性能问题,请阅读 完整安装文档。
设置 Android 设备
若要使用 Android 设备进行开发,需要启用 USB 调试。请在设备上执行以下步骤,将设备连接到 Visual Studio。如果没有 Android 设备,可以跳过此部分。
启用开发人员模式
- 转到“设置”屏幕。
- 使用设置屏幕顶部的搜索功能查找内部版本号或在“关于手机”中查找。
- 点击“内部版本号”7-10 次,直到弹出 “你现在是开发人员!”。
- 单击“创建”。

检查 USB 调试状态
- 转到“设置”屏幕。
- 使用设置屏幕顶部的搜索功能查找“USB 调试”或在开发人员选项中查找。
- 启用 USB 调试(如果尚未启用)。

信任设备
- 将设备插入计算机。
- 系统将提示你允许 USB 调试。
- 检查 始终允许从此计算机。
- 单击“允许”。

你的设备现在已配置,并将作为部署目标显示在 Visual Studio 中。
有任何问题?查看此文档。
现在应该配置仿真程序或设备,以进行部署!
在 Android 上运行
确保将设备或仿真器选作调试目标。

在菜单中选择“调试”>“开始调试”(或按 F5)。如果禁用此选项,请确保已选择仿真器或设备。
应用程序将生成、部署到所选 Android 设备/仿真器,然后运行。

后续步骤
恭喜你已生成并运行自己第一个 .NET MAUI 应用!
继续学习
现在,你已掌握基本信息,请继续学习如何在 Microsoft Learn 上通过自我引导式学习路径构建 .NET MAUI 应用。
.NET MAUI 学习路径
.NET MAUI for Beginners
Let James walk you through building a full .NET MAUI app from start to finish:
你可能还会关注...