Problemi noti e suggerimenti per la risoluzione dei problemi relativi a MSIX Packaging Tool

Questo articolo descrive i problemi noti e fornisce suggerimenti per la risoluzione dei problemi da considerare durante la conversione delle app in MSIX usando MSIX Packaging Tool. Consultare gli altri documenti se è necessario acquisire MSIX Packaging Tool o il driver in ambienti disconnessi.

Problemi noti

Ottenere la build più recente di Insider Preview di MSIX Packaging Tool

Se hai acconsento esplicitamente al programma Insider, assicurati di avere la versione corretta di MSIX Packaging Tool:

• Passare alla sezione About (Informazioni) in MSIX Packaging Tool per visualizzare la versione in uso.
• Passare qui per determinare la versione più recente di Insider Preview e verificare che sia installata tale versione di MSIX Packaging Tool.
• Assicurarsi che l'account Microsoft iscritto al programma di test sia l'account connesso allo Store di Microsoft.
• Aggiornare manualmente MSIX Packaging Tool tramite Microsoft Store nel computer. Se questa opzione è disponibile, aprire lo Store, passare a Download e aggiornamenti e fare clic su Ottieni aggiornamenti. In alternativa, cercare MSIX Packaging Tool e nella pagina del prodotto è possibile richiedere un aggiornamento.
• Per installare MSIX Packaging Tool per l'uso offline, seguire queste istruzioni per assicurarsi di ottenere l'app più recente tramite il processo offline.

Se sei interessato a partecipare al nostro Programma Insider, vai a Partecipa a MSIX Packaging Tool Insiders!.

Driver di MSIX Packaging Tool

Il driver MSIX Packaging Tool viene distribuito come pacchetto feature on demand (FOD) da Windows Update. L'installazione non riesce se il servizio Windows Update è disabilitato nel computer o se le impostazioni dell'anello di anteprima di Windows Insider non corrispondono alla build del sistema operativo del computer.

Se si verificano problemi durante l'acquisizione del driver o si lavora in un ambiente offline, è possibile trovare i collegamenti per scaricare il driver qui.

Se il driver è stato scaricato e si verificano problemi durante la conversione del pacchetto, potrebbe trattarsi di uno dei problemi seguenti.

Problemi relativi alla connettività di rete

I codici di errore seguenti potrebbero indicare che si verificano problemi di connessione:

• -2145107924 (0x8024402c)
• -2145107945 (0x80244017)
• -2145123272 (0x80240438)

Windows Server Update Service (WSUS), Configuration Manager o criteri di gruppo che influiscono sulla connettività di Windows Update

Il codice di errore seguente può indicare che i criteri nel computer influiscono sulla connettività di Windows Update: -2145124306 (0x8024002e).

Se viene visualizzato questo codice di errore, potrebbe essere necessario controllare le impostazioni e i criteri dell'ambiente.

Il driver ha richiesto una reinstallazione

In questo scenario, MSIX Packaging Tool invierà una notifica nel messaggio di errore e registra che il driver necessita di un riavvio. Riavviare il computer e avviare di nuovo la conversione per risolvere il problema.

Errore durante l'avvio del driver msiX packaging tool 0x80131500

Se si verifica questo errore durante la conversione, quando si controlla il file di log è necessario trovare una voce simile alla seguente:

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

Questo errore si verifica quando lo strumento avvia una nuova sessione di traccia eventi di sistema, ma è stato superato il numero massimo di sessioni che Windows può creare a livello di sistema. Se si supera il limite predefinito (64), incontrerete un errore ERROR_NO_SYSTEM_RESOURCES, che provoca il fallimento del driver.

La soluzione consiste nell'arrestare alcune delle sessioni di Traccia eventi esistenti seguendo questa procedura:

1. Aprire il menu Start e cercare Performance Monitor.
2. Fare clic con il pulsante destro del mouse su di esso e scegliere Altro -> Esegui come amministratore.
3. Scegliere Set di raccolta dati -> Sessioni di traccia eventi dal menu dell'albero.
4. Fare clic con il pulsante destro del mouse su alcune delle sessioni esistenti nell'elenco e scegliere Arresta.

Ora è possibile provare di nuovo a eseguire la conversione con MSIX Packaging Tool.

Versione minima

Esistono alcune funzionalità da tenere presente che modificano automaticamente il supporto della versione minimun nel pacchetto MSIX.

Applicare i requisiti di controllo delle versioni di Microsoft Store

Se converti il programma di installazione esistente utilizzando una versione di MSIX Packaging Tool precedente alla 1.2019.701.0, lo strumento aveva abilitato i requisiti di controllo delle versioni di Microsoft Store, oppure hai usato un altro strumento per creare il tuo pacchetto che non impostava la versione minima su 10.0.16299.0 (Windows 10, versione 1709). Questo genererà un messaggio di errore durante la distribuzione dell'app in Windows 10 versione 1709 o successiva.

Per risolvere questo problema, aprire MSIX Packaging Tool e modificare l'app tramite Editor pacchetti. Aprire il manifesto e impostare l'attributo MinVersion dell'elemento TargetDeviceFamily su "10.0.16299.0".

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

MSIX con servizi

Nella versione 1.2019.1220.0 di MSIX Packaging Tool è stato aggiunto il supporto per la creazione di un pacchetto MSIX con Servizi. A causa delle restrizioni del sistema operativo con il supporto dei servizi, MSIX Packaging Tool modifica automaticamente la versione minima supportata in un pacchetto MSIX con servizi a 10.0.19025.0. Ciò significa che non è possibile installare MSIX con servizi in un sistema operativo inferiore a Windows 10 versione 2004, ma è possibile creare MSIX usando MSIX Packaging Tool fino a Windows 10 1809. Se è necessario installare questa app in un sistema operativo inferiore, aggiornare la versione minima in modo appropriato, ma si noti che il supporto per i servizi non funzionerà.

Framework e driver

Se l'app richiede un framework, assicurarsi che il framework sia installato durante la fase di monitoraggio della conversione. Esaminare i log per assicurarsi che ciò accada. Se l'app richiede un driver da installare, è necessario valutare se è necessario per il corretto funzionamento dell'app. MSIX attualmente non supporta l'installazione del driver.

Macchina remota

Se si verificano problemi con l'uso di una macchina virtuale remota per le conversioni, vedere Istruzioni di installazione per le conversioni di computer remoti.

Problemi durante la conversione

• Alcuni programmi di installazione potrebbero non riuscire a eseguire la conversione con codice di uscita 259. Ciò indica che il programma di installazione ha generato un thread e non ha aspettato il completamento. In altre parole, il thread principale ha terminato l'installazione ma è uscito con errore 259 perché ha generato un thread ancora in esecuzione. È consigliabile usare l'opzione di installazione appropriata per setup.exe.

Problemi durante la firma

Certificato PE non valido (0x800700C1)

Questo problema si verifica quando il pacchetto contiene un file binario con un certificato danneggiato. Per risolvere questo problema, usare il dumpbin.exe /headers comando per eseguire il dump delle intestazioni del file e controllare la presenza di elementi non valido. Riscrivi manualmente le intestazioni per risolvere definitivamente il problema. In generale, lo strumento di packaging MSIX rileva automaticamente le intestazioni non valide. Se il problema persiste, invia un feedback. Altre informazioni sono disponibili qui.

Firma del Device Guard

Assicurarsi di seguire questi passaggi e di assegnare i ruoli appropriati in Microsoft Store per le aziende.

Certificato scaduto

• Usare un timestamp quando si firma il pacchetto.
• È possibile dimettersi con un certificato di firma o timestamp valido.

È possibile riassegnare l'app usando lo script di conversione batch in MSIX Toolkit - Scripts.

Risoluzione dei problemi

File di registro

Indipendentemente dal fatto che la conversione abbia avuto esito positivo, i file di log vengono generati per ogni conversione. Sono disponibili qui:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

I codici di errore vengono scritti e indicano qualsiasi punto di errore durante il processo di conversione. I codici di errore sono concepiti per essere intuitivi.

File di log da dispositivi remoti o macchine virtuali

Se la conversione viene eseguita in un dispositivo remoto o in una macchina virtuale, è consigliabile copiare i file di log dal dispositivo e allegarli come parte dell'elemento di feedback. Ciò consentirà di diagnosticare e risolvere i problemi in modo più efficiente.

I log delle conversioni remote sono disponibili qui: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Sarebbe ancora più utile se è possibile condividere l'intera cartella Logs che includerà le operazioni che si verificano sul client locale e sul server remoto.

Problemi comuni

Errori di traduzione di MakePri/Manifest

Questo errore si verifica quando si verifica un problema con il manifesto del pacchetto. Per identificare il problema, passare a Editor pacchetti e aprire il manifesto. Quando si apre il manifesto, è possibile identificare il problema e fornire la correzione corretta.

File non trovato

Il file può essere aperto o non esistente. Per risolvere questo problema, aggiungere il file appropriato o chiudere il file attualmente in uso. Si noti che non verrà visualizzato un File not Found errore se è aperto. Verrà invece visualizzato un Access Denied errore o File in Use .

Associazioni di tipi di file

I problemi relativi alle associazioni di tipi di file (FTA) variano da pacchetto a pacchetto. MSIX Packaging Tool supporta le associazioni di file per installazioni tramite doppio clic. Ad esempio, se l'app ha un menu di scelta rapida, non viene aggiunta automaticamente, quindi sarà necessario aggiungerla manualmente al manifesto. Per un esempio, vedere l'elemento manifesto desktop4:FileExplorerContextMenus .

Scorciatoie con argomenti

MSIX Packaging Tool acquisisce tutti i collegamenti a livello utente insieme agli argomenti. Se queste scorciatoie non vengono rilevate correttamente, è possibile aggiungerle manualmente al manifest. Per maggiori dettagli, vedere desktop7:Collegamento.

Installare la directory

Questo è più comune per coloro che usano un'unità secondaria per eseguire conversioni di app. Se si sceglie di modificare il percorso di installazione, cambia la radice della posizione in cui vanno tutti i file. Ciò significa che lo strumento MSIX Packaging dovrà sapere dove andranno tutti questi file e verranno acquisiti durante la conversione.

Per risolvere questo problema, è possibile usare la scrittura di Package Support Framework per installare la correzione della directory. Questa funzionalità è stata aggiunta come funzionalità per impostazione predefinita nello strumento MSIX, che consente questo valore fino a 1809. Se l'applicazione non funziona nella versione 1709, ma funziona nella versione 1809, potrebbe essere questo il problema.

Invio di commenti e suggerimenti

Il modo migliore per inviare commenti e suggerimenti consiste nell'hub di Feedback.

1. Aprire Hub di feedback o digitare Windows + F.
2. Fornisci un titolo ed elenca i passaggi necessari per riprodurre il problema.
3. In Categoria selezionare App e selezionare MSIX Packaging Tool.
4. Allegare tutti i file di log associati alla conversione. È possibile trovare i log nella cartella specificata in precedenza.
5. Collegare il pacchetto MSIX convertito (se possibile).
6. Fare clic su Invia.

Puoi anche inviare commenti e suggerimenti direttamente da MSIX Packaging Tool passando alla scheda Commenti e suggerimenti in Impostazioni.

Annotazioni

Potrebbero essere necessarie 24 ore per ricevere commenti e suggerimenti. Pertanto, se si usa una macchina virtuale per convertire il pacchetto, è consigliabile mantenere attiva la macchina virtuale e nello stato corrente per 24 ore dopo la conversione. Inoltre, è possibile allegare manualmente i log di conversione ai commenti e suggerimenti.