本教程将指导你如何在 Windows 上的 Visual Studio 2022 中，或者在 Windows、macOS 或 Linux 上的 Visual Studio Code 中，创建并运行你的第一个 .NET 多平台应用 UI (.NET MAUI) 应用，以帮助确保开发环境设置正确。
先决条件
在开始之前，请确保已安装 Visual Studio 2022 17.12 或更高版本，并已添加 .NET Multi-platform App UI 工作负载。具体安装步骤可参考官方安装文档。
创建应用
以下是在 Visual Studio 2022 中创建第一个 .NET MAUI 应用的基本步骤，适用于不同目标平台（如 Android、Windows 或 iOS）。本教程以 Android 模拟器为例，但也会涵盖其他平台的简要说明。
- 启动 Visual Studio 2022，在开始窗口中点击“创建新项目”以启动新项目创建流程。
- 在“创建新项目”窗口中，从“所有项目类型”下拉列表中选择“MAUI”，然后选择“.NET MAUI 应用”模板，并点击“下一步”。
- 在“配置新项目”窗口中，为项目命名并选择合适的位置，然后点击“创建”。
- 在“其他信息”窗口中，选择要面向的 .NET 版本，并点击“创建”。
- 等待项目创建完成及其依赖项自动还原。
在 Android 模拟器上运行
如果你的目标平台是 Android，请按以下步骤操作：
- 在 Visual Studio 工具栏中，使用“调试目标”下拉列表选择“Android Emulators”，然后选择“Android Emulator”条目。
- 点击工具栏中的“Android Emulator”按钮，Visual Studio 将启动默认 Android SDK 和模拟器的安装过程。在此过程中，你可能需要接受多个许可协议，并在用户账户控制对话框中确认操作。
- 等待 Visual Studio 下载并安装必要的 Android SDK 组件。如果出现“Android SDK 平台缺少”对话框，请点击“安装”按钮继续。
- 在“新设备”窗口中，点击“创建”以设置 Android 模拟器，然后关闭 Android Device Manager 窗口。
- 在工具栏中选择合适的模拟器（如 Pixel 7 - API 35），并点击按钮以生成并运行应用。Visual Studio 将启动 Android 模拟器，部署应用。
- 在模拟器中运行的应用中，点击“单击我”按钮，观察计数递增以验证应用功能。
在 Windows 上运行
如果你的目标平台是 Windows，操作更简单：
- 在 Visual Studio 工具栏中，点击“Windows 计算机”按钮以生成并运行应用。
- 在运行的应用中，多次点击“单击我”按钮，确认计数功能正常。
在 iOS 模拟器上运行（需 Mac 生成主机）
对于 iOS 开发，需要 Mac 生成主机：
- 首先，将 Visual Studio IDE 与 Mac 生成主机配对，具体步骤可参考官方配对指南。
- 在工具栏中，使用“调试目标”下拉列表选择“iOS 模拟器”，并选择特定模拟器。
- 点击所选模拟器的“开始”按钮，Visual Studio 将生成应用，启动远程 iOS 模拟器（适用于 Windows），并部署应用。
- 在运行的应用中，点击“单击我”按钮测试功能。
故障排除
如果应用编译或运行遇到问题，请参考官方排查指南，其中涵盖了常见问题的解决方案。对于 Android 模拟器相关问题，可查阅 Android 模拟器疑难解答文档；对于 iOS 开发，确保 Mac 配对正确。如果面向 Mac Catalyst，请注意只能使用 Visual Studio Code 启动和调试。