Aggiornare l'architettura dell'app da Arm32 a Arm64

2025-06-10

Questa guida illustra i passaggi consigliati per la modifica di un'app esistente con supporto per l'architettura della piattaforma Arm a 32 bit rispetto all'architettura arm a 64 bit più aggiornata aggiungendo la configurazione necessaria usando Visual Studio. Questo aggiornamento consentirà all'app di essere eseguita nei dispositivi Windows Arm più recenti che usano processori ARM (ARM64/AArch64) a 64 bit.

Questo argomento è rilevante per le app UWP che non hanno una destinazione ARM64. I modelli di progetto UWP meno recenti generavano una destinazione ARM32 (o AArch32), ma non includevano il supporto per ARM64 (AArch64).

Per controllare la piattaforma soluzione corrente per l'app per verificare se ARM64 è presente, aprire il codice del progetto dell'app in Visual Studio e nel menu a discesa "Piattaforme soluzioni" sulla barra degli strumenti Standard selezionare Configuration Manager... (disponibile anche nel menu Compila) in cui sarà possibile visualizzare l'elenco delle piattaforme soluzione e verificare se ARM64 è presente.

Annotazioni

I dispositivi Windows in esecuzione su un processore Arm (ad esempio, processori Snapdragon di Qualcomm) non supporteranno più AArch32 (Arm32). Questa modifica influisce sulle app della piattaforma UWP (Universal Windows Platform) destinate attualmente ad AArch32 (Arm32). il supporto per le versioni arm a 32 bit delle applicazioni verrà rimosso in una versione futura di Windows 11.. Verranno rimossi anche i file binari di sistema per il supporto arm32 (presente nella cartella sysarm32 ). Dopo questa modifica, per il numero ridotto di applicazioni interessate, le funzionalità dell'app potrebbero essere diverse e si potrebbe notare una differenza nelle prestazioni. Pertanto, ti consigliamo di aggiornare le piattaforme di destinazione a AArch64 (Arm64), supportato in tutti i dispositivi Windows su Arm, il prima possibile per garantire che i tuoi clienti possano continuare a godere della migliore esperienza possibile. Seguire le indicazioni in questa pagina per aggiornare le applicazioni a AArch64 (Arm64).

Aggiungere una configurazione arm64 al progetto

Per aggiungere una piattaforma della soluzione ARM64 al codice del progetto di app esistente:

Aprire la soluzione (codice del progetto) in Visual Studio (è necessario Visual Studio 2017 versione 15.9 o successiva).
Nel menu a discesa "Piattaforme della soluzione" sulla barra degli strumenti Standard (o nel menu "Compilazione") seleziona Configuration Manager...
Apri il menu a discesa "Piattaforma attiva della soluzione" e seleziona <nuovo...>.
Nel menu a discesa "Digitare o selezionare la nuova piattaforma", selezionare ARM64 e assicurarsi che il valore "Copia impostazioni da" sia impostato su ARM con la casella di controllo "Crea nuove piattaforme di progetto" abilitata, quindi selezionare OK.

Creare la soluzione Arm64

Dopo aver aggiunto la piattaforma di soluzione Arm64 al progetto o alla soluzione esistente, se si desidera confermare che la versione Arm64 dell'applicazione si compila correttamente, chiudere la finestra "Piattaforma soluzione attiva" e modificare l'impostazione di compilazione da Debug a Release. Nel menu a discesa "Compila" selezionare Ricompila soluzione e attendere la ricompilazione del progetto. Dovresti visualizzare un output "Ricompilazione completata con successo". In caso contrario, vedere la sezione risoluzione dei problemi di seguito.

(facoltativo): verificare che il file binario dell'app sia ora compilato per l'architettura arm64 aprendo la directory del progetto di progetto in PowerShell (fare clic con il pulsante destro del mouse sul progetto dell'app in Esplora soluzioni di Visual Studio e selezionare Apri nel terminale). Modificare le directory in modo che sia selezionata la nuova directory bin\ARM64\Release del progetto. Immettere il comando: dumpbin .\<appname>.exe (sostituendo <appname> con il nome dell'app). Immettere quindi il comando : dumpbin /headers .\<appname>.exe. Scorri verso l'alto nei risultati di output del tuo terminale, trova la sezione FILE HEADER VALUES e verifica che la prima riga sia AA64 machine (ARM64).

Pubblicare l'app aggiornata in Microsoft Store

Dopo aver creato una versione arm64 dell'app seguendo i passaggi di configurazione precedenti, è possibile aggiornare il pacchetto dell'app esistente in Microsoft Store visitando il dashboard del Centro per i partner e aggiungendo i file binari ARM64 appena compilati all'invio. È un'opzione per rimuovere anche i file binari ARM32 precedenti.

(in modo facoltativo) rimuovendo i file binari Arm32 precedenti. Per altre informazioni sulle opzioni, vedere Pubblicare l'app in Microsoft Store.

Risoluzione dei problemi

Se si verificano problemi durante la conversione dell'app Arm32 in Arm64, ecco alcune soluzioni comuni.

Una dipendenza non compilata per ARM64 impedisce la corretta compilazione

Se non è possibile compilare a causa di una dipendenza, sia interna, da una terza parte o da una libreria open source, sarà necessario trovare un modo per aggiornare tale dipendenza per supportare l'architettura ARM64 o rimuoverla.

Per le dipendenze interne, è consigliabile ricompilare la dipendenza per supportare ARM64.
Per le dipendenze di terze parti, raccomandiamo di inviare una richiesta affinché il manutentore possa ricompilare con il supporto ARM64.
Per le dipendenze open source, è consigliabile prima controllare vcpkg per verificare se esiste una versione più recente della dipendenza che include il supporto ARM64 a cui è possibile eseguire l'aggiornamento. Se non esiste alcun aggiornamento, è consigliabile contribuire all'aggiunta del supporto ARM64 al pacchetto manualmente. Molti gestori open source sarebbero grati per il contributo.
L'ultima scelta sarebbe rimuovere e/o sostituire la dipendenza nel tuo progetto di app.

Serve assistenza? Sfruttare il servizio App Assure

Scopri di più sull'assistenza per la compatibilità di App Assure per aiutarti con la conversione della tua app o del tuo driver Windows in Arm64. Per registrarsi e connettersi con App Assure, visitare aka.ms/AppAssureRequest o inviare un messaggio di posta elettronica a [email protected] per inviare la richiesta di supporto per la compatibilità di Windows on Arm.