Bekannte Probleme und Hinweise zur Problembehandlung für das MSIX-Verpackungstool

Dieser Artikel beschreibt bekannte Probleme und enthält Tipps zur Problembehandlung im Zusammenhang mit der Konvertierung von Apps in MSIX mithilfe des MSIX Packaging Tools. Sehen Sie sich unsere anderen Dokumente an, wenn Sie das MSIX Packaging Tool oder den Treiber in einer nicht verbundenen Umgebungerwerben müssen.

Bekannte Probleme

Abrufen des neuesten Insider Preview-Builds des MSIX Packaging Tools

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

  • Wechseln Sie im MSIX Packaging Tool zum Abschnitt "About", um anzuzeigen, welche Version Sie verwenden.
  • Wechseln Sie hier, um die neueste Insider Preview-Version zu ermitteln, und vergewissern Sie sich, dass diese Version des MSIX Packaging Tools installiert ist.
  • Stellen Sie sicher, dass das MSA, das für den Flug angemeldet ist, das Konto ist, das beim Microsoft Store angemeldet ist.
  • Aktualisieren Sie das MSIX Packaging Tool manuell über die Microsoft Store auf Ihrem Computer. Wenn diese Option für Sie verfügbar ist, öffnen Sie die 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 können Sie es dann zur Eingabe eines Updates auffordern.
  • 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 an unserem Insider-Programm teilnehmen möchten, klicken Sie hier.

MSIX Packaging Tool-Treiber

Der MSIX Packaging Tool-Treiber wird als FOD-Paket (Feature on Demand) aus Windows Update bereitgestellt. Die Installation ist nicht erfolgreich, wenn der Windows Updatedienst auf dem Computer deaktiviert ist oder wenn Windows Insider-Flugringeinstellungen nicht mit dem Betriebssystembuild des Computers übereinstimmen.

Wenn beim Abrufen 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 dies eines der folgenden Probleme sein.

Probleme mit der Netzwerkkonnektivität

Die folgenden Fehlercodes können darauf hinweisen, dass Verbindungsprobleme auftreten:

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

Windows Serverupdatedienst (WSUS), Konfigurations-Manager oder Gruppenrichtlinien, die sich auf Windows Updatekonnektivität auswirken

Der folgende Fehlercode kann darauf hinweisen, dass Richtlinien auf Ihrem Computer sich auf Windows Updatekonnektivität auswirken: -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 werden Sie vom MSIX Packaging Tool in der Fehlermeldung benachrichtigt und protokolliert, dass Ihr Treiber einen Neustart benötigt. Starten Sie Ihren Computer neu, und starten Sie die Konvertierung erneut, um dieses Problem zu beheben.

Fehler beim Starten des MSIX-Pakettooltreibers 0x80131500

Wenn dieser Fehler während der Konvertierung auftritt, 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 Ablaufverfolgungssitzung für Systemereignisse startet, Sie jedoch die maximale Anzahl von Sitzungen überschritten haben, die Windows systemweit erstellen können. Wenn Sie das Standardlimit (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 mit den folgenden Schritten zu beenden:

  1. Öffnen Sie die Startmenü, und suchen Sie nach Leistungsmonitor.
  2. Klicken Sie mit der rechten Maustaste darauf, und wählen Sie Mehr -> Als Administrator ausführen aus.
  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 durchzuführen.

Mindestversion

Es gibt einige Features, die Sie beachten sollten, die die Miniversionsunterstützung in Ihrem MSIX-Paket automatisch ä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, hatte das Tool die Erzwingung Microsoft Store Versionsanforderungen aktiviert oder ein anderes Tool verwendet, 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 in 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 das Manifest, und legen Sie das MinVersion Attribut des Elements auf TargetDeviceFamily "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 wurde Unterstützung für das Erstellen eines MSIX-Pakets mit Dienstenhinzugefügt. Aufgrund der Betriebssystemeinschränkungen mit Dienstunterstützung ändert das MSIX Packaging Tool automatisch die in einem MSIX-Paket mit Diensten unterstützte Mindestversion in 10.0.19025.0. Dies bedeutet, dass Sie kein MSIX mit Diensten auf einem Betriebssystem installieren können, das niedriger ist als die Windows 10 Version 2004, 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 Mindestversion 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 bewerten, ob dies erforderlich ist, damit Ihre App ordnungsgemäß ausgeführt werden kann. MSIX unterstützt derzeit keine Treiberinstallation.

Remotecomputer

Wenn bei der Verwendung eines virtuellen Remotecomputers für Ihre Konvertierungen Probleme auftreten, finden Sie weitere Informationen unter Setupanweisungen für Remotecomputerkonvertierungen.

Probleme während der Konvertierung

  • Bei einigen Installationsprogrammen treten bei der Konvertierung möglicherweise Fehler mit dem Exitcode 259 auf. Dies bedeutet, dass das Installationsprogramm einen Thread erzeugt und nicht auf dessen Abschluss wartet. Mit anderen Worten: Der Hauptthread hat die Installation abgeschlossen, wurde jedoch mit dem Fehler 259 beendet, da er einen Thread erzeugt hat, der noch ausgeführt wird. Es wird empfohlen, die entsprechende Installationsoption für „setup.exe“ zu 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 zu speichern und auf ungültige Elemente zu überprüfen. Schreiben Sie die Header manuell um, um das Problem zu beheben. Im Allgemeinen erkennt das MSIX Packaging-Tool automatisch fehlerhafte Header. Wenn dieses Problem weiterhin besteht, senden Sie Feedback. Weitere Informationen finden Sie hier.

Device Guard-Signatur

Führen Sie die folgenden 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 Vorzeichen- oder Zeitstempelzertifikat kündigen.

Sie können Ihre App mithilfe des Batchkonvertierungsskriptserstellen.

Problembehandlung

Protokolldateien

Unabhängig davon, ob eine Konvertierung erfolgreich durchgeführt wurde, werden für jede Konvertierung Protokolldateien generiert. Diese befinden sich unter folgendem Verzeichnis:

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

Fehlercodes werden protokolliert und geben alle Fehlerquellen während des Konvertierungsvorgangs an. Die Fehlercodes sollen benutzerfreundlich sein.

Protokolldateien von Remotegeräten oder virtuellen Computern

Wenn die Konvertierung auf einem Remotegerät oder virtuellen Computer ausgeführt wird, wird empfohlen, dass Sie die Protokolldateien von diesem Gerät kopieren und als Teil des Feedbacks hinzufügen. Dadurch können wir Probleme effizienter diagnostizieren und beheben.

Die Protokolle von Remotekonvertierungen finden Sie unter folgendem Verzeichnis: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Es wäre noch vorteilhafter, wenn Sie den gesamten Ordner Protokolle freigeben können, der die Vorgänge enthält, die auf dem lokalen Client und dem Remoteserver ausgeführt werden.

Häufige Probleme

MakePri/Manifest-Übersetzungsfehler

Dieser Fehler tritt auf, wenn ein Problem mit dem Manifest des Pakets vorliegt. 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 ist möglicherweise geöffnet oder nicht vorhanden. Um dieses Problem zu beheben, fügen Sie die entsprechende Datei hinzu, oder schließen Sie die Datei, die derzeit verwendet wird. Beachten Sie, dass sie keinen File not Found Fehler erhalten, wenn sie geöffnet ist. Stattdessen erhalten Sie einen Access Denied - oder File in Use -Fehler.

Dateitypzuordnungen

Die Probleme in Bezug auf Dateitypzuordnungen (File Type Associations, FTA) variieren von Paket zu Paket. Das 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.

Tastenkombinationen mit Argumenten

Verknüpfungen mit Argumenten werden mit MSIX derzeit nicht unterstützt. Wenn wir feststellen, dass das Installationsprogramm diese enthält, erstellt MSIX eine Kachel ohne Argumente.

Installationsverzeichnis

Dies ist häufiger bei Personen, die ein sekundäres Laufwerk verwenden, um App-Konvertierungen durchzuführen. Wenn Sie den Installationsspeicherort ändern möchten, ändert sich der Stamm von , in dem sich alle Dateien befinden. Das bedeutet, dass das MSIX Packaging Tool wissen muss, wo sich alle diese Dateien befinden und während der Konvertierung erfasst werden.

Sie können dies beheben, indem Sie das Paketunterstützungsframework write verwenden, um die Verzeichniskorrektur zu installieren. Wir haben dies standardmäßig als Funktion im MSIX-Tool hinzugefügt, wodurch dies bis zu 1809 möglich ist. Wenn Ihre Anwendung in 1709 nicht funktioniert und 1809 ist, ist dies wahrscheinlich das Problem.

Senden von Feedback

Die beste Möglichkeit, Ihr Feedback zu senden, ist die Feedback-Hub.

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

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

Hinweis

Es kann 24 Stunden dauern, bis Ihr Feedback an uns übermittelt wird. Wenn Sie Ihr Paket auf einem virtuellen Computer konvertieren, empfiehlt es sich, den virtuellen Computer 24 Stunden nach der Konvertierung eingeschaltet und im aktuellen Zustand zu belassen. Außerdem können Sie dem Feedback manuell Konvertierungsprotokolle anfügen.