生成你的第一个应用

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

先决条件

  • 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. 等待项目创建及其依赖项还原完成:

    已恢复依赖项。

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

    为 .NET MAUI 选择 Android Emulator 调试目标。

  2. 在 Visual Studio 工具栏中,按下“Android Emulator”按钮:

    Android 仿真器按钮。

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

  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 Emulator”按钮:

    Android 仿真器按钮。

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

  8. 在“用户帐户控制”对话框中,按下“是”按钮:

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

  9. 在“新设备”窗口中,按“创建”按钮:

    “新建 Android 设备”窗口。

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

  10. 关闭 Android Device Manager 窗口。

    “Android 设备管理器”窗口。

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

    Pixel 5 API 34 仿真器按钮。

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

    警告

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

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

    在 Android 仿真器中运行的应用。

故障排除

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

  1. 在 Visual Studio 工具栏中,使用“调试目标”下拉列表选择“框架”,然后选择“net8.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 应用。

故障排除

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

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

后续步骤

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

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