本地预配向导和预配代理。
下载并安装 Visual Studio 2022。
下载 Visual Studio 2022
在安装过程中,应选择“.NET Multi-platform App UI 开发”工作负载。使用上面的链接时应预先正确选择所有先决条件,如下图所示:
![Visual Studio 安装程序与已选择 .NET 工作负载的移动开发]()
已有 Visual Studio 2022?
如果已有 Visual Studio 2022,则可以更新安装以添加 .NET MAUI 支持:
- 选择 Windows 徽标键,键入 Visual Studio 安装程序,然后按“输入”。
- 如果出现提示,则请允许安装程序进行自我更新。
- 如果 Visual Studio 2022 的更新可用,则将显示更新 按钮。选择该按钮以在修改安装前进行更新。
- 找到 Visual Studio 2022 安装并选择 修改。
- 选择“NET Multi-Platform App UI 开发”。
- 选择修改按钮。
下载并安装 Visual Studio 2022 for Mac。
下载 Visual Studio 2022 for Mac
在安装过程中,请确保选择了以下工作负载:
- .NET
- .NET MAUI
- Android
- iOS
选择 .NET MAUI 后,应会自动选择最后两个工作负载(Android 和 iOS)。
检查 Visual Studio 更新
本教程针对最新版本的 Visual Studio for Mac 进行了优化。如果已有 Visual Studio 2022 for Mac,则可以检查更新:
- 打开 Visual Studio for Mac。
- 在菜单栏中,选择 Visual Studio > “检查更新”。
- 将显示可用更新并选择“更新”。
安装 Xcode
要生成.NET MAUI 应用,还需要:
安装 Xcode 后,如果出现提示,则必须打开 Xcode,同意服务条款并安装可选组件。
运行应用
本教程将首先重点介绍如何将 .NET MAUI 应用程序部署到本地 Windows 计算机。然后可以选择设置 Android 设备或仿真器。
在 Visual Studio 工具栏中,应默认将“Windows 计算机”视为调试目标。按“Windows 计算机”按钮生成并运行应用:
![默认情况下已选择 Windows 计算机作为目标部署]()
如果尚未启用开发人员模式,Visual Studio 将提示你启用它。在“为 Windows 启用开发人员模式”对话框中,单击“面向开发人员的设置”链接以打开“设置”应用:
![“为 Windows 启用开发人员模式”对话框。]()
在“开发人员模式”下打开开关。
![已启用 Windows 开发人员模式]()
显示了使用开发人员功能对话框。选择是确认要启用开发人员模式。
![使用突出显示了“是”按钮的“开发人员功能”窗口]()
关闭“设置”应用,然后关闭“为 Windows 启用开发人员模式”对话框。应用应开始运行。
在正在运行的应用中,选择“单击这里”按钮几次,并观察按钮单击次数的计数是递增的:
![.NET MAUI 应用在 Windows 上运行。显示了]()
本教程将首先重点介绍如何将 .NET MAUI 应用程序部署到本地 Mac 计算机。然后,你可以选择设置 Android 设备或仿真器。
在 Visual Studio 工具栏中,默认情况下,应将“我的 Mac”视为调试目标。按“播放”图标(▶)生成并运行应用:
![默认情况下,已将我的 Mac 选为目标部署]()
在正在运行的应用中,选择“单击这里”按钮几次,并观察按钮单击次数的计数是递增的:
![.NET MAUI 应用在 Mac 上运行。显示了“Hello, World!”消息。]()
恭喜,你已生成并运行第一个 .NET MAUI 应用! 使应用保持运行并继续学习本教程。
编辑代码
当使用 .NET MAUI 开发应用程序时,在调试应用程序时可使用 XAML 热重载。这意味着可以在应用程序运行时更改 XAML 用户界面(UI),并且 UI 将自动更新。
返回到 Visual Studio,使应用保持运行状态。在“解决方案资源管理器”中,双击 MyFirstMauiApp
项目下的 MainPage.xaml
文件。如果看不到“解决方案资源管理器”窗格,请从主菜单中选择“视图”>“解决方案资源管理器”(或按 Ctrl+ALT+L)。
![突出显示 MainPage.xaml 文件的“解决方案资源管理器”窗格。]()
返回到 Visual Studio,并使应用保持运行状态。在“解决方案”窗口中,双击“MyFirstMauiApp
”项目下的“MainPage.xaml
l”文件。如果看不到“解决方案”窗口,请从主菜单中选择“视图”>“解决方案”。
![突出显示 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 下,或者可以右键单击并从菜单中选择“查看代码”)。
![下拉选项以显示 MainPage.xaml 背后的代码]()
该文件上的 OnCounterClicked
方法当前具有以下代码:
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。
![下拉选项以显示 MainPage.xaml 背后的代码]()
选择“单击这里”按钮,你将看到其按 10 递增。很棒! 现在可以关闭正在运行的应用。
配置 Android 设备
可以根据开发环境决定部署到一个或多个平台。你刚刚运行应用并将其部署到 Windows。现在,我们来设置一个 Android 设备或仿真器。
Android SDK 安装
从调试目标下拉菜单中,在“框架”下选择“net7.0-android”。
![选择 Android 作为目标部署]()
生成项目需要特定版本的 Android SDK。如果尚未接受 Android SDK 许可证,则会在“错误列表”窗口上看到以下错误消息。
![“错误列表”窗口上的错误消息,显示未接受 Android SDK 许可证。]()
双击消息以启动许可证接受过程。为每个出现的许可证单击“接受”,然后将开始自动安装。
![要求用户安装特定的 Android SDK 版本生成项目的 Android SDK 提示。]()
设置 Android Emulator
如果没有要部署到的 Android 设备,可以按照以下步骤设置 Android 仿真器。如果已执行此操作或想要使用自己的 Android 设备,则可以跳过此步骤。
如果这是你第一次构建 .NET MAUI 应用程序,则会在调试目标下拉菜单中看到选中了 Android Emulator。单击它即可开始创建过程。如果出现许可证接受对话框,请选择“接受”。
![Visual Studio 2022 工具栏菜单显示 'Android Emulator' 为调试目标。]()
此时将打开“新设备”窗口。请选择“创建”按钮以使用默认设置创建仿真器。这将下载仿真器图像并完成仿真器的创建以在 Visual Studio 中使用。此步骤可能需要一段时间。
![用于新建填充了默认设置的 Android 仿真器的对话框。]()
创建仿真程序后,将会看到一个按钮,显示“开始”。单击此按钮。
![Android 仿真器管理器显示仿真器已创建且已准备运行。]()
你可能会收到启用 Windows 虚拟机监控程序平台的提示。按照文档启用加速以提高性能(需要让仿真器启动并运行)。
![提示启用 Windows 虚拟机监控程序平台]()
Android 仿真器将启动。等待它完全启动后,你将看到它会显示在 Visual Studio 调试菜单中。这可能需要一些时间。
![Visual Studio 2022 工具栏菜单,其中显示了新建的 Android emulator 为调试目标。]()
你的 Android 仿真器现已创建并可供使用。下次运行 Visual Studio 时,仿真器将直接显示在调试目标窗口中,并在选择它时启动。如果遇到任何问题或模拟器存在性能问题,请阅读 完整安装文档。
可以根据开发环境决定部署到一个或多个平台。你刚刚运行应用并将其部署到 Mac。现在,我们来设置一个 Android 设备或仿真器。
如果是首次生成 .NET MAUI 应用程序,则需要创建新的 Android Emulator。你将在调试菜单中看到“Android Emulator”。按“播放”图标(▶)以开始创建过程。
![ViVisual Studio for Mac 工具栏菜单显示“选择设备”作为调试目标。]()
系统会自动为基本模拟器填充选项。如果需要,请更改任意选项,然后选择“ 创建”。
![用于新建填充了默认设置的 Android 仿真器的对话框。]()
此时,系统可能会提示你同意 Android Emulator 的许可协议。请阅读并选择“接受”以继续此流程。此操作会下载仿真程序映像并完成创建,以便在 Visual Studio 中使用仿真程序。
创建仿真器后,将会看到一个按钮,显示“播放”。请单击此按钮。
![Android 仿真器管理器显示仿真器已创建且已准备运行。]()
Android 仿真器将启动。等待它完全启动后,你将看到它会显示在 Visual Studio 调试菜单中。如果不使用硬件加速,这个过程可能需要一些时间。
![Visual Studio for Mac 工具栏菜单显示新建的 Android 仿真器作为调试目标。]()
你的 Android 仿真器现已创建并可供使用。下次运行 Visual Studio 时,仿真器将直接显示在调试目标窗口中,并在选择它时启动。如果遇到任何问题或模拟器存在性能问题,请阅读 完整安装文档。
设置 Android 设备
若要使用 Android 设备进行开发,需要启用 USB 调试。请在设备上执行以下步骤,将设备连接到 Visual Studio。如果没有 Android 设备,可以跳过此部分。
启用开发人员模式
- 转到“设置”屏幕。
- 使用设置屏幕顶部的搜索功能查找内部版本号或在“关于手机”中查找。
- 点击“内部版本号”7-10 次,直到弹出 “你现在是开发人员!”。
![Android 设备关于电话屏幕的设置屏幕,正在显示版本号。]()
检查 USB 调试状态
- 转到“设置”屏幕。
- 使用设置屏幕顶部的搜索功能查找“USB 调试”或在开发人员选项中查找。
- 启用 USB 调试(如果尚未启用)。
![关于开发人员设置屏幕上的 Android 设备的设置屏幕,显示已启用的 USB 调试选项。]()
信任设备
- 将设备插入计算机。
- 系统将提示你允许 USB 调试。
- 检查 始终允许从此计算机。
- 单击“允许”。
![Android 设备提示你允许从计算机上对设备进行 USB 调试。]()
你的设备现在已配置,并将作为部署目标显示在 Visual Studio 中。
有任何问题?查看此文档。
现在应该配置仿真程序或设备,以进行部署!
在 Android 上运行
确保将设备或仿真器选作调试目标。
![将 Android 仿真器 Pixel 5 设置为调试目标。]()
在菜单中选择“调试”>“开始调试”(或按 F5)。如果禁用此选项,请确保已选择仿真器或设备。
![将 Android 仿真器 Pixel 5 设置为调试目标。]()
在菜单中选择“调试”>“启动调试”。如果禁用了此选项,请确保已选择模拟器或设备。
应用程序将生成、部署到所选 Android 设备/仿真器,然后运行。
![运行 .NET MAUI 应用的 Android Emulator。显示了]()