Nasazení a ladění aplikace .NET MAUI ve Windows

Místní vývojový počítač s Windows můžete použít k nasazení a ladění aplikace .NET Pro víceplatformní aplikace (.NET MAUI). Tento článek popisuje, jak nakonfigurovat Windows pro ladění aplikace .NET MAUI.

Při ladění a nasazení nového projektu .NET MAUI do Windows je výchozím chováním nasazení rozbalené aplikace. Informace o rozbalených aplikacích najdete v tématu Aplikace pro Windows: balení, nasazení a proces.

Cílová okna

V sadě Visual Studio nastavte cíl ladění na architekturu (...)>net9.0-windows. Položka položky má číslo verze, které se může nebo nemusí shodovat s následujícím snímkem obrazovky:

Převedení rozbalené aplikace .NET MAUI pro Windows na zabalené

Pokud vaše aplikace potřebuje používat rozhraní API, která jsou dostupná jenom u zabalených aplikací pro Windows a plánujete aplikaci distribuovat prostřednictvím Microsoft Storu, budete muset převést rozbalenou aplikaci na zabalenou aplikaci. Toho lze dosáhnout v sadě Visual Studio:

1. V Průzkumník řešení klikněte pravým tlačítkem na projekt aplikace .NET MAUI a vyberte Vlastnosti. Pak přejděte na kartu Cíle systému Windows aplikací > a ujistěte se, že je zaškrtnuté políčko Vytvořit balíček MSIX systému Windows:

   

Visual Studio upraví soubor projektu vaší aplikace (.csproj) tak, aby řádek odebral <WindowsPackageType>None</WindowsPackageType> . Soubor Properties/launchSettings.json vaší aplikace bude mít navíc změněnou commandName hodnotu z Project MsixPackage:

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

Důležité

Pokud vaše aplikace definuje více profilů nastavení spuštění, budete muset hodnotu aktualizovat ručně commandName pro Project MsixPackage každý profil.

Při nasazování zabalené aplikace .NET MAUI pro Windows budete muset povolit vývojářský režim ve Windows. Další informace najdete v tématu Konfigurace Windows pro nasazení zabalené aplikace.

Převedení zabalené aplikace .NET MAUI pro Windows na rozbalené

Převod existující aplikace .NET MAUI pro Windows zabalené na rozbalenou aplikaci v sadě Visual Studio:

1. V Průzkumník řešení klikněte pravým tlačítkem na projekt aplikace .NET MAUI a vyberte Vlastnosti. Pak přejděte na kartu Cíle systému Windows aplikací > a ujistěte se, že je nezaškrtnutá možnost Vytvořit balíček MSIX systému Windows:

   

Visual Studio upraví soubor projektu vaší aplikace (*.csproj) tak, aby nastavil $(WindowsPackageType) vlastnost sestavení na None:

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

Soubor Properties/launchSettings.json vaší aplikace bude mít navíc změněnou commandName hodnotu z MsixPackage Project:

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

Důležité

Pokud vaše aplikace definuje více profilů nastavení spuštění, budete muset hodnotu aktualizovat ručně commandName pro MsixPackage Project každý profil.

Konfigurace Windows pro nasazení zabalených aplikací

Abyste mohli nasadit zabalenou aplikaci .NET MAUI pro Windows, musíte ve Windows povolit vývojářský režim. Podporují se Windows 10 i Windows 11.

Windows 11

Režim vývojáře je povolený v aplikaci Nastavení v části Ochrana osobních údajů a zabezpečení>pro vývojáře. Povolení vývojářského režimu ve Windows 11:

1. Otevřete nabídku Start.
2. Do vyhledávacího pole zadejte nastavení pro vývojáře a vyberte ho.
3. Zapněte vývojářský režim.
4. Pokud se zobrazí zpráva s upozorněním o vývojářském režimu, přečtěte si ji a vyberte Ano , pokud upozornění rozumíte.

Windows 10

Režim vývojáře je povolený v aplikaci Nastavení v části Aktualizace a zabezpečení>pro vývojáře. Povolení vývojářského režimu ve Windows 10:

1. Otevřete nabídku Start.
2. Vyhledejte nastavení pro vývojáře a vyberte ho.
3. Zapněte vývojářský režim.
4. Pokud se zobrazí zpráva s upozorněním o vývojářském režimu, přečtěte si ji a vyberte Ano , pokud upozornění rozumíte.