生成首个应用

  • 项目

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

先决条件

  • Visual Studio 2022 17.3 或更高版本，已安装 .NET 多平台应用 UI 工作负载。 有关详细信息，请参阅安装。

创建应用

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

在 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. 等待项目创建并还原其依赖项：

    已恢复依赖项。

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

    选择 .NET MAUI 的 Android 模拟器调试目标。

  2. 在 Visual Studio 工具栏中，按 Android 模拟器 按钮：

    Android 模拟器按钮。

    Visual Studio 将开始安装默认的 Android SDK 和 Android 模拟器。

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

    第一个 Android SDK 许可协议窗口。

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

    第二个 Android SDK 许可协议窗口。

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

    Android SDK 许可证用户帐户控制对话框。

  6. 在 “许可接受” 窗口中，按“ 接受” 按钮：

    Android 设备许可证窗口。

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

  7. 在 Visual Studio 工具栏中，按 Android 模拟器 按钮：

    Android 模拟器按钮。

    Visual Studio 将开始创建默认的 Android 模拟器。

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

    Android 设备管理器用户帐户控制对话框。

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

    “新建 Android 设备”窗口。

    等待 Visual Studio 下载、解压缩和创建 Android 模拟器。

  10. 关闭 Android 设备管理器 窗口：

    Android 设备管理器窗口。

  11. 在 Visual Studio 工具栏中，按 Pixel 5 - API 30 (Android 11.0 - API 30) 按钮生成并运行应用：

    “Pixel 5 API 30 仿真器”按钮。

    Visual Studio 将启动 Android 模拟器、生成应用并将应用部署到模拟器。

    警告

    必须启用硬件加速才能最大程度地提高 Android 仿真器的性能。 如果不这样做，将导致仿真器运行非常缓慢。 有关详细信息，请参阅 如何使用 Android 模拟器启用硬件加速 (Hyper-V & AEHD) 。

  12. 在 Android 模拟器中正在运行的应用中，多次按 “单击我” 按钮，并观察按钮单击次数的计数递增。

    在 Android 模拟器中运行的应用。

故障排除

如果应用无法编译，请查看 排查已知问题，其中可能提供了解决问题的方法。 如果问题与 Android 模拟器相关，请参阅 Android 模拟器故障排除。

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

    为 .NET MAUI 选择 Windows 计算机调试目标。

  2. 在 Visual Studio 工具栏中，按 Windows 计算机 按钮生成并运行应用：

    在 Visual Studio 中运行 .NET MAUI 应用按钮。

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

    “启用 Windows 开发人员模式”对话框。

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

    Windows 11设置应用上的开发人员模式切换。

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

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

    在 Windows 上运行的 .NET MAUI 应用。

故障排除

如果应用无法编译，请查看 排查已知问题，其中可能提供了解决问题的方法。

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

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

    Visual Studio iOS 模拟器调试目标。

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

    Visual Studio iOS 模拟器调试目标选择。

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

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

    在 Mac 上的 iOS 模拟器中运行的 .NET MAUI 应用。

故障排除

如果应用无法编译，请查看 排查已知问题，其中可能提供了解决问题的方法。

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

后续步骤

本教程介绍了如何创建和运行第一个 .NET 多平台应用 UI (.NET MAUI) 应用。

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