Risolvere i problemi di installazione con il file del programma di installazione appTroubleshoot installation issues with the App Installer file

Se si riscontrano problemi durante l'installazione di un'applicazione dal file del programma di installazione dell'app, in questo argomento vengono fornite indicazioni sulla risoluzione dei problemi che possono essere utili.If you find any issues when installing an application from the App Installer file, this topic will provide some troubleshooting guidance that may help.

PrerequisitiPrerequisites

Per poter sideload le app in Windows 10, il dispositivo utente deve soddisfare i requisiti seguenti:To be able to sideload apps in Windows 10, the user device must satisfy the next requirements:

  • Il dispositivo deve essere abilitato per la modalità sviluppatore o per le app sideload.The device must be enabled for Developer Mode or Sideloading apps. Per altre informazioni, vedere abilitare il dispositivo per lo sviluppo .See Enable your device for development to learn more.
  • Il certificato usato per firmare il pacchetto deve essere considerato attendibile dal dispositivo.The certificate used to sign the package must be trusted by the device. Per ulteriori informazioni, vedere la sezione relativa ai certificati attendibili .See the Trusted certificates section below for more details.
  • La versione di Windows 10 deve supportare lo .appinstaller schema del file e il protocollo di distribuzione.The Windows 10 version must support the .appinstaller file schema and the distribution protocol.

Problemi comuniCommon issues

Si verificano alcuni problemi comuni quando si sideload un'applicazione per la prima volta nel computer dell'utente.There are some common issues when sideloading an application for first time in the user machine. Nelle prossime sezioni vengono descritti i problemi più frequenti e le relative soluzioni.The next few sections describe the most frequent issues and their solutions.

Versione di WindowsWindows version

Ogni versione di Windows 10 migliora l'esperienza sideload, nella tabella seguente sono riportate le funzionalità disponibili in ogni versione principale.Each Windows 10 release improves on the sideloading experience, in the table below you will find which features are available in each major release. Se si prova a sideload un'app usando un metodo non supportato nella versione di Windows 10, si otterrà un errore di distribuzione.If you try to sideload an app using a method not supported in your version of Windows 10, you will get a deployment error.

VersioneVersion Note su sideloadSideload Notes
Build 17134 (aggiornamento di aprile 2018, versione 1803)Build 17134 (April 2018 Update, version 1803) .appinstallerÈ possibile accedere al file tramite le cartelle UNC/share.The .appinstaller file can be accessed over UNC/Share folders. Sono disponibili anche controlli di aggiornamento configurabili.Configurable update checks are also available.
Build 16299 (Fall Creators Update, versione 1709)Build 16299 (Fall Creators Update, version 1709) Ha introdotto il .appinstaller file per fornire aggiornamenti automatici all'app.Introduced the .appinstaller file to provide automatic updates to your app. Questa versione supporta solo endpoint HTTP.This version only supports HTTP endpoints. I controlli degli aggiornamenti non sono configurabili e si verificano ogni 24 ore.Update checks are not configurable and happens each 24 hours.
Build 15063 (Creators Update, versione 1703)Build 15063 (Creators Update, version 1703) L'app del programma di installazione dell'app è in grado di scaricare le dipendenze dell'app (solo in modalità versione) dallo Store.The App Installer app is able to download app dependencies (only in release mode) from the Store.
Build 14393 (aggiornamento dell'anniversario, versione 1607)Build 14393 (Anniversary Update, version 1607) È stata introdotta l'app di installazione app per installare i file con estensione appx e appxbundle. il file con estensione AppInstaller non è supportato.Introduced the App Installer app to install .appx and .appxbundle files, .appinstaller file is not supported.
Build 10586 (aggiornamento di novembre, versione 1511)Build 10586 (November Update, version 1511) Sideload è disponibile solo tramite PowerShell usando il comando Add-APPXPACKAGE .Sideload is only available through PowerShell using the Add-AppxPackage command.
Build 10240 (Windows 10, versione 1507)Build 10240 (Windows 10, version 1507) Sideload è disponibile solo tramite PowerShell usando il comando Add-APPXPACKAGE .Sideload is only available through PowerShell using the Add-AppxPackage command.

Certificati attendibiliTrusted certificates

I pacchetti dell'app devono essere firmati con un certificato ritenuto attendibile dal dispositivo.App packages must be signed with a certificate that is trusted by the device. I certificati forniti dalle autorità di certificazione comuni sono considerati attendibili per impostazione predefinita nel sistema operativo Windows.Certificates provided by common Certificate Authorities are trusted by default in the Windows operating system.

Tuttavia, se il certificato usato per firmare un pacchetto dell'app non è attendibile o è un certificato generato localmente/autofirmato usato durante lo sviluppo, il programma di installazione dell'app potrebbe segnalare che il pacchetto non è attendibile e ne impedirà l'installazione:However, if the certificate used to sign an app package is not trusted, or is a locally-generated/self-signed certificate used during development, the app installer may report that the package is untrusted and will prevent it from being installed:

MSIX firmato con certificato mancante o non attendibile

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 seguenti contenitori:To solve this issue, a user with local administrator rights to the device must use the Computer Certificates tool to import the certificate into one of the following containers:

  1. Computer locale: persone attendibiliLocal Computer: Trusted People
  2. Computer locale: autorità radice attendibili (scelta non consigliata)Local Computer: Trusted Root Authorities (not recommended)

Importante

Non importare i certificati di firma del pacchetto nell'archivio certificati utente.Do not import package signing certificates into the User Certificate store. Il programma di installazione dell'app non cerca i certificati utente durante la verifica dell'identità del pacchetto.The App Installer does not search User Certificates when verifying package identity.

È possibile trovare facilmente lo strumento di gestione dei certificati del computer eseguendo una ricerca dal menu Start:The Computer Certificates management tool can be easily found by searching from the Start Menu:

Trovare lo strumento certificati del computer locale tramite il menu Start

Una volta che il certificato di firma è stato importato correttamente, la nuova esecuzione del programma di installazione dell'app indicherà che il pacchetto è attendibile e può essere installato:Once the signing certificate is successfully imported, re-running the app installer will show that the package is trusted and can be installed:

MSIX firmato con un certificato attendibile

Dipendenze non installateDependencies not installed

Le applicazioni Windows 10 possono avere dipendenze del Framework basate sulla piattaforma dell'applicazione usata per generare l'app.Windows 10 applications can have framework dependencies based on the application platform used to generate the app. Se si usa C# o VB, l'app richiederà i pacchetti .NET Runtime e .NET Framework.If you are using C# or VB, the app will require the .NET Runtime and .NET framework packages. Per le applicazioni C++ è necessario VCLibs.C++ applications require the VCLibs.

Importante

Se il pacchetto dell'app viene compilato in modalità di rilascio, le dipendenze del Framework verranno ottenute dal Microsoft Store.If the app package is built in Release mode configuration, the framework dependencies will be obtained from the Microsoft Store. Tuttavia, se l'app è compilata in modalità di debug, le dipendenze verranno ottenute dal percorso specificato nel .appinstaller file.However, if the app is built in Debug mode configuration, the dependencies will be obtained from the location specified in the .appinstaller file.

File non accessibiliFiles not accessible

Quando si esegue l'installazione da un endpoint HTTP, è importante verificare che tutti i file siano accessibili con il tipo MIME corretto.When installing from an HTTP endpoint, it is important to verify that all files are accessible with the correct MIME type. Il metodo più semplice per verificare questi file è attenendosi ai collegamenti forniti nella pagina HTML generata da Visual Studio.The easiest method to verify these files is by following the links provided in the HTML page generated by Visual Studio. È necessario controllare questi file:You must check these files:

  • .appinstaller file, disponibile come application/xml.appinstaller file, available as an application/xml
  • .appx e .appxbundle file, disponibili come application/vns.ms-appx.appx and .appxbundle files, available as application/vns.ms-appx

Isolare i problemi dell'app di installazione appIsolate App Installer app issues

Se il programma di installazione dell'app non è in grado di installare l'app, questa procedura consente di identificare il problema di installazione.If the App Installer cannot install the app, these steps will help identify the installation issue.

Verificare l'installazione del file del pacchetto dell'appVerify app package file installation

  • Scaricare il file del pacchetto dell'app in una cartella locale e provare a installarlo usando il comando di PowerShell Add-APPXPACKAGE .Download the app package file to a local folder and try to install it using the Add-AppxPackage PowerShell command.

  • Scaricare il .appinstaller file in una cartella locale e provare a installarlo usando il Add-AppxPackage -Appinstaller comando di PowerShell.Download the .appinstaller file to a local folder and try to install it using the Add-AppxPackage -Appinstaller PowerShell command.

Log eventi del programma di installazione appApp Installer event logs

L'infrastruttura di distribuzione delle app crea log che sono spesso utili per il debug dei problemi di installazione tramite Windows Visualizzatore eventi: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-ServerThe app deployment infrastructure emits logs that are often useful for debugging installation issues via the Windows Event Viewer: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server