Condividi tramite

Distribuire ed eseguire il debug dell'app MAUI .NET in Windows

  • Articolo

È possibile usare il computer di sviluppo Windows locale per distribuire ed eseguire il debug di un'app .NET Multipiattaforma app (.NET MAUI). Questo articolo descrive come configurare Windows per eseguire il debug di un'app MAUI .NET.

Quando si esegue il debug e si distribuisce un nuovo progetto MAUI .NET in Windows, il comportamento predefinito consiste nel distribuire un'app in pacchetto. Per informazioni sulle app in pacchetto, vedi App di Windows: creazione di pacchetti, distribuzione ed elaborazione.

Configurare Windows per la distribuzione di app in pacchetto

Sarà necessario abilitare la modalità sviluppatore in Windows per poter distribuire un'app windows .NET in pacchetto. Sono supportati sia Windows 10 che Windows 11.

Impostazioni della modalità sviluppatore in Windows 11 per l'app Windows .NET MAUI.

Windows 11

La modalità sviluppatore è abilitata nell'app Impostazioni , in Privacy e sicurezza>Per gli sviluppatori. Per abilitare la modalità sviluppatore in Windows 11:

  1. Aprire il menu Start.
  2. Digitare Impostazioni sviluppatore nella casella di ricerca e selezionarlo.
  3. Attivare la modalità sviluppatore.
  4. Se viene visualizzato un messaggio di avviso relativo alla modalità sviluppatore, leggerlo e selezionare Sì se si conosce l'avviso.

Windows 10

La modalità sviluppatore è abilitata nell'app Impostazioni, in Aggiornamento e sicurezza>per gli sviluppatori. Per abilitare la modalità sviluppatore in Windows 10:

  1. Aprire il menu Start.
  2. Cercare Impostazioni sviluppatore, selezionarlo.
  3. Attivare la modalità sviluppatore.
  4. Se viene visualizzato un messaggio di avviso relativo alla modalità sviluppatore, leggerlo e selezionare Sì se si conosce l'avviso.

Windows di destinazione

In Visual Studio impostare Destinazione di debug su Framework (...)> net8.0-windows. Nella voce dell'elemento è presente un numero di versione, che può corrispondere o meno allo screenshot seguente:

Destinazione di debug di Visual Studio impostata su Windows per l'app MAUI 8 .NET.

In Visual Studio impostare Destinazione di debug su Framework (...)> net9.0-windows. Nella voce dell'elemento è presente un numero di versione, che può corrispondere o meno allo screenshot seguente:

Destinazione di debug di Visual Studio impostata su Windows per l'app MAUI 9 .NET.

Convertire un'app windows .NET MAUI in pacchetto in un pacchetto

Per convertire un'app windows .NET MAUI esistente in un'app non in pacchetto in Visual Studio:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto di app .NET MAUI e scegliere Proprietà. Passare quindi alla scheda Application Windows Targets (Destinazioni Windows applicazione>) e assicurarsi che Create a Windows MSIX package (Crea un pacchetto MSIX windows) sia deselezionato:

    Screenshot di Crea un pacchetto MSIX di Windows deselezionato in Visual Studio.

Visual Studio modificherà il file di progetto dell'app (*.csproj) per impostare la proprietà di $(WindowsPackageType) compilazione su None:

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

Inoltre, il file proprietà/launchSettings.json dell'app avrà il commandName valore modificato da MsixPackage a Project:

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

Importante

Se l'app definisce più profili di impostazione di avvio, dovrai aggiornare manualmente il commandName valore da MsixPackage a Project per ogni profilo.

Convertire un'app windows .NET maUI non in pacchetto

Se la tua app deve usare le API disponibili solo con le app in pacchetto di Windows e prevedi di distribuire la tua app tramite Microsoft Store, dovrai convertire l'app non in pacchetto in un'app in pacchetto. Questa operazione può essere eseguita in Visual Studio:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto di app .NET MAUI e scegliere Proprietà. Passare quindi alla scheda Application Windows Targets (Destinazioni Windows applicazione>) e assicurarsi che l'opzione Create a Windows MSIX package (Crea un pacchetto MSIX windows) sia selezionata:

    Screenshot di Creare un pacchetto MSIX di Windows archiviato in Visual Studio.

Visual Studio modificherà il file di progetto dell'app (con estensione csproj) per rimuovere la <WindowsPackageType>None</WindowsPackageType> riga. Inoltre, il file proprietà/launchSettings.json dell'app avrà il commandName valore modificato da Project a MsixPackage:

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

Importante

Se l'app definisce più profili di impostazione di avvio, dovrai aggiornare manualmente il commandName valore da Project a MsixPackage per ogni profilo.

Quando si distribuisce un'app windows .NET MAUI in pacchetto, è necessario abilitare la modalità sviluppatore in Windows. Per altre informazioni, vedere Configurare Windows per la distribuzione di app in pacchetto.

Quando si esegue il debug e si distribuisce un nuovo progetto MAUI .NET in Windows, il comportamento predefinito consiste nel distribuire un'app non in pacchetto. Per informazioni sulle app non in pacchetto, vedi App di Windows: creazione di pacchetti, distribuzione e processo.

Windows di destinazione

In Visual Studio impostare Destinazione di debug su Framework (...)> net8.0-windows. Nella voce dell'elemento è presente un numero di versione, che può corrispondere o meno allo screenshot seguente:

Destinazione di debug di Visual Studio impostata su Windows per l'app MAUI 8 .NET.

In Visual Studio impostare Destinazione di debug su Framework (...)> net9.0-windows. Nella voce dell'elemento è presente un numero di versione, che può corrispondere o meno allo screenshot seguente:

Destinazione di debug di Visual Studio impostata su Windows per l'app MAUI 9 .NET.

Convertire un'app windows .NET maUI non in pacchetto

Se la tua app deve usare le API disponibili solo con le app in pacchetto di Windows e prevedi di distribuire la tua app tramite Microsoft Store, dovrai convertire l'app non in pacchetto in un'app in pacchetto. Questa operazione può essere eseguita in Visual Studio:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto di app .NET MAUI e scegliere Proprietà. Passare quindi alla scheda Application Windows Targets (Destinazioni Windows applicazione>) e assicurarsi che l'opzione Create a Windows MSIX package (Crea un pacchetto MSIX windows) sia selezionata:

    Screenshot di Creare un pacchetto MSIX di Windows archiviato in Visual Studio.

Visual Studio modificherà il file di progetto dell'app (con estensione csproj) per rimuovere la <WindowsPackageType>None</WindowsPackageType> riga. Inoltre, il file proprietà/launchSettings.json dell'app avrà il commandName valore modificato da Project a MsixPackage:

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

Importante

Se l'app definisce più profili di impostazione di avvio, dovrai aggiornare manualmente il commandName valore da Project a MsixPackage per ogni profilo.

Quando si distribuisce un'app windows .NET MAUI in pacchetto, è necessario abilitare la modalità sviluppatore in Windows. Per altre informazioni, vedere Configurare Windows per la distribuzione di app in pacchetto.

Convertire un'app windows .NET MAUI in pacchetto in un pacchetto

Per convertire un'app windows .NET MAUI esistente in un'app non in pacchetto in Visual Studio:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto di app .NET MAUI e scegliere Proprietà. Passare quindi alla scheda Application Windows Targets (Destinazioni Windows applicazione>) e assicurarsi che Create a Windows MSIX package (Crea un pacchetto MSIX windows) sia deselezionato:

    Screenshot di Crea un pacchetto MSIX di Windows deselezionato in Visual Studio.

Visual Studio modificherà il file di progetto dell'app (*.csproj) per impostare la proprietà di $(WindowsPackageType) compilazione su None:

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

Inoltre, il file proprietà/launchSettings.json dell'app avrà il commandName valore modificato da MsixPackage a Project:

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

Importante

Se l'app definisce più profili di impostazione di avvio, dovrai aggiornare manualmente il commandName valore da MsixPackage a Project per ogni profilo.

Configurare Windows per la distribuzione di app in pacchetto

Sarà necessario abilitare la modalità sviluppatore in Windows per poter distribuire un'app windows .NET in pacchetto. Sono supportati sia Windows 10 che Windows 11.

Impostazioni della modalità sviluppatore in Windows 11 per l'app Windows .NET MAUI.

Windows 11

La modalità sviluppatore è abilitata nell'app Impostazioni , in Privacy e sicurezza>Per gli sviluppatori. Per abilitare la modalità sviluppatore in Windows 11:

  1. Aprire il menu Start.
  2. Digitare Impostazioni sviluppatore nella casella di ricerca e selezionarlo.
  3. Attivare la modalità sviluppatore.
  4. Se viene visualizzato un messaggio di avviso relativo alla modalità sviluppatore, leggerlo e selezionare Sì se si conosce l'avviso.

Windows 10

La modalità sviluppatore è abilitata nell'app Impostazioni, in Aggiornamento e sicurezza>per gli sviluppatori. Per abilitare la modalità sviluppatore in Windows 10:

  1. Aprire il menu Start.
  2. Cercare Impostazioni sviluppatore, selezionarlo.
  3. Attivare la modalità sviluppatore.
  4. Se viene visualizzato un messaggio di avviso relativo alla modalità sviluppatore, leggerlo e selezionare Sì se si conosce l'avviso.