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, questo argomento fornirà 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 di seguito.
• La versione di Windows 10 deve supportare lo schema di .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 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 provi a trasferire localmente un'app usando un metodo non supportato nella versione di Windows 10, riceverai un errore di distribuzione.

Versione	Note sul trasferimento locale
Build 17134 (aggiornamento di aprile 2018, versione 1803)	È .appinstaller possibile accedere al 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 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 attendibile
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.

Lo strumento di gestione dei certificati computer è facilmente reperibile 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 dell'applicazione 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 è integrato 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 consiste nel 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. Anche questo avrà esito negativo nello stesso modo. L'unico modo per risolvere questo problema consiste nel assicurarsi che l'URL originale termini con .appinstaller.

Isolare i problemi dell'app del programma di installazione app

Se il programma di installazione app non può 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 sono spesso utili per il debug dei problemi di installazione tramite Windows Visualizzatore eventi:Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server