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

Articolo
12/12/2023

Questo articolo descrive i problemi noti e offre suggerimenti per la risoluzione dei problemi da prendere in considerazione quando converti le tue app in MSIX tramite 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 del servizio gestito che sia stato effettuato l'iscrizione per la distribuzione in anteprima sia l'account connesso a Microsoft Store.
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) si verificherà un errore ERROR_NO_SYSTEM_RESOURCES, che causa l'esito negativo del driver.

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

Aprire il menu Start e cercare Monitor prestazioni.
Fare clic con il pulsante destro del mouse su di esso e scegliere Altro -> Esegui come Amministrazione istrator.
Scegliere Set di raccolta dati -> Sessioni di traccia eventi dal menu dell'albero.
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 usando una versione di MSIX Packaging Tool precedente alla versione 1.2019.701.0, lo strumento disponeva di requisiti di controllo delle versioni di Microsoft Store su o usava un altro strumento per creare il pacchetto che non imposta 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.

Computer remoto

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 generare un errore di conversione con codice di uscita 259. Questo codice indica che il programma di installazione ha generato un thread e non ne ha atteso il completamento. In altre parole, l'installazione del thread principale è stata completata ma si è chiusa con l'errore 259 a causa della generazione di un thread che è ancora in esecuzione. Ti consigliamo di 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. Riscrivere manualmente le intestazioni per risolvere il problema. In generale, MSIX Packaging Tool rileva automaticamente le intestazioni non valido. Se il problema persiste, inviare commenti e suggerimenti ai file. Altre informazioni sono disponibili qui.

Firma di Device Guard

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

Certificato scaduto

Usare un timestamp quando si firma il pacchetto.
È possibile firmare 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 dall'esito della conversione, vengono generati file di log per ogni conversione. Sono disponibili qui:

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

Vengono scritti codici di errore che indicano i punti in cui si sono verificati errori durante il processo di conversione. I codici di errore devono essere descrittivi.

File di log da macchine virtuali o dispositivi remoti

Se la conversione viene eseguita da una macchina virtuale o un dispositivo remoto, ti consigliamo di copiare i file di log dal dispositivo e di allegarli al feedback. Ci aiuteranno a 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 fare doppio clic sulle installazioni. 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 .

Collegamenti con argomenti

MSIX Packaging Tool acquisisce tutti i collegamenti a livello di utente insieme agli argomenti. Se questi collegamenti non vengono rilevati correttamente, è possibile aggiungerli manualmente al manifesto. Per altri dettagli, vedere desktop7:Collegamento .

Directory di installazione

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 nel 1709 ed è nel 1809, è probabile che si verifichi il problema.

Invio di feedback

Il modo migliore di inviare feedback è tramite l'Hub di Feedback.

Apri Hub di Feedback o premi tasto WINDOWS+F.
Specifica un titolo e i passaggi necessari per riprodurre il problema.
In Categoria seleziona App e quindi MSIX Packaging Tool.
Allega gli eventuali file di log associati alla conversione. Puoi trovare i log nella cartella specificata sopra.
Allega il pacchetto MSIX convertito (se possibile).
Fare clic su Invia.

Puoi inviaci feedback direttamente da MSIX Packaging Tool selezionando la scheda Feedback in Settings (Impostazioni).

Nota

La ricezione del feedback può richiedere 24 ore. Se quindi stai usando una macchina virtuale per convertire il pacchetto, ti consigliamo di tenerla accesa e nello stato corrente per 24 ore dopo la conversione. Inoltre, è possibile allegare manualmente i log di conversione ai commenti e suggerimenti.