生成首个应用

本教程介绍如何在 Windows Visual Studio 2022 17.3 预览版中创建和运行第一个 .NET 多平台应用 UI (.NET MAUI) 应用。

重要

.NET 多平台应用 UI (.NET MAUI) 目前为预览版。 此内容与发布前可能进行实质性修改的预发布产品相关。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。

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

Visual Studio for Mac支持人员将抵达将来的版本。

Visual Studio 开始 2022 17.3 (预览版)

在本教程中,你将在 Visual Studio 2022 17.3 预览版中创建第一个 .NET MAUI 应用,并在Android模拟器上运行它:

  1. 若要创建 .NET MAUI 应用,需要最新的 Visual Studio 2022 17.3 预览版:

    Download Visual Studio 2022 Community Preview

    Download Visual Studio 2022 Professional Preview

    Download Visual Studio 2022 Enterprise Preview

    安装Visual Studio或修改安装,并使用默认可选安装选项安装 .NET 多平台应用 UI 开发工作负载:

    Visual Studio workloads for .NET MAUI.

在本教程中,你将在 Visual Studio 17.3 预览版中创建第一个 .NET MAUI 应用,并在iOS模拟器上运行它:

  1. 若要创建 .NET MAUI 应用,需要最新的 Visual Studio 2022 17.3 预览版:

    Download Visual Studio 2022 Community Preview

    Download Visual Studio 2022 Professional Preview

    Download Visual Studio 2022 Enterprise Preview

    安装Visual Studio或修改安装,并使用默认可选安装选项安装 .NET 多平台应用 UI 开发工作负载:

    Visual Studio workloads for .NET MAUI.

在本教程中,你将在 Visual Studio 2022 17.3 预览版中创建第一个 .NET MAUI 应用,并在Windows上运行它:

  1. 若要创建 .NET MAUI 应用,需要最新的 Visual Studio 2022 17.3 预览版:

    Download Visual Studio 2022 Community Preview

    Download Visual Studio 2022 Professional Preview

    Download Visual Studio 2022 Enterprise Preview

    安装Visual Studio或修改安装,并使用默认可选安装选项安装 .NET 多平台应用 UI 开发工作负载:

    Visual Studio workloads for .NET MAUI.

  1. 启动 Visual Studio 2022 17.3 预览版,然后在开始窗口中单击“创建新项目”以创建新项目:

    New solution.

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

    Choose a template.

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

    Configure the project.

  4. 等待创建项目并还原其依赖项:

    Restored dependencies.

    注意

    如果这是首次创建 .NET MAUI 应用,系统可能会提示你安装Android SDK。 这是因为新的 .NET MAUI 应用的默认生成目标Android。

    如果要在Android上定位并运行,请导航到本文的开头,然后选择Android了解如何安装 Android SDK 并创建虚拟Android设备。

  5. “Android SDK 许可证接受”窗口中,按“接受”按钮:

    Android SDK License Acceptance window.

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

    Android SDK license user account control dialog.

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

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

    Windows command processor user account control dialog.

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

    Select the Android Emulator debugging target for .NET MAUI.

  2. 在Visual Studio工具栏中,按Android Emulator按钮生成应用:

    Android emulator button.

    重要

    必须启用硬件加速才能最大化Android仿真器性能。 有关详细信息,请参阅如何使用 Android 模拟器 (Hyper-V & HAXM) 启用硬件加速

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

    Android Device Manager user account control dialog.

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

    New Android Device window.

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

  5. 关闭Android 设备管理器窗口:

    Android Device Manager window.

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

    Pixel 5 API 30 emulator button.

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

    警告

    必须启用硬件加速才能最大化Android仿真器性能。 无法执行此操作将导致模拟器运行速度非常慢。 有关详细信息,请参阅如何使用 Android 模拟器 (Hyper-V & HAXM) 启用硬件加速

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

    App running in the Android emulator.

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

    Select the Windows Machine debugging target for .NET MAUI.

  2. Windows计算机按钮部署应用。

    Run .NET MAUI app in Visual Studio button.

    如果未启用开发人员模式,设置应用应打开到相应的页面。 打开 开发人员模式 并接受免责声明。

    Developer Mode toggle on the Windows 11 settings app.

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

    .NET MAUI app running on Windows.

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

  2. 在Visual Studio中,导航到工具>选项 > Xamarin > iOS 设置并禁用远程模拟器以Windows复选框:

    Disable the remote simulator in the iOS settings.

    有关用于Windows的远程iOS模拟器的详细信息,请参阅适用于Windows的远程iOS模拟器

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

    Visual Studio iOS simulators debug targets.

  4. 在Visual Studio工具栏中,按所选iOS模拟器的绿色"开始"菜单按钮:

    Visual Studio iOS simulator debug target choice.

    Visual Studio将生成应用,在配对的 Mac 上启动iOS模拟器,并将应用部署到模拟器。

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

    .NET MAUI app running in iOS Simulator on a Mac.