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 Umgebung erwerben müssen.

Bekannte Probleme

Abrufen des neuesten Insider Preview-Builds des MSIX Packaging Tools

Wenn Sie sich für unser Insider-Programm angemeldet 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 (Informationen), um zu sehen, welche Version Sie verwenden.
  • Ermitteln Sie hier die neueste Insider Preview-Version, und vergewissern Sie sich, 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 bei der Microsoft Store.
  • Aktualisieren Sie das MSIX Packaging Tool manuell über 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 herunterladen. Suchen Sie alternativ nach dem MSIX Packaging Tool, und auf der Produktseite können Sie es 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 FEATURE-on-Demand-Paket (FOD) von Windows Update. Es kann nicht installiert werden, wenn der Windows Update-Dienst auf dem Computer deaktiviert ist oder Windows Insider-Flightringeinstellungen nicht mit dem Betriebssystem-Build 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 auftraten, 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 Server Update Service (WSUS), Configuration Manager oder Gruppenrichtlinien, die sich auf Windows Update beeinträchtigen

Der folgende Fehlercode kann darauf hinweisen, dass richtlinien auf Ihrem Computer auswirkungen auf Windows Update Konnektivität sind: -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 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 Systemereignisablaufverfolgungssitzung startet, aber Sie die maximale Anzahl von Sitzungen überschritten haben, Windows systemweit erstellen können. Wenn Sie den Standardgrenzwert (64) überschreiten, tritt ein Fehler ERROR_NO_SYSTEM_RESOURCES, der dazu führt, dass der Treiber fehlschlägt.

Die Lösung besteht im Beenden einiger der vorhandenen Ereignisverfolgungssitzungen, indem Sie die folgenden Schritte ausführen:

  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 – Ereignisverfolgungssitzungen> aus.
  4. Klicken Sie mit der rechten Maustaste auf einige der vorhandenen Sitzungen in der Liste, und wählen Sie Beenden aus.

Nun können Sie versuchen, die Konvertierung mit dem MSIX Packaging Tool erneut zu starten.

Mindestversion

Es gibt einige Features zu beachten, die die Unterstützung der Minimunversion in Ihrem MSIX-Paket automatisch ändern.

Erzwingen von Versionsanforderungen für den Microsoft Store

Wenn Sie Ihr vorhandenes Installationsprogramm mithilfe einer Version des MSIX Packaging Tools vor 1.2019.701.0 konvertieren, hat das Tool anforderungen an die Erzwingung von Microsoft Store-Versionsanforderungen auf 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 verursacht eine Fehlermeldung, wenn Sie Ihre App für 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 MinVersion Sie das -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 wurde Unterstützung für das Erstellen eines MSIX-Pakets mit Diensten hinzugefügt. Aufgrund der Betriebssystemeinschränkungen bei der Dienstunterstützung ändert das MSIX Packaging Tool automatisch die mindestversion, die in einem MSIX-Paket mit Diensten unterstützt wird, in 10.0.19025.0. Dies bedeutet, dass Sie keine MSIX mit Diensten unter einem Betriebssystem installieren können, das niedriger als die Windows 10-Version 2004 ist. Sie können diese MSIX jedoch 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. Gehen Sie die Protokolle durch, um sicherzustellen, dass dies geschieht. Wenn für Ihre App die Installation eines Treibers erforderlich ist, müssen Sie überprüfen, ob dies erforderlich ist, damit Ihre App ordnungsgemäß ausgeführt wird. MSIX unterstützt derzeit keine Treiberinstallation.

Remotecomputer

Wenn Probleme bei der Verwendung eines virtuellen Remotecomputers für Ihre Konvertierungen auftraten, 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 Befehl dumpbin.exe /headers , um die Dateiheader zu speichern und auf fehlerhafte 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 diese Schritte aus, und weisen Sie die entsprechenden Rollen im Microsoft Store für Unternehmen.

Abgelaufenes Zertifikat

  • Verwenden Sie einen Zeitstempel, wenn Sie Ihr Paket signieren.
  • Sie können ein gültiges Signatur- oder Zeitstempelzertifikat verwenden.

Sie können Ihre App mithilfe des Skripts für die Batchkonvertierung erstellen.

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 sowohl auf dem lokalen Client als auch auf dem Remoteserver ausgeführt werden.

Häufige Probleme

MakePri-/Manifestübersetzungsfehler

Dieser Fehler tritt auf, wenn ein Problem mit dem Paketmanifest vor liegt. 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 datei, die derzeit verwendet wird. Beachten Sie, dass sie keinen Fehler erhalten File not Found , wenn sie geöffnet ist. Stattdessen erhalten Sie einen - oder File in Use -Access DeniedFehler.

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