生成 .NET MAUIBlazor Hybrid 应用

注意

此版本不是本文的最新版本。 有关当前版本,请参阅本文.NET 9 版本。

警告

此版本的 ASP.NET Core 不再受支持。 有关详细信息,请参阅 .NET 和 .NET Core 支持策略。 有关当前版本,请参阅本文.NET 9 版本。

重要

此信息与预发布产品相关,相应产品在商业发布之前可能会进行重大修改。 Microsoft 对此处提供的信息不提供任何明示或暗示的保证。

有关当前版本,请参阅本文.NET 9 版本。

本教程演示如何生成和运行 WPF .NET MAUIBlazor Hybrid 应用。 你将学习如何执行以下操作:

  • 在 Visual Studio 中创建 .NET MAUIBlazor Hybrid 应用项目
  • 在 Windows 上运行应用
  • 在 Android 模拟器中的模拟移动设备上运行应用

先决条件

有关本教程的先决条件和安装软件的详细信息,请参阅 .NET MAUI 文档中的以下资源:

创建 .NET MAUIBlazor Hybrid 应用

启动 Visual Studio。 在“开始”窗口中,选择“创建新项目”:

新建解决方案。

在“创建新项目”窗口中,使用“项目类型”下拉列表筛选“MAUI”模板:

将模板筛选到 .NET MAUI。

选择“.NET MAUIBlazor Hybrid 应用”模板,然后选择“下一步”按钮:

选择模板。

注意

在 .NET 7 或更低版本中,模板名称为 .NET MAUIBlazor 应用

在“配置新项目”对话框中:

  • 将“项目名称”设置为 MauiBlazor
  • 为项目选择一个合适的位置。
  • 选择“下一步”按钮。

配置项目。

在“其他信息”对话框中,使用“框架”下拉列表选择框架版本。 选择“创建”按钮:

用于选择框架版本和创建项目的“其他信息”对话框。

等待 Visual Studio 创建项目,并等待恢复项目的依赖项。 在“解决方案资源管理器”中,通过打开“依赖项”条目监视进度。

依赖项正在还原:

还原依赖项。

依赖项已还原:

已恢复依赖项。

在 Windows 上运行应用

在 Visual Studio 工具栏中,选择“Windows 计算机”按钮以生成并启动项目:

“Windows 计算机”按钮。

如果未启用“开发人员”模式,系统会提示在“设置”>“面向开发人员”>“开发人员模式” (Windows 10) 或“设置”>“Privacy和安全”>“面向开发人员”>“开发人员模式”(Windows 11) 中启用它。 将开关设置为“开”。

作为 Windows 桌面应用运行的应用:

在 Windows 上运行的应用。

在 Android Emulator 中运行应用

如果按照在 Windows 上运行应用部分中的指导,选择工具栏中的“停止调试”按钮以停止正在运行的 Windows 应用:

“停止调试”按钮。

在 Visual Studio 工具栏中,选择“开始配置”下拉按钮。 选择“Android Emulator”>“Android Emulator”:

“Android Emulator”按钮的“Android Emulator”下拉选项。

Android SDK 是生成用于 Android 的应用所必需的。 在“错误列表”面板中,将显示一条消息,要求你双击该消息以安装所需的 Android SDK:

包含消息的 Visual Studio 错误列表,要求你单击该消息以安装 Android SDK。

将显示“Android SDK 许可证接受”窗口,为显示的每个许可证选择“接受”按钮。 对于“Android Emulator”和“SDK 修补程序应用方”许可证,会出现一个附加窗口。 选择“接受”按钮。

等待 Visual Studio 下载 Android SDK 和 Android Emulator。 可以通过选择 Visual Studio UI 左下角的后台任务指示器来跟踪进度:

Visual Studio 后台任务指示器。

当后台任务完成时,该指示器会显示一个复选标记:

已选中“Visual Studio 后台任务指示器”。

在工具栏上,选择“Android Emulator”按钮:

“Android Emulator”按钮。

在“创建默认 Android 设备”窗口中,选择“创建”按钮:

创建默认的 Android 设备窗口。

等待 Visual Studio 下载、解压缩并创建 Android Emulator。 Android 电话模拟器准备就绪后,选择“开始”按钮。

注意

启用硬件加速以提高 Android Emulator 的性能。

关闭“Android 设备管理器”窗口。 等到模拟电话窗口出现,Android OS 加载,home 屏幕出现。

重要

必须在加载 Android OS 的情况下为模拟电话通电,才能在调试器中加载和运行应用。 如果模拟电话未运行,请通过以下方法为电话开机:使用 Ctrl+P 键盘快捷方式或选择 UI 中的“电源”按钮:

Android Emulator 的“电源”按钮。

在 Visual Studio 工具栏中,选择 Pixel 5 - {VERSION} 按钮以生成并运行项目,其中 {VERSION} 占位符是 Android 版本。 在下面的示例中,Android 版本为 API 30 (Android 11.0 - API 30),根据安装的 Android SDK,会出现更高的版本:

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

Visual Studio 生成项目并将应用部署到模拟器。

启动仿真器、加载模拟电话和 OS 以及部署和运行应用可能需要几分钟时间,具体取决于系统的速度以及是否启用了硬件加速。 可以通过检查 UI 底部的 Visual Studio 状态栏来监视部署进度。 当应用运行时,“就绪”指示器收到一个复选标记,仿真器的部署和应用加载指示器将消失:

部署期间:

Visual Studio 页脚栏中显示的第一个部署-运行指示器。

应用启动期间:

Visual Studio 页脚栏中显示的第二个部署-运行指示器。

在 Android Emulator 中运行的应用:

在 Android Emulator 中运行的应用。

后续步骤

在本教程中,你了解了如何执行以下操作:

  • 在 Visual Studio 中创建 .NET MAUIBlazor Hybrid 应用项目
  • 在 Windows 上运行应用
  • 在 Android 模拟器中的模拟移动设备上运行应用

详细了解 Blazor Hybrid 应用: