Bereitstellen und Debuggen Ihrer .NET MAUI-App unter Windows

Sie können Ihren lokalen Windows-Entwicklungscomputer zum Bereitstellen und Debuggen einer .NET Multiplatform App UI (.NET MAUI)-App verwenden. In diesem Artikel wird beschrieben, wie Sie Windows zum Debuggen einer .NET MAUI-App konfigurieren.

Beim Debuggen und Bereitstellen eines neuen .NET MAUI-Projekts für Windows besteht das Standardverhalten darin, eine entpackte App bereitzustellen. Informationen zu entpackten Apps finden Sie unter Windows-Apps: Verpackung, Bereitstellung und Prozess.

Auf Windows ausrichten

Legen Sie in Visual Studio das Debugziel auf Framework fest (...)>net9.0-windows. Der Eintrag enthält eine Versionsnummer, die mit dem folgenden Bildschirmfoto übereinstimmen kann, aber nicht muss:

Konvertieren einer entpackten .NET MAUI Windows-App in verpackt

Wenn Ihre App APIs verwenden muss, die nur mit Windows-verpackten Apps verfügbar sind und Sie ihre App über den Microsoft Store verteilen möchten, müssen Sie Ihre entpackte App in eine verpackte App konvertieren. Dies kann in Visual Studio erreicht werden:

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Eigenschaften aus. Navigieren Sie dann zur Registerkarte "Anwendungs-Windows-Ziele>", und stellen Sie sicher, dass das Erstellen eines Windows MSIX-Pakets aktiviert ist:

   

Visual Studio ändert die Projektdatei Ihrer App (CSPROJ), um die <WindowsPackageType>None</WindowsPackageType> Zeile zu entfernen. Darüber hinaus hat die Datei "Properties/launchSettings.json" ihrer App den commandName Wert von :MsixPackageProject

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

Wichtig

Wenn Ihre App mehrere Starteinstellungsprofile definiert, müssen Sie den commandName Wert Project MsixPackage für jedes Profil manuell aktualisieren.

Beim Bereitstellen einer verpackten .NET MAUI Windows-App müssen Sie den Entwicklermodus in Windows aktivieren. Weitere Informationen finden Sie unter Konfigurieren von Windows für die Bereitstellung verpackter Apps.

Konvertieren einer verpackten .NET MAUI Windows-App in entpackt

So konvertieren Sie eine vorhandene .NET MAUI Windows-Verpackte App in eine entpackte App in Visual Studio:

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Eigenschaften aus. Navigieren Sie dann zur Registerkarte "Anwendungs-Windows-Ziele>", und stellen Sie sicher, dass das Erstellen eines Windows MSIX-Pakets deaktiviert ist:

   

Visual Studio ändert die Projektdatei Ihrer App (*.csproj), um die $(WindowsPackageType) Buildeigenschaft auf :None

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

Darüber hinaus hat die Datei "Properties/launchSettings.json" ihrer App den commandName Wert von :ProjectMsixPackage

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

Wichtig

Wenn Ihre App mehrere Starteinstellungsprofile definiert, müssen Sie den commandName Wert MsixPackage Project für jedes Profil manuell aktualisieren.

Konfigurieren der Bereitstellung von Windows für verpackte Apps

Sie müssen den Entwicklermodus in Windows aktivieren, um eine verpackte .NET MAUI Windows-App bereitstellen zu können. Sowohl Windows 10 als auch Windows 11 werden unterstützt.

Windows 11

Der Entwicklermodus ist in der Einstellungs-App unter "Datenschutz und Sicherheit>für Entwickler" aktiviert. So aktivieren Sie den Entwicklermodus in Windows 11:

1. Öffnen Sie das Start-Menü.
2. Geben Sie Entwicklereinstellungen in das Suchfeld ein und wählen Sie es aus.
3. Aktivieren Sie den Entwicklermodus.
4. Wenn Sie eine Warnmeldung zum Entwicklermodus erhalten, lesen Sie diese und wählen Sie Ja aus, wenn Sie die Warnung verstanden haben.

Windows 10

Der Entwicklermodus ist in der Einstellungs-App unter "Update & Sicherheit>für Entwickler" aktiviert. So aktivieren Sie den Entwicklermodus in Windows 10:

1. Öffnen Sie das Start-Menü.
2. Suchen Sie nach Entwicklereinstellungen und wählen Sie diese aus.
3. Aktivieren Sie den Entwicklermodus.
4. Wenn Sie eine Warnmeldung zum Entwicklermodus erhalten, lesen Sie diese und wählen Sie Ja aus, wenn Sie die Warnung verstanden haben.