Freigeben über

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

  • Artikel

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. 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 die MSA, die für flighting registriert ist, das Konto ist, 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 und auf der Produktseite nach einem Update suchen.
  • 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-Pakettooltreibers 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 die Menü , 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 Minimunversion in Ihrem MSIX-Paket automatisch zu ändern.

Erzwingen von Microsoft Store-Versionsverwaltungsanforderungen

Wenn Sie Ihr vorhandenes Installationsprogramm mit einer Version des MSIX Packaging Tools vor 1.2019.701.0 konvertieren, hatte das Tool die Anforderungen für die Microsoft Store-Versionsverwaltung erzwungen 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 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.

Remotecomputer

Wenn Bei der Verwendung einer Remote-VM für Ihre Konvertierungen Probleme auftreten, lesen Sie 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 abzubilden und auf fehlerhafte Elemente zu prüfen. Schreiben Sie die Kopfzeilen manuell um, um das Problem zu beheben. Im Allgemeinen erkennt das TOOL MSIX Packaging 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 ein gültiges Zeichen- oder Zeitstempelzertifikat zuweisen.

Sie können Ihre App mithilfe des Batchkonvertierungsskripts unter MSIX Toolkit - Scripts neu zuweisen.

Problembehandlung

Protokolldateien

Unabhängig davon, ob eine Konvertierung erfolgreich durchgeführt wurde, werden für jede Konvertierung Protokolldateien generiert. Diese finden Sie hier:

%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 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.

File not found

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 einen Fehler oder File in Use eine Access Denied Fehlermeldung.

File Type Associations

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 ".

Tastenkombinationen 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" .

Installationsverzeichnis

Dies ist häufiger für diejenigen, die ein sekundäres Laufwerk zum Ausführen von App-Konvertierungen verwenden. Wenn Sie den Installationsspeicherort ändern möchten, ändert es den Stamm, an dem alle Dateien gespeichert sind. Dies bedeutet, dass das MSIX Packaging-Tool wissen muss, wo all diese Dateien gehen und 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 auf 1809 zulässt. Wenn Ihre Anwendung 1709 nicht funktioniert und 1809 liegt, ist dies wahrscheinlich das Problem.

Senden von Feedback

Ihr Feedback senden Sie am besten über den 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 Konvertierungsprotokolle manuell an das Feedback anfügen.