Bekannte Probleme und Tipps zur Problembehandlung für das MSIX Packaging Tool

In diesem Artikel werden bekannte Probleme beschrieben und Tipps zur Problembehandlung bereitgestellt, die Sie beim Konvertieren Ihrer Apps mit dem MSIX Packaging Tool in MSIX berücksichtigen sollten. Schauen Sie sich unsere anderen Dokumente an, wenn Sie das MSIX Packaging Tool oder Treiber in einer getrennten Umgebung erwerben müssen.

Bekannte Probleme

Abrufen des neuesten Insider Preview-Builds des MSIX Packaging Tools

Wenn Sie sich für unser Insider-Programm entschieden haben, stellen Sie sicher, dass Sie über die richtige Version des MSIX Packaging Tools verfügen:

• Wechseln Sie zum Abschnitt "Info " im MSIX Packaging Tool, um anzuzeigen, welche Version Sie verwenden.
• Hier können Sie die neueste Insider Preview-Version ermitteln und bestätigen, dass diese Version des MSIX Packaging Tools installiert ist.
• Stellen Sie sicher, dass es sich bei dem für Flighting angemeldeten MSA um das Konto handelt, das beim Microsoft Store angemeldet ist.
• Aktualisieren Sie das MSIX-Pakettool manuell über den Microsoft Store auf Ihrem Computer. Wenn diese Option für Sie verfügbar ist, öffnen Sie den Store, wechseln Sie zu Downloads und Updates, und klicken Sie auf "Updates abrufen". Alternativ können Sie nach dem MSIX Packaging Tool suchen und auf der Produktseite die Aktualisierung anfordern.
• Um das MSIX Packaging Tool für die Offlineverwendung zu installieren, befolgen Sie diese Anweisungen , um sicherzustellen, dass Sie die neueste App über unseren Offlineprozess erhalten.

Wenn Sie daran interessiert sind, unserem Insider-Programm beizutreten, wechseln Sie zu MSIX Packaging Tool Insiders!.

MSIX Packaging Tool-Treiber

Der MSIX Packaging Tool-Treiber wird als FoD-Paket (Feature on Demand) von Windows Update bereitgestellt. Es wird nicht installiert, wenn der Windows Update-Dienst auf dem Computer deaktiviert ist oder die Windows-Insider-Flight-Ring-Einstellungen nicht mit dem Betriebssystembuild des Computers übereinstimmen.

Wenn Beim Erwerb des Treibers Probleme auftreten oder Sie in einer Offlineumgebung arbeiten, finden Sie hier Links zum Herunterladen des Treibers.

Wenn Sie den Treiber heruntergeladen haben und während der Paketkonvertierung Probleme auftreten, kann es sich um eines der folgenden Probleme handeln.

Probleme mit der Netzwerkkonnektivität

Die folgenden Fehlercodes deuten möglicherweise darauf hin, dass Verbindungsprobleme auftreten:

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

Windows Server Update Service (WSUS), Configuration Manager oder Gruppenrichtlinien, die sich auf die Windows Update-Konnektivität auswirken

Der folgende Fehlercode weist möglicherweise darauf hin, dass Richtlinien auf Ihrem Computer Auswirkungen auf die Windows Update-Konnektivität haben: -2145124306 (0x8024002e).

Wenn Sie diesen Fehlercode erhalten, müssen Sie möglicherweise Ihre Umgebungseinstellungen und -richtlinien überprüfen.

Treiber erforderte eine Neuinstallation

In diesem Szenario benachrichtigt Sie das MSIX Packaging Tool in der Fehlermeldung und protokolliert, dass Ihr Treiber einen Neustart benötigt. Starten Sie Den Computer neu, und starten Sie die Konvertierung erneut, um dieses Problem zu beheben.

Fehler beim Starten des MSIX-Paket-Tool-Treibers 0x80131500

Wenn dieser Fehler während der Konvertierung angezeigt wird, sollten Sie beim Überprüfen der Protokolldatei einen Eintrag wie den folgenden finden:

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

Dieser Fehler tritt auf, wenn das Tool eine neue Systemereignisablaufverfolgungssitzung startet, Aber Sie haben die maximale Anzahl von Sitzungen überschritten, die Windows systemweit erstellen kann. Wenn Sie den Standardgrenzwert (64) überschreiten, tritt ein ERROR_NO_SYSTEM_RESOURCES Fehler auf, der dazu führt, dass der Treiber fehlschlägt.

Die Lösung besteht darin, einige der vorhandenen Ereignisablaufverfolgungssitzungen zu beenden, indem Sie die folgenden Schritte ausführen:

1. Öffnen Sie das Startmenü, und suchen Sie nach "Leistungsmonitor".
2. Klicken Sie mit der rechten Maustaste darauf, und wählen Sie "Weitere" aus –> Als Administrator ausführen.
3. Wählen Sie im Strukturmenü "Datensammlersätze –> Ereignisablaufverfolgungssitzungen" aus.
4. Klicken Sie mit der rechten Maustaste auf einige der vorhandenen Sitzungen in der Liste, und wählen Sie "Beenden" aus.

Jetzt können Sie erneut versuchen, die Konvertierung mit dem MSIX Packaging Tool auszuführen.

Mindestversion

Es gibt einige Features, die sie kennen sollten, um die Unterstützung der minimalen Version in Ihrem MSIX-Paket automatisch zu ändern.

Erzwingen von Versionsanforderungen für den Microsoft Store

Wenn Sie Ihr vorhandenes Installationsprogramm mit einer Version des MSIX Packaging Tools vor 1.2019.701.0 konvertieren, war in dem Tool die Option zum Erzwingen der Versionsanforderungen für den Microsoft Store aktiviert. Alternativ könnte ein anderes Tool verwendet worden sein, um Ihr Paket zu erstellen, das die Mindestversion nicht auf 10.0.16299.0 (Windows 10, Version 1709) festgelegt hat. Dies führt zu einer Fehlermeldung, wenn Sie Ihre App auf Windows 10, Version 1709 oder höher, bereitstellen.

Um dieses Problem zu beheben, öffnen Sie das MSIX Packaging Tool , und bearbeiten Sie Ihre App über den Paket-Editor. Öffnen Sie Ihr Manifest, und legen Sie das MinVersion Attribut des TargetDeviceFamily Elements auf "10.0.16299.0" fest.

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

MSIX mit Diensten

In Version 1.2019.1220.0 des MSIX Packaging Tools haben wir Unterstützung für das Erstellen eines MSIX-Pakets mit Services hinzugefügt. Aufgrund der Betriebssystemeinschränkungen mit Dienstunterstützung ändert das MSIX Packaging Tool automatisch die min. Version, die in einem MSIX-Paket mit Diensten unterstützt wird, auf 10.0.19025.0. Dies bedeutet, dass Sie msIX nicht mit Diensten auf einem Betriebssystem installieren können, das niedriger als die Windows 10 Version 2004 ist, aber Sie können dieses MSIX mit dem MSIX Packaging Tool bis Windows 10 1809 erstellen. Wenn Sie diese App unter einem niedrigeren Betriebssystem installieren müssen, aktualisieren Sie die Min.-Version entsprechend, beachten Sie jedoch, dass die Unterstützung für Dienste nicht funktioniert.

Frameworks und Treiber

Wenn die App ein Framework erfordert, stellen Sie sicher, dass das Framework während der Überwachungsphase der Konvertierung installiert ist. Durchlaufen Sie die Protokolle, um sicherzustellen, dass dies geschieht. Wenn für Ihre App ein Treiber installiert werden muss, müssen Sie auswerten, ob dies erforderlich ist, damit Ihre App ordnungsgemäß ausgeführt wird. MSIX unterstützt derzeit keine Treiberinstallation.

Fernrechner

Wenn Bei der Verwendung einer Remote-VM für Ihre Konvertierungen Probleme auftreten, lesen Sie Setupanweisungen für Remotecomputerkonvertierungen.

Probleme während der Konvertierung

• Einige Installationsprogramme können möglicherweise nicht mit Exitcode 259 konvertiert werden. Dies gibt an, dass der Installer einen Thread spawniert hat und nicht darauf gewartet hat, bis er abgeschlossen ist. Mit anderen Worten, der Hauptthread hat die Installation abgeschlossen, aber er wurde mit Fehler 259 beendet, da er einen Thread erstellt hat, der noch ausgeführt wird. Es wird empfohlen, die entsprechende Installationsoption für setup.exezu verwenden.

Probleme beim Signieren

Ungültiges PE-Zertifikat (0x800700C1)

Dieses Problem tritt auf, wenn das Paket eine Binärdatei mit einem beschädigten Zertifikat enthält. Um dieses Problem zu beheben, verwenden Sie den dumpbin.exe /headers Befehl, um die Dateiheader auszugeben und auf fehlerhafte Elemente zu prüfen. Schreiben Sie die Kopfzeilen manuell um, um das Problem zu beheben. Im Allgemeinen erkennt das MSIX Packaging Tool fehlerhafte Header automatisch. Wenn dieses Problem weiterhin besteht, senden Sie Feedback. Weitere Informationen finden Sie hier.

Device Guard-Signatur

Führen Sie diese Schritte aus, und weisen Sie die entsprechenden Rollen im Microsoft Store für Unternehmen zu.

Abgelaufenes Zertifikat

• Verwenden Sie einen Zeitstempel, wenn Sie Ihr Paket signieren.
• Sie können mit einem gültigen Zeichen- oder Zeitstempelzertifikat kündigen.

Sie können Ihre App mithilfe des Batchkonvertierungsskripts unter MSIX Toolkit - Scripts erneut signieren.

Problembehandlung

Protokolldateien

Unabhängig davon, ob die Konvertierung erfolgreich war, werden Protokolldateien für jede Konvertierung generiert. Sie finden Sie hier:

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

Fehlercodes werden geschrieben und geben während des Konvertierungsprozesses einen Fehlerpunkt an. Die Fehlercodes sollen benutzerfreundlich sein.

Protokolldateien von Remotegeräten oder VMs

Wenn die Konvertierung auf einem Remotegerät oder einem virtuellen Computer ausgeführt wird, empfehlen wir, die Protokolldateien von diesem Gerät zu kopieren und als Teil des Feedbackelements anzufügen. Dies hilft uns, Probleme effizienter zu diagnostizieren und zu beheben.

Hier finden Sie die Protokolle aus den Remotekonvertierungen: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Es wäre noch vorteilhafter, wenn Sie den gesamten Protokollordner freigeben können, der die Vorgänge enthält, die auf dem lokalen Client sowie auf dem Remoteserver auftreten.

Häufige Probleme

MakePri/Manifest-Übersetzungsfehler

Dieser Fehler tritt auf, wenn ein Problem mit dem Manifest des Pakets auftritt. Um das Problem zu identifizieren, wechseln Sie zum Paket-Editor, und öffnen Sie das Manifest. Wenn Sie das Manifest öffnen, können Sie das Problem identifizieren und die richtige Lösung bereitstellen.

Datei nicht gefunden

Die Datei kann entweder geöffnet oder nicht vorhanden sein. Um dieses Problem zu beheben, fügen Sie die entsprechende Datei hinzu, oder schließen Sie die aktuell verwendete Datei. Beachten Sie, dass beim Öffnen keine File not Found Fehlermeldung angezeigt wird. Stattdessen erhalten Sie eine Access Denied oder File in Use Fehlermeldung.

Dateitypzuordnungen

Die Probleme in Bezug auf Dateitypzuordnungen (File Type Associations, FTA) variieren von Paket zu Paket. MSIX Packaging Tool unterstützt Dateizuordnungen für Doppelklickinstallationen. Wenn Ihre App beispielsweise über ein Kontextmenü verfügt, wird sie nicht automatisch hinzugefügt, daher müssen Sie sie dem Manifest manuell hinzufügen. Ein Beispiel finden Sie im Manifestelement "desktop4:FileExplorerContextMenus ".

Verknüpfungen mit Argumenten

Das MSIX Packaging-Tool erfasst alle Tastenkombinationen auf Benutzerebene zusammen mit Argumenten. Falls diese Tastenkombinationen nicht ordnungsgemäß erkannt werden, können Sie sie dem Manifest manuell hinzufügen. Weitere Informationen finden Sie unter "desktop7:Shortcut" .

Verzeichnis installieren

Dies ist häufiger für diejenigen, die ein sekundäres Laufwerk zum Ausführen von App-Konvertierungen verwenden. Wenn Sie sich dafür entscheiden, den Installationsspeicherort zu ändern, ändert sich der Stamm des Speicherorts aller Dateien. Dies bedeutet, dass das MSIX Packaging-Tool wissen muss, wohin all diese Dateien gehören sowie während der Konvertierung erfasst werden.

Sie können dies beheben, indem Sie das Paketsupportframework schreiben, um Verzeichniskorrektur zu installieren. Wir haben dies standardmäßig als Funktion im MSIX-Tool hinzugefügt, was dies bis zur Version 1809 ermöglicht. Wenn Ihre Anwendung in Version 1709 nicht funktioniert, aber in Version 1809 funktioniert, ist dies wahrscheinlich das Problem.

Senden von Feedback

Die beste Möglichkeit, Ihr Feedback zu senden, ist über den Feedback-Hub.

1. Öffnen Sie den Feedback-Hub , oder geben Sie Windows+F ein.
2. Geben Sie einen Titel und die erforderlichen Schritte zum Reproduzieren des Problems an.
3. Wählen Sie unter "Kategorie" "Apps" und dann "MSIX Packaging Tool" aus.
4. Fügen Sie alle Protokolldateien an, die der Konvertierung zugeordnet sind. Sie finden die Protokolle im oben angegebenen Ordner.
5. Fügen Sie das konvertierte MSIX-Paket an (sofern möglich).
6. Klicken Sie auf Absenden.

Sie können uns auch direkt über das MSIX Packaging Tool Feedback senden, indem Sie unter "Einstellungen" zur Registerkarte "Feedback" wechseln.