在 Windows 上部署和偵錯 .NET MAUI 應用程式

您可以使用本機 Windows 開發電腦來部署和偵錯 .NET 多平台應用程式 UI （.NET MAUI） 應用程式。 本文說明如何設定 Windows 以偵錯 .NET MAUI 應用程式。

偵錯並將新的 .NET MAUI 專案部署至 Windows 時，預設行為是部署未封裝的應用程式。 如需未封裝應用程式的相關信息，請參閱 Windows 應用程式：封裝、部署和程式。

目標 Windows

在 Visual Studio 中，將偵 錯目標 設定為 Framework （...）>net9.0-windows。 項目專案中有版本號碼，可能與下列螢幕快照不符：

將未封裝的 .NET MAUI Windows 應用程式轉換為已封裝

如果您的 app 需要使用僅適用於 Windows 已封裝應用程式的 API，而且您打算透過 Microsoft 市集散發您的應用程式，則必須將未封裝的應用程式轉換成已封裝的應用程式。 這可以在 Visual Studio 中達成：

1. 在 方案總管 中，以滑鼠右鍵按兩下 .NET MAUI 應用程式項目，然後選取 [屬性]。 然後，流覽至 [應用程式 > Windows 目標] 索引標籤，並確定已核取 [建立 Windows MSIX 套件]：

   

Visual Studio 會修改您應用程式的項目檔 （.csproj） 以移除該 <WindowsPackageType>None</WindowsPackageType> 行。 此外，您的應用程式的 Properties/launchSettings.json 檔案將 commandName 值從 Project 變更為 MsixPackage：

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

重要

如果應用程式定義多個啟動設定設定檔，您必須針對每個設定檔手動將 值從 Project 更新commandName為 MsixPackage 。

部署封裝的 .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>

此外，您的應用程式的 Properties/launchSettings.json 檔案將 commandName 值從 MsixPackage 變更為 Project：

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

重要

如果應用程式定義多個啟動設定設定檔，您必須針對每個設定檔手動將 值從 MsixPackage 更新commandName為 Project 。

設定 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. 如果您收到有關開發人員模式的警告訊息，請閱讀它，如果您瞭解警告，請選取 [ 是 ]。