Risolvere i problemi di installazione con il file dell'App Installer

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 installare le app in Windows 10, il dispositivo utente deve soddisfare i requisiti seguenti.

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 caricamento laterale delle app. Per ulteriori informazioni, vedere Abilitare il dispositivo per lo sviluppo.

Problemi comuni

Esistono alcuni problemi comuni durante il caricamento laterale di un'applicazione per la prima volta sul computer dell'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 sideloading, nella tabella di seguito troverai le funzionalità 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 caricamento laterale
Build 17134 (aggiornamento di aprile 2018, versione 1803)	È .appinstaller possibile accedere al file tramite cartelle di rete 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)	Il Programma di installazione delle app è in grado di scaricare le dipendenze delle app (solo in modalità release) dallo Store.
Build 14393 (Aggiornamento anniversario, versione 1607)	È stata introdotta l'app App Installer per installare i file .appx e .appxbundle; il file con estensione .appinstaller non è supportato.
Build 10586 (aggiornamento di novembre, versione 1511)	Il sideload è disponibile solo tramite PowerShell usando il comando Add-AppxPackage.
Build 10240 (Windows 10, versione 1507)	Il sideload è 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.

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 è costruita nella configurazione modalità Debug, le dipendenze verranno ottenute dal percorso specificato nel file .appinstaller.

File non accessibili

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

• un .appinstaller file, disponibile nella Additional Links > App Installer File pagina generata da Visual Studio
• un .appx, .appxbundle, .misx o msixbundle file, trovato in Additional Links > Package Bundle sulla pagina generata da Visual Studio

Annotazioni

A seconda della configurazione, potrebbero essere presenti più file .appx, .appxbundle.misx o msixbundle coinvolti nella distribuzione. Assicurarsi che tutti siano accessibili.

File serviti con tipo MIME errato

Quando si esegue l'installazione da un endpoint HTTP, tutti i file devono essere gestiti con il tipo MIME corretto nell'intestazione Content-Type dal server Web.

File trasmessi senza l'intestazione Content-Length

Quando si esegue l'installazione da un endpoint HTTP, tutte le risposte devono includere un'intestazione corretta Content-Length . Sono incluse le richieste GET e anche quelle HEAD. Assicurati che tutti specifichino correttamente il loro Content-Length. La mancata esecuzione di questa operazione può causare errori come App installation failed with error message: Appinstaller operation failed with error code 0x80072F76. Detail: Unknown error (0x80072f76) o altri.

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 di App Installer

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 il Visualizzatore eventi di Windows: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server. In questa cartella vengono creati file di log aggiuntivi: %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir