生成你的第一个应用

本教程介绍如何在 Windows 上的 Visual Studio 2022 或 Visual Studio 2022 for Mac 中创建和运行第一个 .NET Multi-platform App UI (.NET MAUI) 应用。 这有助于确保正确设置开发环境。

Visual Studio

先决条件

• Visual Studio 2022 17.8 或更高版本，并安装了 .NET Multi-platform App UI 工作负载。 有关详细信息，请参阅安装。

创建应用

在本教程中，你将在 Visual Studio 2022 中创建第一个 .NET MAUI 应用，并在 Android Emulator 上运行：

在 Windows 上开发适用于 iOS 的 .NET MAUI 应用需要 Mac 生成主机。 如果你不需要专门面向 iOS 且没有 Mac，请考虑从 Android 或 Windows 入手。

在本教程中，你将在 Visual Studio 中创建第一个 .NET MAUI 应用，并在 iOS 模拟器上运行它：

在本教程中，你将在 Visual Studio 2022 中创建第一个 .NET MAUI 应用并在 Windows 上运行它：

1. 启动 Visual Studio 2022。 在开始窗口中，单击“创建新项目”以创建新项目：

   

2. 在“创建新项目”窗口中，在“所有项目类型”下拉列表中选择“MAUI”，选择“.NET MAUI 应用”模板，然后单击“下一步”按钮：

   

3. 在“配置新项目”窗口中命名项目，为其选择合适的位置，然后单击“创建”按钮：

   

4. 在“其他信息”窗口中，选择要面向的 .NET 版本，然后单击“创建”按钮：

   

5. 等待项目创建及其依赖项还原完成：

   

6. 在 Visual Studio 工具栏中，使用“调试目标”下拉列表选择“Android Emulators”，然后选择“Android Emulator”条目：

   

7. 在 Visual Studio 工具栏中，按下“Android Emulator”按钮：

   

   Visual Studio 将开始安装默认的 Android SDK 和 Android Emulator。

8. 在“Android SDK - 许可协议”窗口中，选择“接受”按钮：

   

9. 在“Android SDK - 许可协议”窗口中，选择“接受”按钮：

   

10. 在“用户帐户控制”对话框中，按下“是”按钮：

    

11. 在“接受许可证”窗口中，选择“接受”按钮：

    

    等待 Visual Studio 下载 Android SDK 和 Android Emulator。

12. 在 Visual Studio 工具栏中，按下“Android Emulator”按钮：

    

    Visual Studio 将开始创建默认的 Android Emulator。

13. 在“用户帐户控制”对话框中，按下“是”按钮：

    

14. 在“新设备”窗口中，按“创建”按钮：

    

    等待 Visual Studio 下载、解压缩并创建 Android Emulator。

15. 关闭 Android Device Manager 窗口。

    

16. 在 Visual Studio 工具栏中，按下“Pixel 5 - API 34 (Android 14.0 - API 33)”按钮以生成并运行应用：

    

    Visual Studio 将启动 Android Emulator，生成应用并将其部署到仿真器。

    警告

    必须启用硬件加速，以最大限度提高 Android Emulator 的性能。 未能执行此操作将导致仿真器的运行速度非常缓慢。 有关详细信息，请参阅如何使用 Android 仿真器（Hyper-V 和 AEHD）启用硬件加速。

17. 在 Android 仿真器中运行的应用中，多次按下“单击”按钮，并观察按钮单击次数的计数递增。

    

故障排除

如果应用无法编译，请查看排查已知问题，可能会找到问题的解决方案。 如果问题与 Android Emulator 相关，请参阅 Android Emulator 疑难解答。

6. 在 Visual Studio 工具栏中，使用“调试目标”下拉列表选择“框架”，然后选择“net8.0-windows” 条目：

   

7. 在 Visual Studio 工具栏中，按下“Windows 计算机”按钮以生成并运行应用：

   

   如果未启用开发人员模式，Visual Studio 将提示你启用它。 在“为 Windows 启用开发人员模式”对话框中，单击“面向开发人员的设置”，以打开“设置”应用：

   

   在“设置”应用中，打开“开发人员模式”，并接受免责声明：

   

   关闭“设置”应用，然后关闭“为 Windows 启用开发人员模式”对话框。

8. 在正在运行的应用中，多次按下“单击”按钮，并观察按钮单击次数的计数递增：

   

故障排除

如果应用无法编译，请查看排查已知问题，可能会找到问题的解决方案。

6. 在 Visual Studio 中，将 IDE 与 Mac 生成主机配对。 有关详细信息，请参阅与 Mac 配对以进行 iOS 开发。

7. 在 Visual Studio 工具栏中，使用“调试目标”下拉列表选择“iOS 模拟器”，然后选择特定的 iOS 模拟器：

   

8. 在 Visual Studio 工具栏中，按下所选 iOS 模拟器的“开始”按钮，以生成并运行应用：

   

   Visual Studio 将生成应用，启动适用于 Windows 的远程 iOS 模拟器，并将应用部署到远程模拟器。 有关适用于 Windows 的远程 iOS 模拟器的更多信息，请参阅适用于 Windows 的远程 iOS 模拟器。

9. 在正在运行的应用中，多次按“单击”按钮，并观察按钮单击次数的计数递增。

   

故障排除

如果应用无法编译，请查看排查已知问题，可能会找到问题的解决方案。

只能使用 Visual Studio 2022 for Mac 来启动和调试面向 Mac Catalyst 的 .NET MAUI 应用。

Visual Studio for Mac

注意

根据 Microsoft 的现代生命周期策略，Visual Studio for Mac 计划于 2024 年 8 月 31 日停用。 在 2024 年 8 月 31 日 之前，Visual Studio for Mac 17.6 将继续受支持，并且可以获得 Apple 针对安全问题和更新平台提供的服务更新。 有关详细信息，包括用于在 Mac 上进行开发的替代选项，请参阅 Visual Studio for Mac 发生的情况。

先决条件

• Visual Studio 2022 for Mac 17.6，已安装 .NET、.NET MAUI、Android 和 iOS 工作负载。 有关详细信息，请参阅安装。

重要说明

若要将 Visual Studio for Mac 与 .NET 8 配合使用，需启用 Visual Studio > 首选项 > 其他 > 预览功能 > 如果已安装则使用 .NET 8 SDK（需要重启）”复选框。

创建应用

在本教程中，你将在 Visual Studio 2022 for Mac 中创建第一个 .NET MAUI 应用，并在所选平台上运行它：

1. 启动 Visual Studio 2022 for Mac。 在开始窗口中，单击“新建”，以创建新项目：

   

2. 在“为新项目选择一个模板”对话框中，选择“多平台 > 应用”，选择“.NET MAUI 应用”模板，然后单击“继续”按钮：

   

3. 在“配置新的 .NET MAUI 应用”窗口中，选择要面向的 .NET 版本，然后单击“继续”按钮：

   

4. 在“配置新 .NET MAUI 应用”窗口中，输入“MyMauiApp”作为项目名称，为项目选择合适的位置，然后单击“创建”按钮：

   

5. 等待项目创建及其依赖项还原完成：

   

6. 如果 Mac 缺少 Android SDK 组件，Visual Studio 2022 for Mac 会显示一个信息栏。 单击“安装”按钮以安装 Android SDK：

   

7. 在“Android SDK”窗口中，选中“自动下载并安装 Android 依赖项”复选框，然后单击“下载并安装”按钮：

   

8. 在“接受许可证”窗口中，单击“接受”按钮：

   

   等待 Visual Studio 2022 for Mac 下载 Android SDK：

9. 在 Visual Studio 2022 for Mac 工具栏中，将调试目标更改为“Android Emulator”：

   

10. 在 Visual Studio 2022 for Mac 工具栏中，按“播放”按钮以生成应用并尝试启动它：

    

    Visual Studio 2022 for Mac 将生成应用，然后创建默认的 Android Emulator。

11. 在“新设备”窗口中，单击“创建”按钮：

    

12. 在“接受许可证”窗口中，单击“接受”按钮：

    

    等待 Visual Studio 2022 for Mac 下载 Android SDK 和 Android Emulator。

13. 关闭 Android Device Manager 窗口。

    

14. 在 Visual Studio 2022 for Mac 工具栏中，将调试目标更改为“Pixel 5 - API 34 (API 34)”：

    

15. 在 Visual Studio 2022 for Mac 工具栏中，按“播放”按钮，在 Android Emulator 中启动应用：

    

    Visual Studio 2022 for Mac 将启动 Android Emulator，生成应用，并将应用部署到仿真器。

16. 在 Android Emulator 中正在运行的应用中，多次按“单击”按钮，并观察按钮单击次数的计数递增：

    

6. 在 Visual Studio 2022 for Mac 工具栏中，确保将调试目标设置为 iOS 模拟器：

   

7. 在 Visual Studio 2022 for Mac 工具栏中，按“播放”按钮，启动所选 iOS 模拟器内的应用：

   

   Visual Studio 2022 for Mac 将启动 iOS 模拟器，生成应用并将应用部署到模拟器。

8. 在正在运行的应用中，多次按下“单击”按钮，并观察按钮单击次数的计数递增：

   

6. 在 Visual Studio 2022 for Mac 工具栏中，确保将调试目标设置为“我的 Mac (MacCatalyst)”：

   

7. 在 Visual Studio 2022 for Mac 中，右键单击“MyMauiApp”项目并选择“编辑项目文件”。 然后，在项目文件编辑器中，在第一个 <ItemGroup> 之前插入以下 XML：

   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-maccatalyst|AnyCPU'">
       <RuntimeIdentifiers>maccatalyst-x64;maccatalyst-arm64</RuntimeIdentifiers>
   </PropertyGroup>
   

8. 在 Visual Studio 2022 for Mac 工具栏中，按下“播放”按钮，以在 Mac 上启动应用：

   

   Visual Studio 2022 for Mac 将生成并部署应用。

9. 在正在运行的应用中，多次按下“单击”按钮，并观察按钮单击次数的计数递增：

   

只能使用 Visual Studio 2022 启动和调试面向 Windows 的 .NET MAUI 应用。

Visual Studio Code（预览版）

注意

Visual Studio Code 中的 .NET MAUI 支持仍处于预览状态。 试用一下并分享你的反馈！

安装扩展

按照说明安装适用于 Visual Studio Code 的 .NET MAUI 扩展。

创建应用

若要创建新的 .NET MAUI 应用，请执行以下操作：

1. 在资源管理器中单击“创建 .NET 项目”，或单击CTRL/CMD+SHIFT+P>“.NET: 新建项目...”。
2. 选择“ .NET MAUI 应用”或“.NET MAUI Blazor 应用”。
3. 选择一个空文件夹。 如果文件资源管理器再次打开，则说明所选文件夹不是空的。
4. 为项目命名。
5. 确保项目在解决方案资源管理器中成功加载，然后打开 C# 或 XAML 文件。

还可以通过“文件 > 打开...”在 Visual Studio Code 中打开现有的 .NET MAUI 项目。

现在，你应该能在 Visual Studio Code 的 C# 开发工具包解决方案资源管理器中看到应用。 由于 .NET MAUI 扩展依赖于 C# 开发工具包，因此可以将其所有功能与 .NET MAUI 扩展一起使用。

选择目标设备

单击 Visual Studio Code 右下角的大括号符号 { }。 在这里，你可以更改启动项目，将调试目标更改为开发计算机上的任何有效内容，并将任一设置固定到 Visual Studio Code 状态栏：

还可以通过使用 CTRL/CMD+SHIFT+P 和搜索“.NET MAUI”，在命令面板中设置启动项目和调试目标。

默认情况下，可以部署到本地 macOS 或 Windows 开发计算机。 在 macOS 上，还可以部署到 iOS 模拟器。

如果要使用 Android Emulator，请执行以下步骤：

1. 在终端中导航到 <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/latest/bin/。
2. 在 Windows 上运行 sdkmanager --install emulator 和 sdkmanager --install system-images;android-33;google_apis;x86_64，或在 macOS 上运行 ./sdkmanager --install emulator 和 ./sdkmanager --install system-images;android-33;google_apis;x86_64。
3. 然后，可以使用 Android 的 avdmanager 在命令行上创建新的仿真器。 例如，可以在 Windows 上运行 avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"，或者在 macOS 上运行 ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"。

还可以在物理 Android 设备上进行调试。

调试应用

若要调试应用，请导航到 Visual Studio Code 的“运行并调试”菜单，然后选择“运行并调试”按钮。 或者，你也可以使用 F5 启动调试会话。 如果 Visual Studio Code 提示你选择调试器，请确保选择“.NET MAUI”。

调试器将自动选择在大括号 { } 菜单中设置的调试目标和启动项目。 如果尚未选择任何内容，则会提示你选择调试目标。

应用开始调试后，可以使用内置的 Visual Studio Code 调试工具设置断点、逐步执行代码等。

了解详细信息

如果遇到与扩展相关的任何问题，可以按照疑难解答步骤操作，查看已知问题或提供反馈。

后续步骤

本教程介绍了如何创建和运行第一个 .NET Multi-platform App UI (.NET MAUI) 应用。

若要了解使用 .NET MAUI 生成应用的基础知识，请参阅创建 .NET MAUI 应用。 或者，如需完整的 .NET MAUI 培训课程，请参阅使用 .NET MAUI 生成移动和桌面应用。