Trasferimento alla piattaforma UWP (Universal Windows Platform) (C++)

  • Articolo

In questo argomento è possibile trovare informazioni su come convertire il codice C++ esistente nella piattaforma app di Windows, il piattaforma UWP (Universal Windows Platform). Ciò che significa il termine universale è che il codice può essere eseguito in uno qualsiasi dei dispositivi che eseguono Windows 10 o versione successiva. Si crea un singolo progetto e un'unica interfaccia utente di base XAML che funziona bene in qualsiasi dispositivo che esegue Windows 10 o versione successiva. È possibile usare le funzionalità di layout dinamico in XAML per consentire l'interfaccia utente dell'applicazione di adattarsi alle dimensioni del display diverse.

La documentazione di Windows Developer Center contiene una guida al trasferimento di app di Windows 8.1 alla piattaforma UWP (Universal Windows Platform). Vedere Passare da Windows Runtime 8 a UWP. Nonostante la Guida illustri principalmente il codice C#, la maggior parte del materiale sussidiario è applicabile a C++. Le procedure seguenti contengono informazioni più dettagliate. Vedi anche Passare da un'applicazione desktop a UWP.

Questo argomento contiene le procedure seguenti per convertire il codice per la piattaforma UWP.

Se si ha a disposizione una DLL Win32 per desktop classico e la si vuole chiamare da un'applicazione UWP, è anche possibile eseguire queste operazioni. Usando queste procedure, è possibile creare un livello dell'interfaccia utente UWP per un'applicazione C++ per desktop Windows classico esistente oppure un codice C++ multipiattaforma standard. Vedere Procedura: usare codice C++ esistente in un'app della piattaforma UWP (Universal Windows Platform).

Porting di un'app di Windows Store 8.1 alla piattaforma UWP

Se hai un'app di Windows 8.1 Store, puoi usare questa procedura per usarla sulla piattaforma UWP e su qualsiasi dispositivo che esegue Windows 10 o versione successiva. È consigliabile prima compilare il progetto con Visual Studio 2019 come progetto di Windows 8.1, per eliminare prima di tutto eventuali problemi che derivano dalle modifiche apportate al compilatore e alle librerie. Dopo aver completato questa operazione, esistono due modi per convertirlo in un progetto UWP di Windows. Il modo più semplice (come spiegato nella procedura seguente) consiste nel creare un progetto Windows universale e copiarvi il codice esistente. Se si usa un progetto universale per desktop per Windows 8.1 e Windows 8.1 Phone, il progetto verrà avviato con due layout diversi in XAML, ma terminerà con un singolo layout dinamico che consente di regolare le dimensioni di visualizzazione.

Per eseguire il porting di un'app di Windows Store 8.1 alla piattaforma UWP

  1. Se necessario, aprire il progetto di app Windows 8.1 in Visual Studio 2017 e seguire le istruzioni per aggiornare il file di progetto.

    È necessario aver installato la configurazione degli strumenti di Windows 8.1 in Visual Studio. Se non sono stati installati questi strumenti, avviare la configurazione di Visual Studio nella finestra Programs and Features (Programmi e funzionalità), scegliere Visual Studio 2017 e nella finestra di dialogo di configurazione scegliere Modifica. Individuare Windows 8.1 Tools (Strumenti di Windows 8.1), assicurarsi che l'opzione sia selezionata e scegliere OK.

  2. Aprire la finestra Proprietà progetto e in C++>Generale impostare Set di strumenti piattaforma su v141, il set di strumenti per Visual Studio 2017.

  3. Compilare il progetto come progetto di Windows 8.1 e risolvere gli eventuali errori di compilazione. Eventuali errori in questa fase sono probabilmente a causa di modifiche importanti nelle librerie e strumenti di compilazione. Vedere Cronologia delle modifiche di Visual C++ dal 2003 al 2015 per la spiegazione dettagliata delle modifiche che potrebbero influire sul codice.

    Dopo aver compilato il progetto in modo pulito, è possibile eseguire la conversione per piattaforma UWP (Universal Windows Platform).

  4. Creare un nuovo progetto di App Windows universale usando il modello vuoto. È possibile assegnare lo stesso nome del progetto esistente, anche se a tale scopo, i progetti deve essere in directory diverse.

  5. Chiudere la soluzione e quindi usando Esplora risorse o la riga di comando, è possibile copiare i file di codice con estensioni CPP, H e XAML, dal progetto Windows 8.1 nella stessa cartella del file di progetto con estensione VCXPROJ per il progetto creato nel passaggio 1. Non copiare il file package appxmanifest e se si dispone di codice separato per desktop di Windows 8.1 e telefono, scegliere uno di essi alla porta prima (sarà necessario eseguire alcune operazioni in un secondo momento per adattarsi a altro). Assicurarsi di copia e le sottocartelle e il relativo contenuto. Se richiesto, scegliere di sostituire tutti i file con nomi duplicati.

  6. Riaprire la soluzione e scegliere Aggiungi>Elemento esistente nel menu di scelta rapida per il nodo del progetto. Selezionare tutti i file copiati, ad eccezione di quelle che fanno già parte del progetto.

    Controllare eventuali sottocartelle e assicurarsi di aggiungere anche i file in esse.

  7. Se non si usa lo stesso nome del progetto precedente, aprire il file Package.appxmanifest e aggiornare il Punto di ingresso affinché rifletta il nome dello spazio dei nomi per la classe App.

    Il campo Punto di ingresso nel file Package.appxmanifest contiene un nome con ambito per la classe App, che include lo spazio dei nomi contenente la classe App. Quando si crea un progetto Windows universale, lo spazio dei nomi viene impostato sul nome del progetto. Se questa è diversa da quella i file copiati dal progetto precedente, è necessario aggiornare uno o l'altro in modo adeguato.

  8. Compilare il progetto e risolvere gli eventuali errori di compilazione a causa di modifiche importanti tra le diverse versioni di Windows SDK.

  9. Eseguire il progetto sul Desktop locale. Verificare che non siano presenti errori di distribuzione e che il layout dell'applicazione è ragionevole e che funzioni correttamente sul desktop.

  10. Se si dispone di file di codice separati e XAML per un altro dispositivo, ad esempio Windows Phone 8.1, esaminare il codice e identificare dove è diversa dal dispositivo standard. Se la differenza è solo nel layout, è possibile usare Visual State Manager nel codice xaml per personalizzare la visualizzazione a seconda delle dimensioni dello schermo. Per altre differenze è possibile usare le sezioni di condizioni nel codice usando le istruzioni #if seguenti.

    #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PC_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PHONE_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)

    Queste istruzioni rispettivamente si applicano alle app UWP, Windows Phone Store, a entrambe o a nessuna delle due (solo la versione desktop classica Win32). Queste macro sono disponibili solo in Windows SDK 8.1 e versioni successive, pertanto se il codice deve essere compilato con le versioni precedenti di Windows SDK o per altre piattaforme diverse da Windows, è necessario prendere in considerazione il fatto che nessuna di queste venga definita.

  11. Esecuzione e il debug dell'app su un emulatore o un dispositivo fisico, per ogni tipo di dispositivo che supporta l'applicazione. Per eseguire un emulatore, è necessario eseguire Visual Studio in un computer fisico, non una macchina virtuale.

Porting di un componente Runtime di Windows 8.1 per il UWP

Se hai una DLL o un componente Windows Runtime che funziona già con le app di Windows 8.1 Store, puoi usare questa procedura per ottenere il componente o la DLL che funziona con la piattaforma UWP in Windows. La procedura di base consiste nel creare un nuovo progetto e copiarvi il codice.

Per trasferire un componente Windows 8.1 Runtime nella piattaforma UWP

  1. Nella finestra di dialogo Nuovo progetto in Visual Studio 2017, trovare il nodo Universale di Windows. Se questo nodo non viene visualizzato, installare prima Windows SDK . Scegliere il modello Componente Windows Runtime , assegnare un nome al componente e scegliere il pulsante OK . Il nome del componente verrà usato come nome dello spazio dei nomi, quindi si potrebbe voler usare lo stesso nome del precedente spazio dei nomi del progetto. Di conseguenza, si deve creare il progetto in una cartella diversa da quella precedente. Se si sceglie un nome diverso, è possibile aggiornare lo spazio dei nomi nei file di codice generato.

  2. Chiudere il progetto.

  3. Copiare tutti i file di codice (estensioni cpp, h, xaml e così via.) dal componente Windows 8.1 nel progetto appena creato. Non copiare il file Package.appxmanifest.

  4. Compilare il progetto e risolvere gli eventuali errori di compilazione a causa di modifiche importanti tra le diverse versioni di Windows SDK.

Risoluzione dei problemi

Possono verificarsi diversi errori durante il processo di porting di codice per la piattaforma UWP. Di seguito sono riportati alcuni possibili problemi riscontrati.

Configurazione progetto non valida.

È possibile ricevere l'errore:

could not find assembly 'platform.winmd': please specify the assembly search path using /AI or by setting the LIBPATH environment variable

In questo caso, il progetto non è la creazione di un progetto Windows universale. Controllare il file di progetto e assicurarsi che gli elementi XML corretti che identificano un progetto come Windows universale. Gli elementi seguenti devono essere presenti (il numero di versione della piattaforma di destinazione potrebbe essere diversa):

<AppContainerApplication>true</AppContainerApplication>
<ApplicationType>Windows Store</ApplicationType>
<WindowsTargetPlatformVersion>10.0.10156.0</WindowsTargetPlatformVersion>
<WindowsTargetPlatformMinVersion>10.0.10156.0</WindowsTargetPlatformMinVersion>
<ApplicationTypeRevision>10.0</ApplicationTypeRevision>

Se è stato creato un nuovo progetto UWP usando Visual Studio, questo errore non verrà visualizzato.

Vedi anche

Guida al porting di Visual C++
Sviluppare app per la piattaforma UWP (Universal Windows Platform)