Usare SDK per app di Windows in un progetto esistente

Se hai un progetto desktop macchine virtuali Windows, WinForms o Win32 in cui vuoi usare le funzionalità del SDK per app di Windows, puoi installare il pacchetto NuGet SDK per app di Windows nel progetto.

Prerequisiti

Prima di installare e usare il pacchetto NuGet SDK per app di Windows nell'app, assicurarsi che siano soddisfatti questi requisiti:

Istruzioni

  1. Aprire un progetto macchine virtuali Windows, WinForms o Win32 esistente in Visual Studio. Assicurarsi che sia configurato per Call Windows Runtime API.

  2. In Visual Studio aprire il NuGet Gestione pacchetti:

    1. Fare clic su Tools > NuGet Gestione pacchetti > Gestisci pacchetti NuGet per la soluzione... .
      –O–
    2. Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Gestisci pacchetti NuGet per la soluzione... .

  3. Nella finestra NuGet Gestione pacchetti selezionare la scheda Browse e cercare il pacchetto seguente:

    • Microsoft. WindowsAppSDK.

  4. Dopo aver trovato il pacchetto NuGet SDK per app di Windows appropriato, selezionare il pacchetto, selezionare la casella nel riquadro di destra del NuGet Gestione pacchetti finestra accanto al progetto in cui si vuole installare il pacchetto, quindi fare clic su Install.

    Screenshot del pacchetto NuGet SDK per app di Windows in fase di installazione

    Nota

    Il pacchetto NuGet Windows app SDK contiene altri pacchetti secondari (inclusi Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI e altri) che contengono le implementazioni per componenti specifici in SDK per app di Windows. In generale, è consigliabile installare il pacchetto NuGet principale SDK per app di Windows, che include tutti i componenti. In alcuni casi, è possibile installare un sottoconfezionato singolarmente per fare riferimento solo a determinati componenti nel progetto. Ad esempio, vedere Installare e distribuire Windows ML.

Passaggi aggiuntivi per le app non in pacchetto

Se l'app è senza pacchetto (come le app desktop per impostazione predefinita), sono necessari alcuni passaggi aggiuntivi per usare SDK per app di Windows.

Per altre info sui termini in pacchetto e non in pacchetto, vedi Panoramica dei pacchetti.

1. Installare il runtime di SDK per app di Windows

Il runtime di SDK per app di Windows deve essere installato in qualsiasi computer in cui verrà eseguita l'app.

Per il computer di sviluppo, consigliamo di visitare Ultimi download di SDK per app di Windows, quindi scaricare, decomprimere ed eseguire:

  • Versione stabile più recente sotto Download di runtime.
  • Versione e canale di rilascio del runtime corrispondente alla versione e al canale di rilascio del Microsoft. WindowsAppSDK pacchetto NuGet installato.

Scegliere l'opzione del programma di installazione appropriata per l'architettura del computer.

Importante

Quando l'app viene distribuita, sarai responsabile della distribuzione dei pacchetti di runtime necessari SDK per app di Windows agli utenti finali. Per ulteriori informazioni, consultare la guida alla distribuzione di SDK per app di Windows per app dipendenti dal framework confezionate con posizione esterna o non confezionate.

2. Inizializzare il runtime di SDK per app di Windows

Per impostazione predefinita, un'app desktop macchine virtuali Windows, WinForms o Win32 è non impacchettata. Un'app non inclusa nel pacchetto deve inizializzare il runtime di SDK per app di Windows prima di usare qualsiasi altra funzionalità di SDK per app di Windows.

È possibile farlo automaticamente all'avvio dell'app tramite Inizializzazione automatica.

  1. Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, quindi scegliere Modifica File di progetto.

  2. All'interno dell'elemento PropertyGroup aggiungere un WindowsPackageType elemento impostato su None.

<WindowsPackageType>None</WindowsPackageType>

Quando si compila il progetto, questi file vengono aggiunti al progetto in Visual Studio:

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Modificare manualmente il file .cxproj.

  2. All'interno dell'elemento <PropertyGroup Label="Globals"> aggiungere un WindowsPackageType elemento impostato su None.

<WindowsPackageType>None</WindowsPackageType>

Nota

Se sono necessarie esigenze avanzate (ad esempio la gestione degli errori personalizzata o per caricare una versione specifica del SDK per app di Windows), invece di a initializzazione automatica è possibile chiamare l'API del programma di avvio automatico in modo esplicito, per altre informazioni, vedere Usare il SDK per app di Windows runtime per le app in pacchetto con percorso esterno o senza pacchetti e Tutorial: usare l'API del programma di avvio automatico in un'app in un pacchetto con percorso esterno o senza pacchetti che usa il SDK per app di Windows.

Altre informazioni

Se si verifica un errore Classe non registrata quando si tenta di usare un componente SDK per app di Windows, potrebbe essere necessario aggiungere al progetto una dipendenza dinamica dal pacchetto di Framework per SDK per app di Windows. Per altre info, vedere Pacchetti del framework MSIX e dipendenze dinamiche.

Vedi anche

  • Last updated on