Verpacken Sie eine desktop-Anwendung mit dem Desktop App ConverterPackage a desktop application using the Desktop App Converter

Laden Sie Desktop App Converter herunterGet the Desktop App Converter

Desktop App Converter (DAC) erstellt Pakete für desktop-Apps für die Integration mit den neuesten Windows-Funktionen, einschließlich der Verteilung und Wartung über den Microsoft Store.The Desktop App Converter (DAC) creates packages for desktop applications to integrate with the latest Windows features, including distribution and servicing via the Microsoft Store. Dazu zählen Win32-Apps und Apps, die Sie mithilfe von .NET 4.6.1 erstellt haben.This includes Win32 apps and apps that you've created by using .NET 4.6.1.

DAC-Symbol

Obwohl der Begriff „Konverter“ im Namen dieses Tool auftaucht, wird nicht tatsächlich konvertiert.While the term "Converter" appears in the name of this tool, it doesn't actually convert your app. Ihre Anwendung bleibt unverändert.Your application remains unchanged. Das Tool generiert jedoch ein Windows-App-Paket mit eine Paketidentität. Es bietet die Möglichkeit, viele WinRT-APIs aufzurufen.However, this tool generates a Windows app package with a package identity and the ability to call a vast range of WinRT APIs.

Sie können dieses Paket mithilfe des Add-AppxPackage-PowerShell-Cmdlets auf Ihrem Entwicklungscomputer installieren.You can install that package by using the Add-AppxPackage PowerShell cmdlet on your development machine.

Der Konverter führt den Desktop-Installer in einer isolierten Windows-Umgebung mit einem sauberen Basisimage als Teil des Konverterdownloads aus.The converter runs the desktop installer in an isolated Windows environment by using a clean base image provided as part of the converter download. Es werden alle Registrierungs- und Dateisystem-E/A des Desktop-Installers erfasst und als Teil der Ausgabe gepackt.It captures any registry and file system I/O made by the desktop installer and packages it as part of the output.

Wichtig

Die Fähigkeit zum Erstellen eines Windows-app-Pakets für Ihre desktop-Anwendung (auch bekannt als der Desktop-Brücke) wurde in Windows 10, Version 1607, eingeführt und kann nur in Projekten für die Windows 10 Anniversary Update (10.0; verwendet werden Build 14393) oder einer neueren Version in Visual Studio.The ability to create a Windows app package for your desktop application (otherwise known as the Desktop Bridge) was introduced in Windows 10, version 1607, and it can only be used in projects that target Windows 10 Anniversary Update (10.0; Build 14393) or a later release in Visual Studio.

Hinweis

Sehen Sie sich diese Reihe von kurzen Videos an, die von der Microsoft Virtual Academy veröffentlicht wurden.Checkout this series of short videos published by the Microsoft Virtual Academy. Diese Videos erläutern einige gängige Verwendungsmethoden des Desktop App Converters.These videos walk you through some common ways to use the Desktop App Converter.

Das DAC macht mehr als nur ein Paket zu generieren.The DAC does more than just generate a package for you

Hier sind einige zusätzliche Aufgaben, die er für Sie erledigen kann.Here's a few extra things it can do for you.

Windows10 Creators UpdateWindows 10 Creators Update

✔️ Automatisches Registrieren Ihrer Preview-Handler, Miniaturansichthandler, Eigenschaftenhandler, Firewall-Regeln, URL-Kennzeichen.✔️ Automatically register your preview handlers, thumbnail handlers, property handlers, firewall rules, URL flags.

✔️ Automatisches Registrieren Ihrer Dateizuordnungen, mit denen Benutzer Dateien mithilfe der Art-Spalte im Datei-Explorer gruppieren können.✔️ Automatically register file type mappings that enable users to group files by using the Kind column in File Explorer.

✔️ Registrieren Ihrer öffentlichen COM-Server.✔️ Register your public COM servers.

Windows 10 Anniversary Update oder höherWindows 10 Anniversary Update or later

✔️ Automatisches Signieren Ihres Pakets, damit Sie Ihre App testen können.✔️ Automatically sign your package so that you can test your app.

: Heavy_check_mark: Überprüfen Sie Ihre Anwendung mit app-Paket und Microsoft Store-Anforderungen.✔️ Validate your application against packaged app and Microsoft Store requirements.

Eine vollständige Liste der Optionen finden Sie unter dem Abschnitt Parameter dieses Handbuchs.To find a complete list of options, see the Parameters section of this guide.

Wenn Sie für die Erstellung des Pakets bereit sind, lassen Sie uns starten.If you're ready to create your package, let's start.

Vorbereiten Ihrer AnwendungFirst, prepare your application

Lesen Sie dieses Handbuch, bevor Sie mit der paketerstellung für Ihre Anwendung beginnen: Vorbereiten eine desktop-Anwendung zu verpacken.Review this guide before you begin creating a package for your application: Prepare to package a desktop application.

Stellen Sie sicher, dass das System den Konverter ausführen kann.Make sure that your system can run the converter

Stellen Sie sicher, dass das System die folgenden Anforderungen erfüllt:Make sure that your system meets the following requirements:

Starten Sie den Desktop App Converter.Start the Desktop App Converter

  1. Laden und Installieren Sie den Desktop App Converter.Download and install the Desktop App Converter.

  2. Führen Sie den Desktop App Converter als Administrator aus.Run the Desktop App Converter as an administrator.

    Führen Sie DAC als Administrator aus.

    Ein Konsolenfenster wird angezeigt.A console window appears. Sie werden dieses Konsolenfenster verwenden, um Befehle auszuführen.You'll use that console window to run commands.

Richten Sie ein paar Dinge ein (nur Apps mit Installer)Set a few things up (apps with installers only)

Sie können diesen mit dem nächsten Abschnitt überspringen, wenn Ihre Anwendung kein Installationsprogramm besitzen.You can skip ahead to the next section if your application doesn't have an installer.

  1. Identifizieren Sie die Version Ihres Betriebssystems.Identify the version number of your operating system.

    Geben Sie dazu Winver in das Dialogfeld Ausführen ein, und wählen Sie dann die Schaltfläche OK aus.To do that, type winver in the Run dialog box, and then choose the OK button.

    winver

    Sie finden die Version des Windows-Builds im Dialogfeld Informationen zu Windows.You'll find the version of your Windows build in the About Windows dialog box.

    Windows10-Version

  2. Laden Sie das entsprechende Desktop-App-Konverter-Basisimage.Download the appropriate Desktop app Converter base image.

    Stellen Sie sicher, dass die Versionsnummer, die im Namen der Datei angezeigt wird, der Versionsnummer des Windows-Builds entspricht.Make sure that the version number that appears in the name of the file matches the version number of your Windows build.

    Wichtig

    Wenn Sie Build-Nummer 15063 verwenden, und die Nebenversion dieser Build größer als oder gleich .483 ist (z.B.: 15063.540), stellen Sie sicher, dass Sie die Datei BaseImage 15063 UPDATE.wim herunterladen.If you're using build number 15063, and the minor version of that build is equal to or greater than .483 (For example: 15063.540), make sure to download the BaseImage-15063-UPDATE.wim file. Wenn die Nebenversion dieser Build kleiner als .483 ist, laden Sie die Datei BaseImage-15063.wim herunter.If the minor version of that build is less than .483, download the BaseImage-15063.wim file. Wenn Sie bereits eine inkompatible Version dieser Basisdatei haben, können Sie das Problem beheben.If you've already setup an incompatible version of this base file, you can fix it. In diesem Blogbeitrag wird erläutert, wie das geht.This blog post explains how to do that.

  3. Platzieren Sie die heruntergeladene Datei an einem beliebigen Speicherort auf Ihrem Computer, wo Sie sie später wieder finden werden.Place the downloaded file anywhere on your computer where you'll be able to find it later.

  4. Führen Sie im Konsolenfenster, das beim Starten des Desktop App Converters angezeigt wird, folgenden Befehl aus: Set-ExecutionPolicy bypass.In the console window that appeared when you started the Desktop App Converter, run this command: Set-ExecutionPolicy bypass.

  5. Richten Sie den Konverter durch Ausführen dieses Befehls ein: DesktopAppConverter.exe -Setup -BaseImage .\BaseImage-1XXXX.wim -Verbose.Set up the converter by running this command: DesktopAppConverter.exe -Setup -BaseImage .\BaseImage-1XXXX.wim -Verbose.
  6. Starten Sie den Computer neu, wenn Sie dazu aufgefordert werden.Restart your computer if you're prompted to do so.

    Statusbenachrichtigungen werden beim Erweitern des Basisimage durch den Konverter im Konsolenfenster angezeigt.Status messages appear in the console window as the converter expands the base image. Wenn Ihnen keine Statusbenachrichtigungen angezeigt werden, drücken Sie eine beliebige Taste.If you don't see any status messages, press any key. Dadurch kann der Inhalt des Konsolenfensters aktualisiert werden.This can cause the contents of the console window to refresh.

    Statusbenachrichtigungen in der Konsole

    Wenn das Basisimage vollständig erweitert wurde, fahren Sie mit dem nächsten Abschnitt fort.When the base image is fully expanded, move to the next section.

Verpacken einer AppPackage an app

Um Ihre App zu verpacken, führen Sie den DesktopAppConverter.exe-Befehl im Konsolenfenster aus, das beim Starten des Desktop App Converters geöffnet wird.To Package your app, run the DesktopAppConverter.exe command in the console window that opened when you started the Desktop App Converter.

Sie müssen den Paketnamen, Herausgeber und Versionsnummer der Anwendung mithilfe von Parameter angeben.You'll specify the package name, publisher and version number of the application by using parameters.

Hinweis

Wenn Sie den Namen Ihrer app im Microsoft Store reserviert haben, können Sie den Namen des Pakets und Herausgeber abrufen, mit Partner Center.If you've reserved your app name in the Microsoft Store, you can obtain the package and publisher names by using Partner Center. Wenn Sie Ihre App auf andere Systeme querladen möchten, können Sie für diese Ihre eigenen Namen bereitstellen, sofern der von Ihnen gewählte Name des Herausgebers mit dem Namen des Zertifikats übereinstimmt, das Sie zum Signieren Ihrer App verwenden.If you plan to sideload your app onto other systems, you can provide your own names for these as long as the publisher name that you choose matches the name on the certificate you use to sign your app.

Ein kurzer Überblick der BefehlsparameterA quick look at command parameters

Hier sind die benötigten Parameter.Here are the required parameters.

DesktopAppConverter.exe
-Installer <String>
-Destination <String>
-PackageName <String>
-Publisher <String>
-Version <Version>

Sie erhalten Informationen über jeden Parameter hier.You can read about each one here.

BeispieleExamples

Nachfolgend finden Sie einige gängige Methoden zum Verpacken Ihrer App.Here's a few common ways to package your app.

Verpacken einer Anwendungs mit einer (.msi) Installer-DateiPackage an application that has an installer (.msi) file

Weisen Sie auf die Installer-Datei mithilfe der Installer-Parameter.Point to the installer file by using the Installer parameter.

DesktopAppConverter.exe -Installer C:\Installer\MyAppSetup.msi -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1

Wichtig

Hierbei sind zwei wichtige Dinge zu beachten.There are two important things to keep in mind here. Stellen Sie zunächst sicher, dass sich das Installationsprogramm in einem unabhängigen Ordner befindet und nur mit dem Installer verbundene Dateien im selben Ordner sind.First, make sure that your installer is located in an independent folder and that only files related to that installer are in the same folder. Der Konverter kopiert den Inhalt dieses Ordners in die isolierte Windows-Umgebung.The converter copies all of the contents of that folder to the isolated Windows environment.
Zweitens stellen Sie Partner Center eine Identität des Pakets zuweist, die mit einer Zahl beginnt, sicher, dass Sie auch die AppId - Parameter übergeben, und nur das zeichenfolgensuffix (nach dem Punkt-Trennzeichen) als Wert dieses Parameters verwenden.Secondly, if Partner Center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

VideoVideo

Wenn der Installer Installationsprogramme für abhängige Bibliotheken oder Frameworks enthält, müssen Sie möglicherweise bei der Organisation etwas anders vorgehen.If your installer includes installers for dependent libraries or frameworks, you might have to organize things a bit a differently. Weitere Informationen finden Sie unter Verketten mehrerer Installer mit der Desktop-Brücke.See Chaining multiple installers with the Desktop Bridge.

Packen einer Anwendung, die eine ausführbare Setup-Datei hatPackage an application that has a setup executable file

Weisen Sie auf die ausführbare Setup-Datei mithilfe der Installer-Parameter.Point to the setup executable by using the Installer parameter.

DesktopAppConverter.exe -Installer C:\Installer\MyAppSetup.exe -InstallerArguments "/S" -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1

Wichtig

Wenn Partner Center eine Identität des Pakets, die mit einer Zahl beginnt zuweist, stellen Sie sicher, dass Sie auch die AppId - Parameter übergeben, und nur das zeichenfolgensuffix (nach dem Punkt-Trennzeichen) als Wert dieses Parameters verwenden.If Partner Center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

Die InstallerArguments-Parameter ist optional.The InstallerArguments parameter is an optional parameter. Da der Desktop-App-Konverter im unbeaufsichtigten Modus ausführen des Installers benötigt, müssen Sie jedoch verwendet werden, wenn Ihre Anwendung automatische Flags im Hintergrund ausführen benötigt werden.However, because the Desktop App Converter needs your installer to run in unattended mode, you might have to use it if your application needs silent flags to run silently. Die /S-Flag ist eine sehr häufig verwendetes automatisches Kennzeichen. Das von Ihnen verwendete Kennzeichen unterscheidet sich jedoch möglicherweise je nach welcher Installer-Technologie Sie beim Erstellen der Setup-Datei verwendet haben.The /S flag is a very common silent flag, but the flag that you use might be different depending on which installer technology you used to create the setup file.

VideoVideo

Packen einer Anwendung, die kein Installationsprogramm besitztPackage an application that doesn't have an installer

In diesem Beispiel verwenden Sie die Installer Parameter, um in den Stammordner Ihrer Anwendung Dateien zu verweisen.In this example, use the Installer parameter to point to the root folder of your application files.

Verwenden Sie den AppExecutable-Parameter, um auf die ausführbare Datei Ihrer Apps zu verweisen.Use the AppExecutable parameter to point to your apps executable file.

DesktopAppConverter.exe -Installer C:\Installer\MyApp\ -AppExecutable MyApp.exe -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1

Wichtig

Wenn Partner Center eine Identität des Pakets, die mit einer Zahl beginnt zuweist, stellen Sie sicher, dass Sie auch die AppId - Parameter übergeben, und nur das zeichenfolgensuffix (nach dem Punkt-Trennzeichen) als Wert dieses Parameters verwenden.If Partner Center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

VideoVideo

Verpacken einer App, Signieren Sie die App und Ausführen von Validierungstests für das PaketPackage an app, sign the app, and run validation checks on the package

Dieses Beispiel ähnelt ersten es zeigt, wie Sie Ihre Anwendung für das lokale Testen signieren und Ihre Anwendung mit app-Paket und Microsoft Store-Anforderungen überprüfen können.This example is similar to first one except it shows how you can sign your application for local testing, and then validate your application against packaged app and Microsoft Store requirements.

DesktopAppConverter.exe -Installer C:\Installer\MyAppSetup.exe -InstallerArguments "/S" -Destination C:\Output\MyApp -PackageName "MyApp" -Publisher "CN=MyPublisher" -Version 0.0.0.1 -MakeAppx -Sign -Verbose -Verify

Wichtig

Wenn Partner Center eine Identität des Pakets, die mit einer Zahl beginnt zuweist, stellen Sie sicher, dass Sie auch die AppId - Parameter übergeben, und nur das zeichenfolgensuffix (nach dem Punkt-Trennzeichen) als Wert dieses Parameters verwenden.If Partner Center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.

Die Sign Parameter generiert ein Zertifikat, und klicken Sie dann signiert Ihre Anwendung mit.The Sign parameter generates a certificate and then signs your application with it. Sie müssen das erstellte Zertifikat installieren, um Ihre App ausführen zu können.To run your app, you'll have to install that generated certificate. Weitere Informationen hierzu finden Sie unter dem Abschnitt Ausführung der verpackten App dieses Handbuchs.To learn how, see the Run the packaged app section of this guide.

Sie können überprüfen Sie Anwendung mithilfe der Verify Parameter.You can validate you application by using the Verify parameter.

Einen kurzen Überblick über optionale ParameterA quick look at optional parameters

Die Sign- und Verify-Parameter sind optional.The Sign and Verify parameters are optional. Es gibt viele weitere optionale Parameter.There are many more optional parameters. Hier sind einige der am häufigsten verwendeten optionalen Parameter.Here are some of the more commonly used optional parameters.

[-ExpandedBaseImage <String>]
[-AppExecutable <String>]
[-AppFileTypes <String>]
[-AppId <String>]
[-AppDisplayName <String>]
[-AppDescription <String>]
[-PackageDisplayName <String>]
[-PackagePublisherDisplayName <String>]
[-MakeAppx]
[-LogFile <String>]
[<CommonParameters>]

Sie können mehr über all diese Parameter in den nächsten Abschnitterfahren.You can read about all of them in the next section.

ParameterverweisParameter Reference

Hier ist die vollständige Liste der Parameter (nach Kategorie sortiert), die Sie beim Ausführen des Desktop App Converters verwenden können.Here's the complete list of parameters (organized by category) that you can use when you run the Desktop App Converter.

Sie können auch die gesamte Liste anzeigen, indem Sie den Get-Help-Befehl in der Konsolenfenster-App ausführen.You can also view the entire list by running the Get-Help command in the app console window.

SetupparameterSetup parameters
-Setup [<SwitchParameter>]-Setup [<SwitchParameter>] ErforderlichRequired Führt DesktopAppConverter im Setupmodus aus.Runs DesktopAppConverter in setup mode. Setupmodus unterstützt die Erweiterung eines bereitgestellten Basisimages.Setup mode supports expanding a provided base image.
-BaseImage <String>-BaseImage <String> ErforderlichRequired Vollständiger Pfad zu einem nicht erweiterten Basisimage.Full path to an unexpanded base image. Dieser Parameter ist erforderlich, wenn -Setup angegeben wurde.This parameter is required if -Setup is specified.
-LogFile <String>-LogFile <String> OptionalOptional Gibt eine Protokolldatei an.Specifies a log file. Wird dieser nicht angegeben, wird ein temporärer Speicherort für eine Protokolldatei erstellt.If omitted, a log file temporary location will be created.
-NatSubnetPrefix <String>-NatSubnetPrefix <String> OptionalOptional Präfixwert, der für die Nat-Instanz verwendet wird.Prefix value to be used for the Nat instance. In der Regel möchten Sie diesen nur ändern, wenn der Hostcomputer an den gleichen Subnetzbereich wie NetNat des Konverters angefügt ist.Typically, you would want to change this only if your host machine is attached to the same subnet range as the converter's NetNat. Sie können die aktuelle NetNat-Konfiguration des Konverters mithilfe des Get-NetNat-Cmdlets abrufen.You can query the current converter NetNat config by using the Get-NetNat cmdlet.
-NoRestart [<SwitchParameter>]-NoRestart [<SwitchParameter>] ErforderlichRequired Keine Aufforderung zum Neustart, wenn Sie das Setupprogramm ausführen (Neustart ist erforderlich, um das Container-Feature zu aktivieren).Don't prompt for reboot when running setup (reboot is required to enable the container feature).
KonvertierungsparameterConversion parameters
-AppInstallPath <String>-AppInstallPath <String> OptionalOptional Der vollständige Pfad zum Stammordner Ihrer Anwendung für die installierten Dateien, wenn sie installiert wurde (z.B. „C:\Programme (x86) \MyApp“).The full path to your application's root folder for the installed files if it were installed (e.g., "C:\Program Files (x86)\MyApp").
-Destination <String>-Destination <String> ErforderlichRequired Das gewünschte Ziel für die APPX-Ausgabe des Konverters. DesktopAppConverter kann diesen Speicherort erstellen, wenn er nicht bereits vorhanden ist.The desired destination for the converter's appx output - DesktopAppConverter can create this location if it doesn't already exist.
-Installer <String>-Installer <String> ErforderlichRequired Der Pfad zum Installationsprogramm für Ihre Anwendung. Muss im unbeaufsichtigten Modus bzw. automatisch ausgeführt werden können.The path to the installer for your application - must be able to run unattended/silently. Konvertierung ohne Installationsprogramm, ist dies der Pfad zum Stammverzeichnis der Anwendungsdateien.No-installer conversion, this is the path to the root directory of your application files.
-InstallerArguments <String>-InstallerArguments <String> OptionalOptional Eine durch Trennzeichen getrennte Liste oder Zeichenfolge mit Argumenten, die das unbeaufsichtigte bzw. automatische Ausführen des Installers erzwingen.A comma-separated list or string of arguments to force your installer to run unattended/silently. Dieser Parameter ist optional, wenn der Installer eine MSI-Datei ist.This parameter is optional if your installer is an msi. Geben Sie zum Abrufen eines Protokolls vom Installer hier das Argument für die Protokollierung an, und verwenden Sie den Pfad <log_folder>, ein Token, das vom Konverter mit dem entsprechenden Pfad ersetzt wird.To get a log from your installer, supply the logging argument for the installer here and use the path <log_folder>, which is a token that the converter replaces with the appropriate path.

Hinweis: Unbeaufsichtigte/automatische Flags und Protokollargumente können bei den verschiedenen Installationstechnologien variieren.NOTE: The unattended/silent flags and log arguments will vary between installer technologies.

Ein Verwendungsbeispiel für diesen Parameter: -InstallerArguments "/silent /log <log_folder>\install.log" Ein weiteres Beispiel, in dem keine Protokolldatei generiert wird, kann wie folgt aussehen: -InstallerArguments "/quiet", "/norestart" Alle Protokolle müssen auf den Tokenpfad <log_folder> verweisen, wenn der Konverter diese erfassen und im endgültigen Protokollordner speichern soll.An example usage for this parameter: -InstallerArguments "/silent /log <log_folder>\install.log" Another example that doesn't produce a log file may look like: -InstallerArguments "/quiet", "/norestart" Again, you must literally direct any logs to the token path <log_folder> if you want the converter to capture it and put it in the final log folder.
-InstallerValidExitCodes <Int32>-InstallerValidExitCodes <Int32> OptionalOptional Eine durch Trennzeichen getrennte Liste mit Exitcodes, die angeben, das der Installer erfolgreich ausgeführt wurde (z. B.: 0, 1234, 5678).A comma-separated list of exit codes that indicate your installer ran successfully (for example: 0, 1234, 5678). Standardmäßig ist dieser 0 für Nicht-MSI-Dateien und 0, 1641, 3010 für MSI-Dateien.By default this is 0 for non-msi, and 0, 1641, 3010 for msi.
-MakeAppx [<SwitchParameter>]-MakeAppx [<SwitchParameter>] OptionalOptional Ein Switch, mit dem, falls vorhanden, dieses Skript zum Aufrufen von MakeAppx für die Ausgabe angewiesen wird.A switch that, when present, tells this script to call MakeAppx on the output.
-MakeMSIX [<SwitchParameter>]-MakeMSIX [<SwitchParameter>] OptionalOptional Ein Switch, der wenn vorhanden, dieses Skript die Ausgabe als MSIX-Paket verpacken angewiesen.A switch that, when present, tells this script to package the output as an MSIX Package.
Paket-IdentitätsparameterPackage identity parameters
-PackageName <String>-PackageName <String> ErforderlichRequired Der Name des Universellen Windows-App-Pakets.The name of your Universal Windows App package. Wenn Partner Center eine Identität des Pakets, die mit einer Zahl beginnt zuweist, stellen Sie sicher, dass Sie auch die AppId - Parameter übergeben, und nur das zeichenfolgensuffix (nach dem Punkt-Trennzeichen) als Wert dieses Parameters verwenden.If Partner Center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.
-Publisher <String>-Publisher <String> ErforderlichRequired Der Herausgeber des Universellen Windows-App-PaketsThe publisher of your Universal Windows App package
-Version <Version>-Version <Version> ErforderlichRequired Die Versionsnummer für das Universelles Windows-App-PaketThe version number for your Universal Windows App package
Paketmanifest-ParameterPackage manifest parameters
-AppExecutable <String>-AppExecutable <String> OptionalOptional Der Name der ausführbaren Hauptdatei Ihrer Anwendung (z.B. „MyApp.exe“).The name of your application's main executable (eg "MyApp.exe"). Dieser Parameter ist bei der Konvertierung ohne Installationsprogramm erforderlich.This parameter is required for a no-installer conversion.
-AppFileTypes <String>-AppFileTypes <String> OptionalOptional Eine durch Trennzeichen getrennte Liste von Dateitypen, denen die Anwendung zugeordnet wird.A comma-separated list of file types which the application will be associated with. Beispiel: -AppFileTypes „'.md', '.markdown'“.Example usage: -AppFileTypes "'.md', '.markdown'".
-AppId <String>-AppId <String> OptionalOptional Legt einen Wert fest, auf den die Anwendungs-ID im Windows-App-Paket-Manifest festgelegt wird.Specifies a value to set Application Id to in the Windows app package manifest. Wird kein Wert angegeben, wird diese auf den für PackageName übergebenen Wert festgelegt.If it is not specified, it will be set to the value passed in for PackageName. In vielen Fällen ist der PackageName ausreichend.In many cases, using the PackageName is fine. Wenn Partner Center eine Identität des Pakets, die mit einer Zahl beginnt zuweist, stellen Sie jedoch sicher, dass Sie auch die AppId - Parameter übergeben, und nur das zeichenfolgensuffix (nach dem Punkt-Trennzeichen) als Wert dieses Parameters verwenden.However, if Partner Center assigns an identity to your package that begins with a number, make sure that you also pass in the -AppId parameter, and use only the string suffix (after the period separator) as the value of that parameter.
-AppDisplayName <String>-AppDisplayName <String> OptionalOptional Legt einen Wert fest, auf den der Anzeigename der Anwendung im Windows-App-Paket-Manifest festgelegt wird.Specifies a value to set Application Display Name to in the Windows app package manifest. Wird kein Wert angegeben, wird diese auf den für PackageName übergebenen Wert festgelegt.If it is not specified, it will be set to the value passed in for PackageName.
-AppDescription <String>-AppDescription <String> OptionalOptional Legt einen Wert fest, auf den die Anwendungsbeschreibung im Windows-App-Paket-Manifest festgelegt wird.Specifies a value to set Application Description to in the Windows app package manifest. Wird kein Wert angegeben, wird diese auf den für PackageName übergebenen Wert festgelegt.If it is not specified, it will be set to the value passed in for PackageName.
-PackageDisplayName <String>-PackageDisplayName <String> OptionalOptional Legt einen Wert fest, auf den der Anzeigename des Pakets im Windows-App-Paket-Manifest festgelegt wird.Specifies a value to set Package Display Name to in the Windows app package manifest. Wird kein Wert angegeben, wird diese auf den für PackageName übergebenen Wert festgelegt.If it is not specified, it will be set to the value passed in for PackageName.
-PackagePublisherDisplayName <String>-PackagePublisherDisplayName <String> OptionalOptional Legt einen Wert fest, auf den der Anzeigename des Paketherausgebers im Windows-App-Paket-Manifest festgelegt wird.Specifies a value to set Package Publisher Display Name to in the Windows app package manifest. Wird kein Wert angegeben, wird dieser auf den für Publisher übergebenen Wert festgelegt.If it is not specified, it will be set to the value passed in for Publisher.
BereinigungsparameterCleanup parameters
-Bereinigung [<Option>]-Cleanup [<Option>] ErforderlichRequired Führt Bereinigung für die DesktopAppConverter-Artefakte aus.Runs cleanup for the DesktopAppConverter artifacts. Es gibt 3 gültige Optionen für den Bereinigungsmodus.There are 3 valid options for the Cleanup mode.
-Alle Bereinigung-Cleanup All Löscht alle erweiterten Basisimages, entfernt alle temporären Konverterdateien, entfernt das Containernetzwerk und deaktiviert die optionale Windows-Funktion.Deletes all expanded base images, removes any temporary converter files, removes the container network, and disables the optional Windows feature, Containers.
-WorkDirectory Bereinigung-Cleanup WorkDirectory ErforderlichRequired Entfernt alle temporären Konverterdateien.Removes all the temporary converter files.
-ExpandedImage Bereinigung-Cleanup ExpandedImage ErforderlichRequired Löscht alle erweiterten Basisimages, die auf dem Hostcomputer installiert sind.Deletes all the expanded base images installed on your host machine.
PaketarchitekturparameterPackage architecture parameters
-PackageArch <String>-PackageArch <String> ErforderlichRequired Generiert ein Paket mit der angegebenen Architektur.Generates a package with the specified architecture. Gültige Optionen sind „x86“ und „x64“ (Beispiel: -PackageArch x86).Valid options are 'x86' or 'x64'; for example, -PackageArch x86. Dieser Parameter ist optional.This parameter is optional. Falls nicht angegeben, versucht der DesktopAppConverter die Paketarchitektur automatisch zu erkennen.If unspecified, the DesktopAppConverter will try to auto-detect package architecture. Wenn die automatische Erkennung fehlschlägt, wird standardmäßig ein x64-Paket erstellt.If auto-detection fails, it will default to x64 package.
Sonstige ParameterMiscellaneous parameters
-ExpandedBaseImage <String>-ExpandedBaseImage <String> OptionalOptional Vollständige Pfad zu einem bereits erweiterten Basisimage.Full path to an already expanded base image.
-LogFile <String>-LogFile <String> OptionalOptional Gibt eine Protokolldatei an.Specifies a log file. Wird dieser nicht angegeben, wird ein temporärer Speicherort für eine Protokolldatei erstellt.If omitted, a log file temporary location will be created.
– Zeichen [<SwitchParameter>]-Sign [<SwitchParameter>] OptionalOptional Weisen Sie diesen Skript an, das ausgehende Windows-App-Paket mit einem generierten Zertifikat für Testzwecke zu signieren.Tells this script to sign the output Windows app package by using a generated certificate for testing purposes. Dieser Switch sollte ebenso vorhanden sein, wie der Switch -MakeAppx.This switch should be present alongside the switch -MakeAppx.
<Allgemeine Parameter><Common parameters> ErforderlichRequired Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable.This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. Weitere Informationen finden Sie unter about_CommonParameters.For more info, see about_CommonParameters.
-Überprüfen [<SwitchParameter>]-Verify [<SwitchParameter>] OptionalOptional Ein Switch, der, das app-Paket auf app-Paket und Microsoft Store-Anforderungen überprüfen den DAC angewiesen wird.A switch that, when present, tells the DAC to validate the app package against packaged app and Microsoft Store requirements. Das Ergebnis ist ein Überprüfungsbericht „VerifyReport.xml“, der am besten in einem Browser angezeigt wird.The result is a validation report "VerifyReport.xml", which is best visualized in a browser. Dieser Switch sollte ebenso vorhanden sein, wie der Switch -MakeAppx.This switch should be present alongside the switch -MakeAppx.
-PublishComRegistrations-PublishComRegistrations OptionalOptional Scant alle Öffentlichen COM-Registrierungen, die von Ihrem Installer erstellt wurden, und veröffentlicht die gültigen in Ihrem Manifest.Scans all public COM registrations made by your installer and publishes the valid ones in your manifest. Verwenden Sie dieses Flag nur dann, wenn Sie diese Registrierungen für andere Anwendungen verfügbar machen möchten.Use this flag only if you want to make these registrations available to other applications. Sie müssen dieses Flag verwenden, wenn diese Registrierungen nur von Ihrer Anwendung verwendet werden.You don't need to use this flag if these registrations will be used only by your application.

Lesen Sie diesen Artikel, um sicherzustellen, dass die COM-Registrierungen nach der Verpackung Ihrer App erwartungsgemäß funktionieren.Review this article to make sure that your COM registrations behave as you expect after you package your app.

Ausführung der verpackten AppRun the packaged app

Es gibt zwei Möglichkeiten, Ihre App auszuführen.There's two ways to run your app.

Eine Möglichkeit besteht darin, eine PowerShell-Eingabeaufforderung zu öffnen, und den folgenden Befehl einzugeben: Add-AppxPackage –Register AppxManifest.xml.One way is to open a PowerShell command prompt, and then type this command: Add-AppxPackage –Register AppxManifest.xml. Es ist wahrscheinlich die einfachste Möglichkeit, Ihre Anwendung ausgeführt werden, da Sie nicht signieren müssen.It's probably the easiest way to run your application because you don't have to sign it.

Eine weitere Möglichkeit ist die Anwendung mit einem Zertifikat signieren.Another way is to sign your application with a certificate. Wenn Sie verwenden die sign Parameter, der Desktop App Converter eines für Sie generiert, und melden Sie sich dann Ihre Anwendung mit.If you use the sign parameter, the Desktop App Converter will generate one for you, and then sign your application with it. Diese Datei heißt auto-generated.cer; Sie finden sie im Stammordner der verpackten App.That file is named auto-generated.cer, and you can find it in the root folder of your packaged app.

Führen Sie die folgenden Schritte aus, um das generierte Zertifikat zu installieren, und führen Sie anschließend Ihre App aus.Follow these steps to install the generated certificate, and then run your app.

  1. Doppelklicken Sie auf die Datei auto-generated.cer, um das Zertifikat zu installieren.Double-click the auto-generated.cer file to install the certificate.

    Datei mit generiertem Zertifikat

    Hinweis

    Wenn Sie zur Eingabe eines Kennworts aufgefordert werden, verwenden Sie das Standardkennwort „123456”.If you're prompted for a password, use the default password "123456".

  2. Wählen Sie im Dialogfeld Zertifikat die Schaltfläche Zertifikat installieren aus.In the Certificate dialog box, choose the Install Certificate button.

  3. Installieren Sie das Zertifikat im Zertifikatimport-Assistenten auf dem lokalen Computer, und legen Sie das Zertifikat im Zertifikatspeicher Vertrauenswürdige Personen ab.In the Certificate Import Wizard, install the certificate onto the Local Machine, and place the certificate into the Trusted People certificate store.

    Speicher für vertrauenswürdige Personen

  4. Doppelklicken Sie im Stammordner der verpackten App auf die Windows-App-Paketdatei.In root folder of your packaged app, double click the Windows app package file.

    Windows-App-Paketdatei

  5. Installieren Sie die App, indem Sie die Schaltfläche Installieren auswählen.Install the app, by choosing the Install button.

    Schaltfläche „Installieren”

Ändern der verpackten AppModify the packaged app

Sie werden wahrscheinlich Änderungen an der verpackten Anwendung Fehler zu beheben, visuelle Ressourcen hinzuzufügen oder verbessern Sie Ihre Anwendung mit modernen Funktionen wie live-Kacheln.You'll likely make changes to your packaged application to address bugs, add visual assets, or enhance your application with modern experiences such as live tiles.

Wenn Sie die Änderungen vorgenommen haben, müssen Sie den Konverter nicht erneut ausführen.After you make your changes, you don't need to run the converter again. In den meisten Fällen Sie können Ihre Anwendung mithilfe des Tools makeappx und Umpacken die Datei "appxmanifest.xml" der DAC für Ihre app generiert.In most cases, you can just repackage your application by using the MakeAppx tool and the appxmanifest.xml file the DAC generates for your app. Weitere Informationen erhalten Sie unter Erstellen eines Windows-App-Pakets.See Generate a Windows app package.

Hinweis

Wenn Sie Änderungen an Registrierungseinstellungen vornehmen, die das Installationsprogramm festgelegt hat, müssen Sie den Desktop App Converter erneut ausführen, um diese Änderungen zu übernehmen.If you make changes to registry settings that your installer makes, you will have to run the Desktop App Converter again to pick up those changes.

VideosVideos

Ändern und Umpacken der AusgabeModify and repackage output Demo: Ändern und Umpacken der AusgabeDemo: Modify and repackage output

In den folgenden zwei Abschnitten beschrieben, verschiedene optionale Fixups für die Anwendung, die Sie in Erwägung ziehen können.The following two sections describe a couple of optional fix-ups to the packaged application that you might consider.

Löschen nicht benötigter Dateien und RegistrierungsschlüsselDelete unnecessary files and registry keys

Desktop App Converter verfolgt beim Herausfiltern von Dateien und Systemstörungen im Container einen sehr konservativen Ansatz.The desktop App Converter takes a very conservative approach to filtering out files and system noise in the container.

Wenn Sie möchten, können Sie den VFS-Ordner überprüfen und alle Dateien löschen, die der Installer nicht benötigt.If you want, you can review the VFS folder and delete any files that your installer doesn't need. Sie können auch den Inhalt von „Reg.dat“ überprüfen und alle Schlüssel löschen, die nicht von der App installiert/benötigt werden.You can also review the contents of Reg.dat and delete any keys that are not installed/needed by the app.

Korrigieren fehlerhafter PE-HeaderFix corrupted PE headers

Beim Konvertieren führt DesktopAppConverter automatisch PEHeaderCertFixTool aus, um alle beschädigten PE-Header zu korrigieren.During the conversion process, the DesktopAppConverter automatically runs the PEHeaderCertFixTool to fixup any corrupted PE headers. Sie können PEHeaderCertFixTool jedoch auch für ein UWP-Windows-App-Paket, lose Dateien oder eine bestimmte Binärdatei ausführen.However, you can also run the PEHeaderCertFixTool on a UWP Windows app package, loose files, or a specific binary. Beispiel:Here's an example.

PEHeaderCertFixTool.exe <binary file>|<.appx package>|<folder> [/c] [/v]
 /c   -- check for corrupted certificate but do not fix (optional)
 /v   -- verbose (optional)
example1: PEHeaderCertFixTool app.exe
example2: PEHeaderCertFixTool c:\package.appx /c
example3: PEHeaderCertFixTool c:\myapp /c /v

Telemetriedaten aus Desktop App ConverterTelemetry from Desktop App Converter

Desktop-App-Konverter erfasst ggf. Informationen über Sie und die Verwendung der Software, und sendet diese Informationen an Microsoft.Desktop App Converter may collect information about you and your use of the software and send this info to Microsoft. Weitere Informationen zur Sammlung von Daten und deren Verwendung von Microsoft finden Sie in der Produktdokumentation und in den Datenschutzbestimmungen von Microsoft.You can learn more about Microsoft's data collection and use in the product documentation and in the Microsoft Privacy Statement. Sie stimmen der Einhaltung aller geltenden Vorschriften der Datenschutzbestimmungen von Microsoft zu.You agree to comply with all applicable provisions of the Microsoft Privacy Statement.

Standardmäßig ist Telemetrie für den Desktop-App-Konverter aktiviert.By default, telemetry will be enabled for the Desktop App Converter. Fügen Sie den folgenden Registrierungsschlüssel hinzu, um Telemetrie entsprechend zu konfigurieren:Add the following registry key to configure telemetry to a desired setting:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\DesktopAppConverter
  • Fügen Sie den DisableTelemetry-Wert hinzu, oder bearbeiten Sie diesen, indem Sie DWORD auf 1 festlegen.Add or edit the DisableTelemetry value by using a DWORD set to 1.
  • Entfernen Sie zum Aktivieren von Telemetrie den Schlüssel, oder legen Sie den Wert auf 0 fest.To enable telemetry, remove the key or set the value to 0.

SprachunterstützungLanguage support

Desktop App Converter unterstützt Unicode nicht. Daher können keine chinesischen Zeichen oder Nicht-ASCII-Zeichen mit dem Tool verwendet werden.The Desktop App Converter does not support Unicode; thus, no Chinese characters or non-ASCII characters can be used with the tool.

Nächste SchritteNext steps

Finden Sie Antworten auf Ihre FragenFind answers to your questions

Haben Sie Fragen?Have questions? Fragen Sie uns auf Stack Overflow.Ask us on Stack Overflow. Unser Team überwacht diese Tags.Our team monitors these tags. Fragen Sie uns hier.You can also ask us here.

Sie können auch diese Liste bekannter Probleme durchsuchen.You can also refer to this list of known issues.

Geben Sie Feedback oder VerbesserungsvorschlägeGive feedback or make feature suggestions

Weitere Informationen finden Sie unter UserVoice.See UserVoice.

Führen Sie Ihre Anwendung / suchen und Beheben von ProblemenRun your application / find and fix issues

Finden Sie unter ausführen, Debuggen und testen eine verpackte desktop-AnwendungSee Run, debug, and test a packaged desktop application

Verteilen Ihrer AppDistribute your app

Finden Sie unter Verteilen einer verpackten desktop-AnwendungSee Distribute a packaged desktop application