Bekende problemen en tips voor probleemoplossing voor het MSIX Packaging Tool

In dit artikel worden bekende problemen beschreven en vindt u tips voor het oplossen van problemen bij het converteren van uw apps naar MSIX met behulp van het MSIX Packaging Tool. Bekijk onze andere documenten als u het MSIX Packaging Tool of stuurprogramma in een niet-verbonden omgeving moet aanschaffen.

Bekende problemen

De nieuwste Insider Preview-build van de MSIX Packaging-tool downloaden

Als u zich hebt aangemeld voor ons Insider-programma, controleert u of u de juiste versie van het MSIX Packaging Tool hebt:

• Ga naar de sectie Over in het MSIX Packaging Tool om te bekijken welke versie u gebruikt.
• Ga hier om de nieuwste Insider Preview-versie te bepalen en controleer of u die versie van het MSIX Packaging Tool hebt geïnstalleerd.
• Zorg ervoor dat de MSA die is geregistreerd voor flighting het account is dat is aangemeld bij de Microsoft Store.
• Werk het MSIX Packaging Tool handmatig bij via de Microsoft Store op uw computer. Als deze optie voor u beschikbaar is, opent u de Store, gaat u naar Downloads en updates en klikt u op Updates ophalen. U kunt ook zoeken naar het MSIX Packaging Tool en op de productpagina kunt u deze vervolgens vragen om een update.
• Als u het MSIX Packaging Tool wilt installeren voor offlinegebruik, volgt u deze instructies om ervoor te zorgen dat u de nieuwste app via ons offlineproces krijgt.

Als u geïnteresseerd bent in deelname aan ons Insider-programma, gaat u naar Join MSIX Packaging Tool Insiders!.

MSIX Packaging Tool-stuurprogramma

Het MSIX Packaging Tool-stuurprogramma wordt geleverd als een Feature on Demand (FOD) pakket van Windows Update. De installatie kan niet worden uitgevoerd als de Windows Update-service op de computer is uitgeschakeld of als de Windows Insider-kringinstellingen niet overeenkomen met de build van het besturingssysteem van de computer.

Als u problemen ondervindt bij het verkrijgen van het stuurprogramma of als u in een offlineomgeving werkt, vindt u koppelingen om het stuurprogramma hier te downloaden.

Als u het stuurprogramma hebt gedownload en tijdens de pakketconversie problemen ondervindt, kan dit een van de volgende problemen zijn.

Problemen met de netwerkconnectiviteit

De volgende foutcodes kunnen erop wijzen dat u verbindingsproblemen ondervindt:

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

Windows Server Update Service (WSUS), Configuration Manager of groepsbeleid dat van invloed is op Windows Update connectiviteit

De volgende foutcode kan erop wijzen dat beleid op uw computer van invloed is op Windows Update connectiviteit: -2145124306 (0x8024002e).

Als u deze foutcode ontvangt, moet u mogelijk uw omgevingsinstellingen en -beleid controleren.

Stuurprogramma vereist opnieuw installeren

In dit scenario geeft het MSIX Packaging Tool u een melding in het foutbericht en in de logs, waarin staat dat uw stuurprogramma opnieuw moet starten. Start de computer opnieuw op en start de conversie opnieuw om dit probleem op te lossen.

Fout bij het starten van de MSIX verpakkingshulpmiddel-driver 0x80131500

Als u deze fout krijgt tijdens de conversie, moet u bij het controleren van het logboekbestand een vermelding vinden zoals de volgende:

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

Deze fout treedt op wanneer het hulpprogramma een nieuwe sessie voor systeemgebeurtenistracering start, maar u hebt het maximum aantal sessies overschreden dat Windows systeembreed kan maken. Als u de standaardlimiet (64) overschrijdt, wordt er een ERROR_NO_SYSTEM_RESOURCES fout weergegeven, waardoor het stuurprogramma mislukt.

De oplossing is om enkele van de bestaande gebeurtenistraceringssessies te stoppen door de volgende stappen uit te voeren:

1. Open het startmenu en zoek naar Performance Monitor.
2. Klik er met de rechtermuisknop op en kies Meer -> Als administrator uitvoeren.
3. Kies in het structuurmenu Gegevensverzamelaarsets -> Gebeurtenistraceringssessies.
4. Klik met de rechtermuisknop op een aantal bestaande sessies in de lijst en kies Stoppen.

U kunt nu opnieuw proberen de conversie uit te voeren met het MSIX Packaging Tool.

Minimumversie

Er zijn enkele functies waar u rekening mee moet houden, die de ondersteuning voor de minimumversie automatisch bijwerken voor uw MSIX-pakket.

Het afdwingen van de vereisten voor Microsoft Store-versies

Als u uw bestaande installatieprogramma converteert met een versie van de MSIX Packaging Tool ouder dan 1.2019.701.0, het hulpprogramma had Microsoft Store versievereisten afgedwongen of een ander hulpprogramma gebruikt om uw pakket te maken dat de minimale versie niet heeft ingesteld op 10.0.16299.0 (Windows 10, versie 1709). Dit veroorzaakt een foutbericht bij het implementeren van uw app naar Windows 10, versie 1709 of een nieuwere versie.

U kunt dit probleem oplossen door het MSIX Packaging Tool te openen en uw app te bewerken via Pakketeditor. Open het manifest en stel het MinVersion kenmerk van het TargetDeviceFamily element in op '10.0.16299.0'.

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

MSIX met diensten

In versie 1.2019.1220.0 van het MSIX Packaging Tool hebben we ondersteuning toegevoegd voor het maken van een MSIX-pakket met Services. Vanwege de besturingssysteembeperkingen met ondersteuning voor services, wijzigt het MSIX Packaging Tool automatisch de minimale versie die wordt ondersteund in een MSIX-pakket met services naar 10.0.19025.0. Dit betekent dat u een MSIX met services niet kunt installeren op een besturingssysteem dat lager is dan de Windows 10 versie 2004, maar u kunt die MSIX maken met behulp van het MSIX Packaging Tool tot Windows 10 1809. Als u deze app op een lager besturingssysteem wilt installeren, werkt u de minimale versie bij, maar houd er rekening mee dat ondersteuning voor services niet werkt.

Frameworks en stuurprogramma's

Als voor de app een framework is vereist, moet u ervoor zorgen dat het framework is geïnstalleerd tijdens de bewakingsfase van de conversie. Doorloop de logboeken om ervoor te zorgen dat dit gebeurt. Als voor uw app een stuurprogramma moet worden geïnstalleerd, moet u evalueren of dit vereist is om uw app goed uit te voeren. MSIX biedt momenteel geen ondersteuning voor installatie van stuurprogramma's.

Externe machine

Als u problemen ondervindt met het gebruik van een externe VM voor uw conversies, raadpleegt u installatie-instructies voor externe machineconversies.

Problemen tijdens conversie

• Sommige installatieprogramma's kunnen mogelijk niet worden geconverteerd met afsluitcode 259. Dit geeft aan dat het installatieprogramma een thread heeft voortgebracht en niet heeft gewacht totdat deze is voltooid. Met andere woorden, de hoofdthread is geïnstalleerd, maar is afgesloten met fout 259 omdat er een thread is geactiveerd die nog steeds wordt uitgevoerd. U wordt aangeraden de juiste installatieoptie voor setup.exete gebruiken.

Problemen tijdens het ondertekenen

Ongeldig PE-certificaat (0x800700C1)

Dit probleem treedt op wanneer het pakket een binair bestand bevat met een beschadigd certificaat. Gebruik de dumpbin.exe /headers opdracht om de bestandsheaders te dumpen en te controleren op slechte elementen om dit probleem op te lossen. Herschrijf de headers handmatig om het probleem op te lossen. Over het algemeen detecteert het MSIX Packaging-hulpprogramma automatisch ongeldige headers. Als dit probleem zich blijft voordoen, kunt u feedback indienen. Meer informatie vindt u hier .

Device Guard-ondertekening

Zorg ervoor dat u e stappen volgt en dat u de juiste rollen toewijst in de Microsoft Store voor Bedrijven.

Verlopen certificaat

• Gebruik een tijdstempel wanneer u uw pakket ondertekent.
• U kunt zich afmelden met een geldig teken- of tijdstempelcertificaat.

U kunt uw app opnieuw signeren met behulp van het batchconversiescript in MSIX Toolkit - Scripts.

Probleemoplossingsproces

Logboekbestanden

Of de conversie al dan niet is geslaagd, logboekbestanden worden gegenereerd voor elke conversie. Ze zijn hier te vinden:

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

Foutcodes worden geschreven en geven een storingspunt aan tijdens het conversieproces. De foutcodes zijn bedoeld om gebruiksvriendelijk te zijn.

Logboekbestanden van externe apparaten of VM's

Als de conversie wordt uitgevoerd op een extern apparaat of een virtuele machine, raden we u aan de logboekbestanden van dat apparaat te kopiëren en deze als onderdeel van het feedback-item toe te voegen. Dit helpt ons om problemen efficiënter te diagnosticeren en op te lossen.

U vindt de logboeken van de externe conversies hier: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Het zou nog nuttiger zijn als u de hele map Logboeken kunt delen die de bewerkingen bevat die plaatsvinden op de lokale client en de externe server.

Algemene problemen

Fouten bij het vertalen van MakePri/Manifest

Deze fout treedt op wanneer er een probleem is met het manifest van het pakket. Als u het probleem wilt identificeren, gaat u naar Pakketeditor en opent u het manifest. Wanneer u het manifest opent, kunt u het probleem identificeren en de juiste oplossing opgeven.

Bestand niet gevonden

Het bestand zou open kunnen zijn of mogelijk niet bestaan. Als u dit probleem wilt oplossen, voegt u het juiste bestand toe of sluit u het bestand dat momenteel wordt gebruikt. Houd er rekening mee dat u geen File not Found-foutmelding zult krijgen als deze geopend is. In plaats daarvan krijgt u een Access Denied of File in Use-fout.

Bestandstype koppelingen

De problemen met betrekking tot bestandskoppelingen (FTA) variëren van pakket tot pakket. MSIX Packaging Tool ondersteunt bestandassociaties voor installatie via dubbelklik. Als uw app bijvoorbeeld een contextmenu heeft, wordt deze niet automatisch toegevoegd, dus moet u deze handmatig toevoegen aan het manifest. Zie het manifestelement Desktop4:FileExplorerContextMenus voor een voorbeeld.

Snelkoppelingen met argumenten

Het HULPPROGRAMMA MSIX Packaging legt alle snelkoppelingen op gebruikersniveau samen met argumenten vast. Als deze snelkoppelingen niet juist worden gedetecteerd, kunt u deze handmatig toevoegen aan het manifest. Zie desktop7:Snelkoppeling voor meer informatie.

Map installeren

Dit komt vaker voor bij degenen die een secundaire schijf gebruiken om app-conversies uit te voeren. Als u ervoor kiest om de installatielocatie te wijzigen, wordt de hoofdmap van alle bestanden gewijzigd. Dit betekent dat het MSIX Packaging-hulpprogramma moet weten waar al deze bestanden naartoe gaan en worden vastgelegd tijdens de conversie.

U kunt dit oplossen met behulp van het Write-pakketondersteuningsframework om mapfix te installeren. We hebben dit standaard toegevoegd als een mogelijkheid in het MSIX-hulpprogramma, waardoor dit tot 1809 is toegestaan. Als uw toepassing niet werkt in 1709 en in 1809 valt, is dit waarschijnlijk het probleem.

Feedback verzenden

De beste manier om uw feedback te verzenden, is via de Feedback Hub.

1. Open Feedback Hub of druk op Windows + F.
2. Geef een titel en de benodigde stappen op om het probleem te reproduceren.
3. Selecteer onder Categorieapps en selecteer MSIX Packaging Tool.
4. Voeg logboekbestanden toe die aan de conversie zijn gekoppeld. U vindt de logboeken in de bovenstaande map.
5. Voeg het geconverteerde MSIX-pakket toe (indien mogelijk).
6. Klik op Verzenden.

U kunt ons ook rechtstreeks feedback sturen via het MSIX Packaging Tool via het tabblad Feedback onder Instellingen.