在 Windows 上部署和调试 .NET MAUI 应用

可以使用本地 Windows 开发计算机来部署和调试 .NET Multi-platform App UI (.NET MAUI) 应用。 本文介绍如何配置 Windows 以调试 .NET MAUI 应用。

调试并将新的 .NET MAUI 项目部署到 Windows 时，默认行为是部署未打包的应用。 有关未打包的应用的信息，请参阅 Windows 应用：打包、部署和进程。

目标 Windows

在 Visual Studio 中，将 调试目标 设置为 框架 （...）>net9.0-windows。 项条目中有一个版本号，该版本号可能与以下屏幕截图匹配，也可能不匹配：

将未打包的 .NET MAUI Windows 应用转换为打包

如果你的应用需要使用仅适用于 Windows 打包应用的 API，并且你计划通过 Microsoft 应用商店分发应用，则需要将未打包的应用转换为打包的应用。 这可以在 Visual Studio 中实现：

1. 在“解决方案资源管理器”中，右键单击 .NET MAUI 应用项目，然后选择“属性”。 然后，导航到 “应用程序 > Windows 目标 ”选项卡，并确保 选中“创建 Windows MSIX 包 ”：

   

Visual Studio 将修改应用的项目文件 （.csproj），以删除该 <WindowsPackageType>None</WindowsPackageType> 行。 此外，应用的属性/launchSettings.json文件将commandName值从ProjectMsixPackage以下值更改为：

{
  "profiles": {
    "Windows Machine": {
      "commandName": "MsixPackage",
      "nativeDebugging": false
    }
  }
}

重要

如果应用定义了多个启动设置配置文件，则必须为每个配置文件手动更新commandName值ProjectMsixPackage。

部署打包的 .NET MAUI Windows 应用时，需要在 Windows 中启用开发人员模式。 有关详细信息，请参阅 配置 Windows 进行打包的应用部署。

将打包的 .NET MAUI Windows 应用转换为未打包

若要将现有的 .NET MAUI Windows 打包应用转换为 Visual Studio 中的未打包应用，请执行以下操作：

1. 在“解决方案资源管理器”中，右键单击 .NET MAUI 应用项目，然后选择“属性”。 然后，导航到“应用程序 > Windows 目标”选项卡，并确保未选中“创建 Windows MSIX 包”：

   

Visual Studio 将修改应用的项目文件（*.csproj），将 $(WindowsPackageType) 生成属性设置为 None：

<PropertyGroup>
    <WindowsPackageType>None</WindowsPackageType>
</PropertyGroup>

此外，应用的属性/launchSettings.json文件将commandName值从MsixPackageProject以下值更改为：

{
  "profiles": {
    "Windows Machine": {
      "commandName": "Project",
      "nativeDebugging": false
    }
  }
}

重要

如果应用定义了多个启动设置配置文件，则必须为每个配置文件手动更新commandName值MsixPackageProject。

为打包的应用部署配置 Windows

你需要在 Windows 中启用开发人员模式才能部署打包的 .NET MAUI Windows 应用。 支持 Windows 10 和 Windows 11。

Windows 11

开发人员模式在“设置”应用中启用，在“隐私和安全>”下为开发人员启用。 若要在 Windows 11 中启用开发人员模式，请执行以下操作：

1. 打开“开始”菜单。
2. 在搜索框中键入“开发人员设置”，选择它。
3. 打开“开发人员模式”。
4. 如果收到有关开发人员模式的警告消息，请阅读该消息，并在理解警告内容后选择“是”。

Windows 10

开发人员模式在“设置”应用中启用，在“更新和安全>”下为开发人员启用。 若要在 Windows 10 中启用开发人员模式，请执行以下操作：

1. 打开“开始”菜单。
2. 搜索“开发人员设置”，选择它。
3. 打开“开发人员模式”。
4. 如果收到有关开发人员模式的警告消息，请阅读该消息，并在理解警告内容后选择“是”。