Bekannte Probleme und Hinweise zur Problembehandlung für das MSIX-VerpackungstoolKnown issues and troubleshooting tips for the MSIX Packaging Tool

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.This article describes known issues and provides troubleshooting tips to consider when converting your apps to MSIX using the MSIX Packaging Tool. Sehen Sie sich unsere anderen Dokumente an, wenn Sie das msix-Paketierungs Tool oder den Treiber in einer getrennten Umgebungerwerben müssen.Check out our other docs if you need to acquire the MSIX Packaging Tool or driver in a disconnected environments.

Bekannte ProblemeKnown issues

Holen Sie sich den neuesten Insider Preview-Build des msix-pakettoolsGetting the latest Insider Preview build of the MSIX Packaging Tool

Wenn Sie sich für unser Insider- Programmangemeldet haben, stellen Sie sicher, dass Sie über die richtige Version des msix-pakettools verfügen:If you have opted in to our Insider Program, make sure you have the correct version of the MSIX Packaging Tool:

  • Wechseln Sie in das msix-pakettool zum Abschnitt Info , um die Version anzuzeigen, auf der Sie sich befinden.Go to the About section in the MSIX Packaging Tool to view which version you are on.
  • Klicken Sie hier , um die neueste Insider Vorschauversion zu ermitteln, und vergewissern Sie sich, dass diese Version des msix-pakettools installiert ist.Go here to determine the latest Insider Preview version, and confirm you have that version of the MSIX Packaging Tool installed.
  • Stellen Sie sicher, dass es sich bei der MSA, die für das flighting registriert ist, um das Konto handelt, das beim Microsoft Store angemeldet ist.Make sure the MSA that's signed up for flighting is the account that is signed into the Microsoft Store.
  • Aktualisieren Sie das msix-pakettool manuell über den Microsoft Store auf Ihrem Computer.Manually update the MSIX Packaging Tool through the Microsoft Store on your computer. Wenn diese Option für Sie verfügbar ist, öffnen Sie den Store, wechseln Sie zu Downloads und Updates, und klicken Sie dann auf Updates erhalten.If this option if available to you, open the Store, go to Downloads and updates, and click Get updates. Alternativ dazu können Sie auch nach dem msix-Paketierungs Tool suchen und auf der Produktseite zur Eingabe eines Updates auffordern.Alternatively, search for the MSIX Packaging Tool, and on the product page you can then prompt it for an update.
  • Um das msix-pakettool für die Offline Verwendung zu installieren, befolgen Sie diese Anweisungen , um sicherzustellen, dass Sie die neueste App über unseren Offline Prozess erhalten.To install the MSIX Packaging Tool for offline use, follow these instructions to ensure you get the latest app through our offline process.

Wenn Sie an unserem Insider-Programm interessiert sind, klicken Sie hier.If you are interested in joining our Insider Program, click here.

Msix-pakettool-TreiberMSIX Packaging Tool driver

Der Treiber für den msix-Verpackungs Tool wird als FOD-Paket (Feature on Demand) von Windows Update bereitgestellt.The MSIX Packaging Tool driver is delivered as a Feature on Demand (FOD) package from Windows Update. Die Installation kann nicht ausgeführt werden, wenn der Windows Update-Dienst auf dem Computer deaktiviert ist oder wenn die Windows Insider-Flug Ring Einstellungen nicht mit dem Betriebssystem Build des Computers identisch sind.It will fail to install if the Windows Update service is disabled on the computer or if Windows Insider flight ring settings do not match the OS build of the computer.

Wenn beim Erwerb des Treibers Probleme auftreten oder Sie in einer Offline Umgebung arbeiten, finden Sie hierLinks zum Herunterladen des Treibers.If you are running into problems acquiring the driver, or you are working in an offline environment, you can find links to download the driver here.

Wenn Sie den Treiber heruntergeladen haben und während der Paket Konvertierung Probleme auftreten, kann dies eines der folgenden Probleme sein.If you have downloaded the driver and are running into issues during your package conversion, it may be one of the following issues.

Probleme mit der NetzwerkkonnektivitätNetwork connectivity issues

Die folgenden Fehlercodes können darauf hindeuten, dass Verbindungsprobleme aufgetreten sind:The following error codes might indicate that you are encountering connection issues:

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

Windows Server Update Service (WSUS), Configuration Manager oder Gruppenrichtlinien, die sich auf Windows Update Konnektivität auswirkenWindows Server Update Service (WSUS), Configuration Manager, or group policies affecting Windows Update connectivity

Der folgende Fehlercode weist möglicherweise darauf hin, dass die Richtlinien auf dem Computer Windows Update Konnektivität beeinflussen:-2145124306 (0x8024002e).The following error code may indicate that policies on your computer are be affecting Windows Update connectivity: -2145124306 (0x8024002e).

Wenn Sie diesen Fehlercode erhalten, müssen Sie möglicherweise die Umgebungseinstellungen und-Richtlinienüberprüfen.If you receive this error code, you may need to check your environment settings and policies.

Der Treiber erforderte eine Neuinstallation.Driver required a reinstall

In diesem Szenario benachrichtigt das msix-Paketierungs Tool Sie in der Fehlermeldung und protokolliert, dass der Treiber neu gestartet werden muss.In this scenario, the MSIX Packaging Tool will notify you in the error message and logs that your driver needs a restart. Starten Sie den Computer neu, und starten Sie die Konvertierung erneut, um dieses Problem zu beheben.Restart your computer and start your conversion again to fix this issue.

MindestversionMinimum version

Es gibt einige Features, die Sie beachten müssen, damit die Unterstützung der minimale-Version in Ihrem msix-Paket automatisch geändert wird.There are a few features to be aware of that automatically change the minimun version support in your MSIX Package.

Anforderungen an die Microsoft Store-Versionskontrolle erzwingenEnforce Microsoft store versioning requirements

Wenn Sie Ihr vorhandenes Installationsprogramm mit einer Version des msix-pakettools vor 1.2019.701.0konvertieren, hat das Tool Microsoft Store Versions Verwaltungsanforderungen für erzwungen oder ein anderes Tool zum Erstellen des Pakets verwendet, das die Mindestversion nicht auf 10.0.16299.0 (Windows 10, Version 1709) festgelegt hat.If you convert your existing installer using a version of the MSIX Packaging Tool earlier than 1.2019.701.0, the tool had Enforce Microsoft Store versioning requirements on, or used another tool to create your package that did not set the minimum version to 10.0.16299.0 (Windows 10, version 1709). Dies führt zu einer Fehlermeldung, wenn Sie Ihre APP für Windows 10, Version 1709 oder eine höhere Version bereitstellen.This will cause an error message when deploying your app to Windows 10, version 1709 or a later version.

Um dieses Problem zu beheben, öffnen Sie das msix-Verpackungs Tool , und bearbeiten Sie die APP über den Paket-Editor.To fix this issue, open the MSIX Packaging Tool and edit your app through Package Editor. Öffnen Sie das Manifest, und legen Sie das- MinVersion Attribut des- TargetDeviceFamily Elements auf "10.0.16299.0" fest.Open your manifest and set the MinVersion attribute of the TargetDeviceFamily element to "10.0.16299.0".

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

Msix mit DienstenMSIX with services

In Version 1.2019.1220.0 des msix-pakettools haben wir Unterstützung für das Erstellen eines msix-Pakets mit Dienstenhinzugefügt.In version 1.2019.1220.0 of the MSIX Packaging Tool, we added support for creating an MSIX package with Services. Aufgrund der Betriebssystem Einschränkungen bei der Dienst Unterstützung ändert das msix-Verpackungs Tool automatisch die in einem msix-Paket unterstützte Mindestversion mit Diensten in 10.0.19025.0.Due to the OS restrictions with services support, the MSIX Packaging Tool automatically changes the min version supported in an MSIX package with services to 10.0.19025.0. Dies bedeutet, dass Sie eine msix nicht mit Diensten unter Windows 10, Version 2004, mit einem Betriebssystem installieren können. Sie können diese msix jedoch mit dem msix-pakettool für Windows 10 1809 erstellen.This means that you cannot install an MSIX with services on an OS lower than the Windows 10 version 2004, but you can create that MSIX using the MSIX Packaging Tool down to Windows 10 1809. Wenn Sie diese APP unter einem niedrigeren Betriebssystem installieren müssen, aktualisieren Sie die minimale Version entsprechend, aber beachten Sie, dass die Unterstützung für Dienste nicht funktioniert.If you need to install this app on a lower OS, update the min version appropriately but note that support for services will not work.

Frameworks und TreiberFrameworks and drivers

Wenn die APP ein Framework erfordert, stellen Sie sicher, dass das Framework während der Überwachungsphase der Konvertierung installiert wird.If the app requires a framework, make sure the framework is installed during the monitoring phase of the conversion. Durchlaufen Sie die Protokolle, um sicherzustellen, dass dies geschieht.Go through the logs to ensure this is happening. Wenn Ihre APP einen Treiber für die Installation erfordert, müssen Sie auswerten, ob dies erforderlich ist, damit Ihre APP ordnungsgemäß ausgeführt wird.If your app requires a driver to install, you need to evaluate whether this is required for your app to run properly. Die Treiberinstallation wird von msix derzeit nicht unterstützt.MSIX currently does not support driver installation.

RemotecomputerRemote Machine

Wenn bei der Verwendung einer Remote-VM für Ihre Konvertierungen Probleme auftreten, finden Sie weitere Informationen unter Setup Anweisungen für Remote Computer Konvertierungen.If you are running into issues with using a remote VM for your conversions, see Setup instructions for remote machine conversions.

Probleme während der KonvertierungIssues during conversion

  • Bei einigen Installationsprogrammen treten bei der Konvertierung möglicherweise Fehler mit dem Exitcode 259 auf.Some installers might fail to convert with exit code 259. Dies bedeutet, dass das Installationsprogramm einen Thread erzeugt und nicht auf dessen Abschluss wartet.This indicates that the installer spawned a thread and did not wait for it to complete. 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.In other words, the main thread finished installing but it exited with error 259 because it spawned a thread that is still running. Es wird empfohlen, die entsprechende Installationsoption für „setup.exe“ zu verwenden.We recommend that you use the appropriate install option for setup.exe.

Probleme beim SignierenIssues during signing

Ungültiges PE-Zertifikat (0x800700C1)Bad PE certificate (0x800700C1)

Dieses Problem tritt auf, wenn das Paket eine Binärdatei mit einem beschädigten Zertifikat enthält.This problem occurs when the package contains a binary file that has a corrupt certificate. Um dieses Problem zu beheben, verwenden dumpbin.exe /headers Sie den-Befehl, um die Dateiheader zu sichern und auf fehlerhafte Elemente zu überprüfen.To resolve this issue, use the dumpbin.exe /headers command to dump the file headers and inspect for bad elements. Schreiben Sie die Header manuell neu, um das Problem zu beheben.Manually rewrite the headers to fix the issue. Im Allgemeinen erkennt das msix-Paketierungs Tool automatisch ungültige Header.In general, the MSIX Packaging tool automatically detects bad headers. Wenn dieses Problem weiterhin besteht, senden Sie ein Feedback.If this issue persists, file feedback. Weitere Informationen finden Sie hier.More information can be found here.

Device Guard-SignaturDevice Guard signing

Stellen Sie sicher, dass Sie die folgenden Schritte ausführen und dass Sie die entsprechenden Rollen im Microsoft Store für Unternehmen zuweisen.Make sure to follow these steps and that you are assigning the appropriate roles in the Microsoft Store for Business.

Abgelaufenes ZertifikatExpired certificate

  • Verwenden Sie beim Signieren des Pakets einen Zeitstempel.Use a timestamp when you sign your package.
  • Sie können mit einem gültigen Signierungs-oder Zeitstempel-Zertifikat zurücksetzen.You can resign with a valid sign or timestamp certificate.

Sie können Ihre App mithilfe des Batch Konvertierungs Skriptszurücksetzen.You can resign your app using the batch conversion script.

ProblembehandlungTroubleshooting

ProtokolldateienLog files

Unabhängig davon, ob eine Konvertierung erfolgreich durchgeführt wurde, werden für jede Konvertierung Protokolldateien generiert.Whether or not your conversion was successful, log files are generated for every conversion. Diese befinden sich unter folgendem Verzeichnis:They can be found here:

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

Fehlercodes werden protokolliert und geben alle Fehlerquellen während des Konvertierungsvorgangs an.Failure codes are written and indicate any point of failure during the conversion process. Die Fehlercodes sollen benutzerfreundlich sein.The error codes are meant to be user friendly.

Protokolldateien von Remotegeräten oder virtuellen ComputernLog files from remote devices or VMs

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.If the conversion is performed on a remote device or a VM, we recommend that you copy the log files from that device and attach them as part of the feedback item. Dadurch können wir Probleme effizienter diagnostizieren und beheben.This will help us diagnose and resolve issues more efficiently.

Die Protokolle von Remotekonvertierungen finden Sie unter folgendem Verzeichnis: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txtYou will find the logs from the remote conversions here: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Dies wäre noch nützlicher, wenn Sie den gesamten Ordner "Logs" freigeben können, in dem auch die Vorgänge auf dem lokalen Client und dem Remote Server enthalten sind.It would even more beneficial if you can share the whole Logs folder that will include the operations occurring on the local client as well the remote server.

Häufige ProblemeCommon problems

Makepri/Manifest-ÜbersetzungsfehlerMakePri/Manifest translation errors

Dieser Fehler tritt auf, wenn ein Problem mit dem Paket Manifest vorliegt.This error occurs when there is an issue with the package’s manifest. Um das Problem zu identifizieren, wechseln Sie zum Paket-Editor, und öffnen Sie das Manifest.To identify the issue, go to Package Editor and open the manifest. Wenn Sie das Manifest öffnen, können Sie das Problem identifizieren und die richtige Lösung bereitstellen.When you open the manifest, you can identify the issue and provide the proper fix.

Datei nicht gefundenFile not found

Die Datei ist möglicherweise entweder geöffnet oder nicht vorhanden.The file may either be open or non-existent. Um dieses Problem zu beheben, fügen Sie die entsprechende Datei hinzu, oder schließen Sie die Datei, die zurzeit verwendet wird.To resolve this issue, add the appropriate file or close the file that is currently in use. Beachten Sie, dass Sie keinen Fehler erhalten, File not Found Wenn er geöffnet ist.Note that you will not get a File not Found error if it is open. Stattdessen erhalten Sie einen Fehler vom Access Denied File in Use Typ oder.Instead, you’ll get an Access Denied or File in Use error.

DateitypzuordnungenFile Type Associations

Die Probleme im Zusammenhang mit Dateityp Zuordnungen (FTA) variieren je nach Paket.The issues regarding File Type Associations (FTA) vary from package to package. Das msix-Paketierungs Tool unterstützt Dateizuordnungen für Doppelklick Installationen.MSIX Packaging Tool support file associations for double click installs. Wenn Ihre APP z. b. über ein Kontextmenü verfügt, wird Sie nicht automatisch hinzugefügt. Daher müssen Sie Sie manuell dem Manifest hinzufügen.For example, if your app has context menu, it is not automatically added, so you will need to add it manually to the manifest. Ein Beispiel finden Sie unter dem Manifest-Element desktop4: fileexplorercontextmenus .See the desktop4:FileExplorerContextMenus manifest element for an example.

Verknüpfungen mit ArgumentenShortcuts with arguments

Verknüpfungen mit Argumenten werden bei msix derzeit nicht unterstützt.Shortcuts with arguments are not currently supported with MSIX. Wenn Sie feststellen, dass das Installationsprogramm diese enthält, erstellt msix eine Kachel ohne Argumente.If we detect that the installer includes these, MSIX will create a tile with no arguments.

InstallationsverzeichnisInstall directory

Dies ist häufiger bei Benutzern, die ein sekundäres Laufwerk zum Durchführen von App-Konvertierungen verwenden.This is more common for those who use a secondary drive to perform app conversions. Wenn Sie sich dafür entscheiden, den Installationspfad zu ändern, ändert sich der Stamm von, wo alle Dateien laufen.If you choose to change the installation location, it changes the root of where all of the files go. Dies bedeutet, dass das msix-Paketierungs Tool wissen muss, wo alle diese Dateien bei der Konvertierung aufgezeichnet werden.This means that the MSIX Packaging tool will need to know where all these files go and will be captured during conversion.

Sie können dieses Problem beheben, indem Sie das Paket Unterstützungs Framework schreiben, um das Verzeichnis zu installieren.You can fix this by using the Package Support Framework write to install directory fix. Diese Funktion wurde im msix-Tool standardmäßig als Funktion hinzugefügt, die dies auf 1809 ermöglicht.We have added this as a capability by default in the MSIX Tool, which allows this down to 1809. Wenn Ihre Anwendung in 1709 nicht funktioniert und in 1809 ist, ist dies wahrscheinlich das Problem.If your application isn't working in 1709 and is in 1809, this is likely the issue.

Senden von FeedbackSending feedback

Die beste Möglichkeit, Ihr Feedback zu senden, ist über den Feedback-Hub.The best way to send your feedback is through the Feedback Hub.

  1. Öffnen Sie Feedback-Hub, oder drücken Sie Windows + F.Open Feedback Hub or type Windows + F.
  2. Geben Sie einen Titel und die erforderlichen Schritte zum Reproduzieren des Problems an.Provide a title and necessary steps to reproduce the issue.
  3. Wählen Sie unter Kategorie die Option Apps und dann MSIX Packaging Tool aus.Under Category, select Apps and select MSIX Packaging Tool.
  4. Fügen Sie alle mit der Konvertierung verbundenen Protokolldateien an.Attach any log files associated to the conversion. Die Protokolle finden Sie im oben angegebenen Ordner.You can find the logs in the folder provided above.
  5. Fügen Sie das konvertierte MSIX-Paket an (sofern möglich).Attach the converted MSIX package (if possible).
  6. Klicken Sie auf Submit(Senden).Click Submit.

Sie können uns auch Feedback direkt über das MSIX Packaging Tool senden, indem Sie unter Einstellungen zur Registerkarte Feedback navigieren.You can also send us feedback directly from the MSIX Packaging Tool by going to the Feedback tab under Settings.

Hinweis

Es kann 24 Stunden dauern, bis Ihr Feedback an uns übermittelt wird.It may take 24 hours for your feedback to get to us. 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.Therefore if you are using a VM to convert your package, you may want to keep your VM on and in its current state for 24 hours after conversion. Außerdem können Sie Konvertierungs Protokolle manuell an das Feedback anfügen.Also, you can manually attach conversion logs to the feedback.