Risolvere i problemi di installazione con il file del programma di installazione app

Se si verificano problemi durante l'installazione di un'applicazione dal file del programma di installazione app, in questo argomento verranno fornite alcune indicazioni per la risoluzione dei problemi utili.

Prerequisiti

Per poter trasferire localmente le app in Windows 10, il dispositivo utente deve soddisfare i requisiti successivi:

Windows 10:

• Il certificato usato per firmare il pacchetto deve essere considerato attendibile dal dispositivo. Per altri dettagli, vedere la sezione Certificati attendibili più avanti.
• La versione di Windows 10 deve supportare lo schema del .appinstaller file e il protocollo di distribuzione.

Windows 10 1909 e versioni precedenti:

• Il dispositivo deve essere abilitato per la modalità sviluppatore o il trasferimento locale delle app. Per altre informazioni, vedere Abilitare il dispositivo per lo sviluppo .

Problemi comuni

Esistono alcuni problemi comuni durante il trasferimento locale di un'applicazione per la prima volta nel computer utente. Le sezioni successive descrivono i problemi più frequenti e le relative soluzioni.

Versione di Windows

Ogni versione di Windows 10 migliora l'esperienza di trasferimento locale, nella tabella seguente troverai quali funzionalità sono disponibili in ogni versione principale. Se si tenta di trasferire localmente un'app usando un metodo non supportato nella versione di Windows 10, verrà visualizzato un errore di distribuzione.

Versione	Note sul trasferimento locale
Build 17134 (aggiornamento di aprile 2018, versione 1803)	È possibile accedere al .appinstaller file tramite cartelle UNC/Share. Sono disponibili anche controlli di aggiornamento configurabili.
Build 16299 (Fall Creators Update, versione 1709)	È stato introdotto il .appinstaller file per fornire aggiornamenti automatici all'app. Questa versione supporta solo gli endpoint HTTP. I controlli di aggiornamento non sono configurabili e vengono eseguiti ogni 24 ore.
Build 15063 (Creators Update, versione 1703)	L'app Del programma di installazione app è in grado di scaricare le dipendenze dell'app (solo in modalità di rilascio) dallo Store.
Build 14393 (aggiornamento dell'anniversario, versione 1607)	È stata introdotta l'app Del programma di installazione app per installare i file con estensione appx e appxbundle, il file con estensione appinstaller non è supportato.
Build 10586 (aggiornamento di novembre, versione 1511)	Il trasferimento locale è disponibile solo tramite PowerShell usando il comando Add-AppxPackage .
Build 10240 (Windows 10, versione 1507)	Il trasferimento locale è disponibile solo tramite PowerShell usando il comando Add-AppxPackage .

Certificati attendibili

I pacchetti dell'app devono essere firmati con un certificato considerato attendibile dal dispositivo. I certificati forniti dalle autorità di certificazione comuni sono considerati attendibili per impostazione predefinita nel sistema operativo Windows.

Tuttavia, se il certificato usato per firmare un pacchetto dell'app non è attendibile o è un certificato generato/autofirmato generato localmente durante lo sviluppo, il programma di installazione dell'app potrebbe segnalare che il pacchetto non è attendibile e impedirà l'installazione:

Per risolvere questo problema, un utente con diritti di amministratore locale per il dispositivo deve usare lo strumento Certificati computer per importare il certificato in uno dei contenitori seguenti:

1. Computer locale: Persone attendibili
2. Computer locale: autorità radice attendibili (scelta non consigliata)

Importante

Non importare i certificati di firma del pacchetto nell'archivio certificati utente. Il programma di installazione app non esegue la ricerca nei certificati utente durante la verifica dell'identità del pacchetto.

È possibile trovare facilmente lo strumento di gestione dei certificati computer eseguendo una ricerca dal menu Start:

Dopo aver importato correttamente il certificato di firma, l'esecuzione di nuovo del programma di installazione dell'app mostrerà che il pacchetto è attendibile e può essere installato:

Dipendenze non installate

Le applicazioni Windows 10 possono avere dipendenze del framework in base alla piattaforma applicativa usata per generare l'app. Se si usa C# o VB, l'app richiederà i pacchetti .NET Runtime e .NET Framework. Le applicazioni C++ richiedono VCLibs.

Importante

Se il pacchetto dell'app è incorporato nella configurazione della modalità di rilascio, le dipendenze del framework verranno ottenute da Microsoft Store. Tuttavia, se l'app è incorporata nella configurazione in modalità debug, le dipendenze verranno ottenute dal percorso specificato nel .appinstaller file.

File non accessibili

Quando si esegue l'installazione da un endpoint HTTP, è importante verificare che tutti i file siano accessibili con il tipo MIME corretto. Il metodo più semplice per verificare questi file è seguire i collegamenti forniti nella pagina HTML generata da Visual Studio. È necessario controllare questi file:

• .appinstaller file, disponibile come application/xml
• .appx e .appxbundle file, disponibili come application/vns.ms-appx

Installazione dell'app non riuscita con messaggio di errore: il parametro non è corretto

Poiché gli URL di vanità non sono attualmente supportati, quando si usa il ms-appinstaller protocollo , il parametro di origine DEVE terminare in .appinstaller. Non importa se si esegue il reindirizzamento a un file che termina con .appinstaller. Ciò avrà anche esito negativo nello stesso modo. L'unico modo per risolvere questo problema consiste nel verificare che l'URL originale termini con .appinstaller.

Isolare i problemi dell'app del programma di installazione app

Se il programma di installazione app non riesce a installare l'app, questi passaggi consentiranno di identificare il problema di installazione.

Verificare l'installazione del file del pacchetto dell'app

• Scaricare il file del pacchetto dell'app in una cartella locale e provare a installarlo usando il comando PowerShell Add-AppxPackage .

• Scaricare il .appinstaller file in una cartella locale e provare a installarlo usando il Add-AppxPackage -Appinstaller comando di PowerShell.

Registri eventi del programma di installazione app

L'infrastruttura di distribuzione delle app genera log che spesso sono utili per il debug dei problemi di installazione tramite il Visualizzatore eventi di Windows: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server