Desktop App Converter を使用してアプリをパッケージ化する (デスクトップ ブリッジ)Package an app using the Desktop App Converter (Desktop Bridge)

Desktop App Converter を入手するGet the Desktop App Converter

Desktop App Converter (DAC) を使用すると、デスクトップ アプリをユニバーサル Windows プラットフォーム (UWP) に移行することができます。You can use the Desktop App Converter (DAC) to bring your desktop apps to the Universal Windows Platform (UWP). Win32 アプリや .NET 4.6.1 を使用して作成されたアプリも対象になります。This includes Win32 apps and apps that you've created by using .NET 4.6.1.

DAC アイコン

このツールの名前には "Converter" という用語が含まれますが、実は、アプリの変換は行いません。While the term "Converter" appears in the name of this tool, it doesn't actually convert your app. アプリは変更されません。Your app remains unchanged. しかし、DACは、パッケージ ID を持ち多くの WinRT API を呼び出すことができる Windows アプリ パッケージを生成します。However, this tool generates a Windows app package with a package identity and the ability to call a vast range of WinRT APIs.

このパッケージは、開発コンピューターで Add-AppxPackage という PowerShell コマンドレットを使ってインストールすることができます。You can install that package by using the Add-AppxPackage PowerShell cmdlet on your development machine.

このコンバーターは、コンバーターのダウンロードに含まれるクリーンな状態の基本イメージを使って、分離された Windows 環境でデスクトップ インストーラーを実行します。The converter runs the desktop installer in an isolated Windows environment by using a clean base image provided as part of the converter download. デスクトップ インストーラーが作成するすべてのレジストリとファイル システムの I/O がキャプチャされ、出力の一部としてパッケージ化されます。It captures any registry and file system I/O made by the desktop installer and packages it as part of the output.

重要

デスクトップ ブリッジは、Windows 10 Version 1607 で導入されており、Windows 10 Anniversary Update (10.0、ビルド 14393) 以降のリリースをターゲットとする Visual Studio プロジェクトでのみ使用できます。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.

注意

Microsoft Virtual Academy から公開されている、このシリーズの短いビデオをご覧ください。Checkout this series of short videos published by the Microsoft Virtual Academy. これらのビデオでは、Desktop App Converter を使用する一般的な方法が紹介されています。These videos walk you through some common ways to use the Desktop App Converter.

DAC が行うのはパッケージの生成だけではありませんThe DAC does more than just generate a package for you

他にも以下のような処理を実行できます。Here's a few extra things it can do for you.

Windows 10 Creators UpdateWindows 10 Creators Update

✔️ プレビュー ハンドラー、サムネイル ハンドラー、プロパティ ハンドラー、ファイアウォール規則、URL フラグを自動的に登録する。✔️ Automatically register your preview handlers, thumbnail handlers, property handlers, firewall rules, URL flags.

✔️ ファイルの種類のマッピングを自動的に登録する。これによりユーザーは、エクスプローラーの [種類] 列を使ってファイルをグループ化できるようになります。✔️ Automatically register file type mappings that enable users to group files by using the Kind column in File Explorer.

✔️ 公開 COM サーバーを登録する。✔️ Register your public COM servers.

Windows 10 Anniversary Update 以降Windows 10 Anniversary Update or later

✔️ アプリをテストできるように、パッケージに自動的に署名する。✔️ Automatically sign your package so that you can test your app.

✔️ デスクトップ ブリッジと Microsoft Store の要件に照らしてアプリを検証する。✔️ Validate your app against Desktop Bridge and Microsoft Store requirements.

オプションの完全な一覧については、このガイドの「パラメーター リファレンス」セクションをご覧ください。To find a complete list of options, see the Parameters section of this guide.

パッケージを作成する準備ができたら、始めましょう。If you're ready to create your package, let's start.

まず、アプリケーションを準備しますFirst, prepare your application

アプリケーションのパッケージの作成を開始する前に、必ず「アプリのパッケージ化の準備 (デスクトップ ブリッジ)」を確認してください。Review this guide before you begin creating a package for your application: Prepare to package an app (Desktop Bridge).

システムで DCA を実行できることを確認するMake sure that your system can run the converter

システムが以下の要件を満たしていることを確認します。Make sure that your system meets the following requirements:

Desktop App Converter を起動するStart the Desktop App Converter

  1. Desktop App Converterをダウンロードおよびインストールします。Download and install the Desktop App Converter.

  2. 管理者として Desktop App Converter を実行します。Run the Desktop App Converter as an administrator.

    DAC を管理者として実行する

    コンソール ウィンドウが開きます。A console window appears. コマンドを実行するには、このコンソール ウィンドウを使います。You'll use that console window to run commands.

必要な設定を行う (インストーラーがあるアプリのみ) Set a few things up (apps with installers only)

アプリにインストーラーがない場合は、このセクションをスキップできます。You can skip ahead to the next section if your app doesn't have an installer.

  1. オペレーティング システムのバージョン番号を特定します。Identify the version number of your operating system.

    そのためには、[ファイル名を指定して実行] ダイアログ ボックスで「winver」と入力し、[OK] をクリックします。To do that, type winver in the Run dialog box, and then choose the OK button.

    winver

    [Windows のバージョン情報] ダイアログ ボックスに Windows ビルドのバージョンが表示されます。You'll find the version of your Windows build in the About Windows dialog box.

    Windows 10 のバージョン

  2. 適切な Desktop App Converter 基本イメージをダウンロードします。Download the appropriate Desktop app Converter base image.

    ファイル名に含まれるバージョン番号が Windows ビルドのバージョン番号と一致していることを確認してください。Make sure that the version number that appears in the name of the file matches the version number of your Windows build.

    重要

    ビルド番号 15063 を使用しており、そのビルドのマイナー バージョンが .483 以上 (例: 15063.540) である場合は、BaseImage-15063-UPDATE.wim ファイルをダウンロードします。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. そのビルドのマイナー バージョンが .483 未満である場合は、BaseImage-15063.wim ファイルをダウンロードします。If the minor version of that build is less than .483, download the BaseImage-15063.wim file. このベース ファイルの互換性のないバージョンを既にセットアップしている場合は、修正することができます。If you've already setup an incompatible version of this base file, you can fix it. その方法については、このブログの投稿をご覧ください。This blog post explains how to do that.

  3. ダウンロードしたファイルを後で見つけることができるように、コンピューター上の適切な場所に置きます。Place the downloaded file anywhere on your computer where you'll be able to find it later.

  4. Desktop App Converter を起動したときに表示されるコンソール ウィンドウで、コマンド Set-ExecutionPolicy bypass を実行します。In the console window that appeared when you started the Desktop App Converter, run this command: Set-ExecutionPolicy bypass.

  5. コマンド 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. 画面の指示に従って、コンピューターを再起動します。Restart your computer if you're prompted to do so.

    コンバーターによって基本イメージが展開されると、コンソール ウィンドウに状態メッセージが表示されます。Status messages appear in the console window as the converter expands the base image. 状態メッセージが表示されない場合は、任意のキーを押します。If you don't see any status messages, press any key. これにより、コンソール ウィンドウの内容が更新されます。This can cause the contents of the console window to refresh.

    コンソール ウィンドウに表示された状態メッセージ

    基本イメージが完全に展開されたら、次のセクションに進みます。When the base image is fully expanded, move to the next section.

アプリをパッケージ化するPackage an app

アプリをパッケージ化するには、Desktop App Converter を起動したときに開くコンソール ウィンドウで DesktopAppConverter.exe コマンドを実行します。To Package your app, run the DesktopAppConverter.exe command in the console window that opened when you started the Desktop App Converter.

パラメーターを使用して、アプリのパッケージ名、発行元、バージョン番号を指定します。You'll specify the package name, publisher and version number of the app by using parameters.

注意

Windows ストアでアプリ名を予約済みの場合は、Windows デベロッパー センターのダッシュ ボードを使用して、パッケージと発行元名を取得できます。If you've reserved your app name in the Windows store, you can obtain the package and publisher names by using the Windows Dev Center dashboard. アプリを他のシステムにサイドローディング展開する場合は、独自の名前を指定できます。ただし、選択する発行元名は、アプリへの署名に使用する証明書の名前と一致する必要があります。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.

コマンド パラメーターの確認A quick look at command parameters

必要なパラメーターは次のとおりです。Here are the required parameters.

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

各パラメーターについて詳しくは、こちらをご覧ください。You can read about each one here.

Examples

アプリをパッケージ化する一般的な方法のいくつかを以下に示します。Here's a few common ways to package your app.

インストーラー (.msi) ファイルのあるアプリをパッケージ化するPackage an app that has an installer (.msi) file

Installer パラメーターでインストーラー ファイルを指定します。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

重要

ここで留意すべき重要なことが 2 つあります。There are two important things to keep in mind here. まず、インストーラーは独立したフォルダーに配置し、そのインストーラーに関連するファイルだけを同じフォルダーに配置してください。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. コンバーターは、このフォルダーの内容をすべて、分離された Windows 環境にコピーします。The converter copies all of the contents of that folder to the isolated Windows environment.
2 つ目に、デベロッパー センターが数値で始まる ID をパッケージに割り当てる場合、必ず -AppId パラメーターも渡し、そのパラメーターの値として文字列サフィックスのみを使ってください (ピリオドの区切り記号の後)。Secondly, if the dev 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.

ビデオVideo

インストーラーに、従属ライブラリやフレームワークのインストーラーが含まれている場合、少し異なる方法で整理する必要があります。If your installer includes installers for dependent libraries or frameworks, you might have to organize things a bit a differently. 複数のインストーラーとデスクトップ ブリッジの連結に関する記事をご覧ください。See Chaining multiple installers with the Desktop Bridge.

セットアップの実行可能ファイルのあるアプリをパッケージ化するPackage an app that has a setup executable file

Installer パラメーターを使って、セットアップの実行可能ファイルを指定します。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

重要

デベロッパー センターが数値で始まる ID をパッケージに割り当てる場合、必ず -AppId パラメーターも渡し、そのパラメーターの値として文字列サフィックスのみを使ってください (ピリオドの区切り記号の後)。If the dev 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.

InstallerArguments パラメーターは省略可能なパラメーターです。The InstallerArguments parameter is an optional parameter. ただし、Desktop App Converter では、インストーラーを無人モードで実行する必要があるため、アプリをサイレント モードで実行するためにサイレント フラグを必要とする場合は、このパラメーターの使用が必要になることがあります。However, because the Desktop App Converter needs your installer to run in unattended mode, you might have to use it if your app needs silent flags to run silently. /S フラグは非常に一般的なサイレント フラグですが、セットアップ ファイルを作成するために使用したインストーラー テクノロジによっては、使用するフラグが異なる場合もあります。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.

ビデオVideo

インストーラーのないアプリをパッケージ化するPackage an app that doesn't have an installer

この例では、Installer パラメーターを使用して、アプリ ファイルのルート フォルダーを指定しています。In this example, use the Installer parameter to point to the root folder of your app files.

アプリの実行可能ファイルを指定するには、AppExecutable パラメーターを使用します。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

重要

デベロッパー センターが数値で始まる ID をパッケージに割り当てる場合、必ず -AppId パラメーターも渡し、そのパラメーターの値として文字列サフィックスのみを使ってください (ピリオドの区切り記号の後)。If the dev 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.

ビデオVideo

アプリをパッケージ化し、アプリに署名して、パッケージに対して検証チェックを実行するPackage an app, sign the app, and run validation checks on the package

この例は最初の例に似ていますが、こちらはローカル テスト用にアプリに署名し、デスクトップ ブリッジと Microsoft Store の要件に照らしてアプリを変換する方法を示しています。This example is similar to first one except it shows how you can sign your app for local testing, and then validate your app against Desktop Bridge 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

重要

デベロッパー センターが数値で始まる ID をパッケージに割り当てる場合、必ず -AppId パラメーターも渡し、そのパラメーターの値として文字列サフィックスのみを使ってください (ピリオドの区切り記号の後)。If the dev 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.

Sign パラメーターは、証明書を生成し、その証明書でアプリに署名します。The Sign parameter generates a certificate and then signs your app with it. アプリを実行するには、生成された証明書をインストールする必要があります。To run your app, you'll have to install that generated certificate. その方法については、このガイドの「パッケージ アプリを実行する」セクションをご覧ください。To learn how, see the Run the packaged app section of this guide.

アプリを検証するには、Verify パラメーターを使います。You can validate you app by using the Verify parameter.

省略可能なパラメーターの確認A quick look at optional parameters

Sign パラメーターと Verify パラメーターは省略可能です。The Sign and Verify parameters are optional. 他にも多数の省略可能なパラメーターがあります。There are many more optional parameters. よく使用される省略可能なパラメーターを以下に示します。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>]

これらについて詳しくは、次のセクションをご覧ください。You can read about all of them in the next section.

パラメーター リファレンスParameter Reference

ここでは、Desktop App Converter を実行するときに使用できるパラメーターの完全な一覧をカテゴリ別に示します。Here's the complete list of parameters (organized by category) that you can use when you run the Desktop App Converter.

アプリ コンソール ウィンドウで Get-Help コマンドを実行して完全な一覧を表示することもできます。You can also view the entire list by running the Get-Help command in the app console window.

セットアップ パラメーターSetup parameters
-Setup [<SwitchParameter>]-Setup [<SwitchParameter>] 必須Required セットアップ モードで DesktopAppConverter を実行します。Runs DesktopAppConverter in setup mode. セットアップ モードでは、用意されている基本イメージの展開をサポートします。Setup mode supports expanding a provided base image.
-BaseImage <String>-BaseImage <String> 必須Required 展開されていない基本イメージの完全パス。Full path to an unexpanded base image. このパラメーターは、-Setup を指定する場合に必要です。This parameter is required if -Setup is specified.
-LogFile <String>-LogFile <String> 省略可能Optional ログ ファイルを指定します。Specifies a log file. 省略した場合は、ログ ファイルの一時的な場所が作成されます。If omitted, a log file temporary location will be created.
-NatSubnetPrefix <String>-NatSubnetPrefix <String> 省略可能Optional Nat インスタンスで使うプレフィックス値。Prefix value to be used for the Nat instance. 通常この値は、ホスト コンピューターがコンバーターの NetNat と同じサブネット範囲に割り当てられている場合にのみ変更します。Typically, you would want to change this only if your host machine is attached to the same subnet range as the converter's NetNat. 現在のコンバーターの NetNat 構成は Get NetNat コマンドレットを使って照会できます。You can query the current converter NetNat config by using the Get-NetNat cmdlet.
-NoRestart [<SwitchParameter>]-NoRestart [<SwitchParameter>] 必須Required セットアップの実行中に再起動を要求しません (コンテナー機能を有効にするには再起動が必要です)。Don't prompt for reboot when running setup (reboot is required to enable the container feature).
変換パラメーターConversion parameters
-AppInstallPath <String>-AppInstallPath <String> 省略可能Optional インストール済みのファイルに対応する、アプリケーションのルート フォルダーの完全パス (インストールされている場合)。"C:\Program Files (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> 必須Required コンバーターの appx を出力する場所。この場所がまだ存在しない場合は、DesktopAppConverter によって作成されます。The desired destination for the converter's appx output - DesktopAppConverter can create this location if it doesn't already exist.
-Installer <String>-Installer <String> 必須Required アプリケーションのインストーラーのパス。無人/サイレント モードで実行できるようにする必要があります。The path to the installer for your application - must be able to run unattended/silently. インストーラーを使用しない変換では、アプリ ファイルのルート ディレクトリへのパス。No-installer conversion, this is the path to the root directory of your app files.
-InstallerArguments <String>-InstallerArguments <String> 省略可能Optional インストーラーに無人/サイレント モードでの実行を強制する引数の文字列、またはコンマ区切り一覧。A comma-separated list or string of arguments to force your installer to run unattended/silently. インストーラーが msi の場合は、このパラメーターは省略可能です。This parameter is optional if your installer is an msi. インストーラーからログを取得するには、ここで、インストーラーのログ記録の引数を指定し、パス <log_folder> (コンバーターが適切なパスに置換するトークン) を使います。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.

: 無人/サイレント フラグとログの引数は、インストーラー テクノロジごとに異なります。NOTE: The unattended/silent flags and log arguments will vary between installer technologies.

このパラメーターの使用例: -InstallerArguments "/silent /log <log_folder>\install.log"。ログ ファイルを生成しない別の例: -InstallerArguments "/quiet", "/norestart"。コンバーターでログをキャプチャし、最終的なログ フォルダーに格納する場合は、文字どおりすべてのログにトークン パス <log_folder> を指定する必要があります。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> 省略可能Optional インストーラーの正常な実行を示す、コンマで区切った終了コードの一覧 (例: 0, 1234, 5678)。A comma-separated list of exit codes that indicate your installer ran successfully (for example: 0, 1234, 5678). 既定では、非 msi は 0、msi は 0, 1641, 3010 です。By default this is 0 for non-msi, and 0, 1641, 3010 for msi.
パッケージ ID パラメーターPackage identity parameters
-PackageName <String>-PackageName <String> 必須Required ユニバーサル Windows アプリ パッケージの名前。The name of your Universal Windows App package. デベロッパー センターが数値で始まる ID をパッケージに割り当てる場合、必ず -AppId パラメーターも渡し、そのパラメーターの値として文字列サフィックスのみを使ってください (ピリオドの区切り記号の後)。If the dev 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> 必須Required ユニバーサル Windows アプリ パッケージの発行元The publisher of your Universal Windows App package
-Version <Version>-Version <Version> 必須Required ユニバーサル Windows アプリ パッケージのバージョン番号The version number for your Universal Windows App package
パッケージ マニフェスト パラメーターPackage manifest parameters
-AppExecutable <String>-AppExecutable <String> 省略可能Optional アプリケーションのメインの実行可能ファイルの名前 (例:"MyApp.exe")。The name of your application's main executable (eg "MyApp.exe"). インストーラーを使用しない変換では、このパラメーターは必須です。This parameter is required for a no-installer conversion.
-AppFileTypes <String>-AppFileTypes <String> 省略可能Optional アプリケーションに関連付ける、ファイルの種類のコンマ区切りの一覧。A comma-separated list of file types which the application will be associated with. 使用例: -AppFileTypes "'.md', '.markdown'"。Example usage: -AppFileTypes "'.md', '.markdown'".
-AppId <String>-AppId <String> 省略可能Optional Windows アプリ パッケージ マニフェストでアプリケーション ID を設定する値を指定します。Specifies a value to set Application Id to in the Windows app package manifest. 指定しなかった場合は、PackageName で渡した値が設定されます。If it is not specified, it will be set to the value passed in for PackageName. 多くの場合、PackageName を使って問題ありません。In many cases, using the PackageName is fine. ただし、デベロッパー センターが数値で始まる ID をパッケージに割り当てる場合、必ず -AppId パラメーターも渡し、そのパラメーターの値として文字列サフィックスのみを使ってください (ピリオドの区切り記号の後)。However, if the dev 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> 省略可能Optional Windows アプリ パッケージ マニフェストでアプリケーションの表示名を設定する値を指定します。Specifies a value to set Application Display Name to in the Windows app package manifest. 指定しなかった場合は、PackageName で渡した値が設定されます。If it is not specified, it will be set to the value passed in for PackageName.
-AppDescription <String>-AppDescription <String> 省略可能Optional Windows アプリ パッケージ マニフェストでアプリケーションの説明を設定する値を指定します。Specifies a value to set Application Description to in the Windows app package manifest. 指定しなかった場合は、PackageName で渡した値が設定されます。If it is not specified, it will be set to the value passed in for PackageName.
-PackageDisplayName <String>-PackageDisplayName <String> 省略可能Optional Windows アプリ パッケージ マニフェストでパッケージの表示名を設定する値を指定します。Specifies a value to set Package Display Name to in the Windows app package manifest. 指定しなかった場合は、PackageName で渡した値が設定されます。If it is not specified, it will be set to the value passed in for PackageName.
-PackagePublisherDisplayName <String>-PackagePublisherDisplayName <String> 省略可能Optional Windows アプリ パッケージ マニフェストでパッケージ発行元の表示名を設定する値を指定します。Specifies a value to set Package Publisher Display Name to in the Windows app package manifest. 指定しなかった場合は、Publisher で渡した値が設定されます。If it is not specified, it will be set to the value passed in for Publisher.
クリーンアップ パラメーターCleanup parameters
-Cleanup [<Option>]-Cleanup [<Option>] 必須Required DesktopAppConverter の成果物のクリーンアップを実行します。Runs cleanup for the DesktopAppConverter artifacts. クリーンアップ モードには 3 つの有効なオプションがあります。There are 3 valid options for the Cleanup mode.
-Cleanup All-Cleanup All 展開済みのすべての基本イメージを削除し、コンバーターのすべての一時ファイルを削除します。コンテナーのネットワークを削除し、Windows のオプション機能、コンテナーを無効にします。Deletes all expanded base images, removes any temporary converter files, removes the container network, and disables the optional Windows feature, Containers.
-Cleanup WorkDirectory-Cleanup WorkDirectory 必須Required コンバーターのすべての一時ファイルを削除します。Removes all the temporary converter files.
-Cleanup ExpandedImage-Cleanup ExpandedImage 必須Required ホスト コンピューターにインストールされているすべての展開済みの基本イメージを削除します。Deletes all the expanded base images installed on your host machine.
パッケージ アーキテクチャ パラメーターPackage architecture parameters
-PackageArch <String>-PackageArch <String> 必須Required 指定したアーキテクチャのパッケージを生成します。Generates a package with the specified architecture. 有効なオプションは、'x86' または 'x64' です。たとえば、-PackageArch x86 のように指定します。Valid options are 'x86' or 'x64'; for example, -PackageArch x86. このパラメーターは省略可能です。This parameter is optional. 指定されていない場合、DesktopAppConverter はパッケージのアーキテクチャの自動検出を試みます。If unspecified, the DesktopAppConverter will try to auto-detect package architecture. 自動検出に失敗した場合、既定値は x64 パッケージです。If auto-detection fails, it will default to x64 package.
その他のパラメーターMiscellaneous parameters
-ExpandedBaseImage <String>-ExpandedBaseImage <String> 省略可能Optional 既に展開済みの基本イメージの完全パス。Full path to an already expanded base image.
-MakeAppx [<SwitchParameter>]-MakeAppx [<SwitchParameter>] 省略可能Optional このスクリプトに出力で MakeAppx を呼び出すように指示するスイッチ (存在する場合)。A switch that, when present, tells this script to call MakeAppx on the output.
-LogFile <String>-LogFile <String> 省略可能Optional ログ ファイルを指定します。Specifies a log file. 省略した場合は、ログ ファイルの一時的な場所が作成されます。If omitted, a log file temporary location will be created.
-Sign [<SwitchParameter>]-Sign [<SwitchParameter>] 省略可能Optional 出力する Windows アプリ パッケージに、テスト用に生成された証明書を使用して署名するようにこのスクリプトに指示します。Tells this script to sign the output Windows app package by using a generated certificate for testing purposes. このスイッチは、-MakeAppx スイッチと共に指定する必要があります。This switch should be present alongside the switch -MakeAppx.
<共通パラメーター><Common parameters> 必須Required このコマンドレットは、共通パラメーター VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBufferPipelineVariableOutVariable をサポートします。This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. 詳しくは、「about_CommonParameters」をご覧ください。For more info, see about_CommonParameters.
-Verify [<SwitchParameter>]-Verify [<SwitchParameter>] 省略可能Optional 指定された場合、デスクトップ ブリッジと Microsoft Store の要件に照らして、アプリ パッケージを検証するように DAC に指示するスイッチ。A switch that, when present, tells the DAC to validate the app package against Desktop Bridge and Microsoft Store requirements. 結果は、検証レポート "VerifyReport.xml" で、ブラウザーでの視覚化に最適です。The result is a validation report "VerifyReport.xml", which is best visualized in a browser. このスイッチは、-MakeAppx スイッチと共に指定する必要があります。This switch should be present alongside the switch -MakeAppx.
-PublishComRegistrations-PublishComRegistrations 省略可能Optional インストーラーによって行われたすべての パブリック COM 登録をスキャンし、有効な登録をマニフェストで公開します。Scans all public COM registrations made by your installer and publishes the valid ones in your manifest. このフラグは、これらの登録を他のアプリケーションで利用できるようにする場合にのみ使用してください。Use this flag only if you want to make these registrations available to other applications. これらの登録を対象アプリケーションでのみ使用する場合、このフラグを使用する必要はありません。You don't need to use this flag if these registrations will be used only by your application.

アプリをパッケージ化した後、正常に動作するように COM 登録を行うには、こちらの記事をご覧ください。Review this article to make sure that your COM registrations behave as you expect after you package your app.

パッケージ アプリを実行するRun the packaged app

アプリを実行するには、2 種類の方法があります。There's two ways to run your app.

1 つ目は、PowerShell コマンド プロンプトを開いて、Add-AppxPackage –Register AppxManifest.xml というコマンドを入力する方法です。One way is to open a PowerShell command prompt, and then type this command: Add-AppxPackage –Register AppxManifest.xml. アプリに署名する必要がないため、アプリを最も簡単に実行できるのはこちらの方法です。It's probably the easiest way to run your app because you don't have to sign it.

2 つ目は、証明書を使ってアプリに署名する方法です。Another way is to sign your app with a certificate. sign パラメーターを使用すると、Desktop App Converter によって証明書が生成され、その証明書でアプリへの署名が行われます。If you use the sign parameter, the Desktop App Converter will generate one for you, and then sign your app with it. その証明書ファイルは auto-generated.cer という名前になり、パッケージ アプリのルート フォルダーに配置されます。That file is named auto-generated.cer, and you can find it in the root folder of your packaged app.

生成された証明書をインストールし、アプリを実行するには、次の手順を実行します。Follow these steps to install the generated certificate, and then run your app.

  1. auto-generated.cer ファイルをダブルクリックして証明書をインストールします。Double-click the auto-generated.cer file to install the certificate.

    生成された証明書ファイル

    注意

    パスワードを求められた場合は、既定のパスワード "123456" を使用します。If you're prompted for a password, use the default password "123456".

  2. [証明書] ダイアログ ボックスで、[証明書のインストール] を選択します。In the Certificate dialog box, choose the Install Certificate button.

  3. 証明書インポート ウィザードで、証明書をローカル コンピューターにインストールし、証明書を "信頼されたユーザー" の証明書ストアに配置します。In the Certificate Import Wizard, install the certificate onto the Local Machine, and place the certificate into the Trusted People certificate store.

    信頼されたユーザー ストア

  4. パッケージ アプリのルート フォルダーで、Windows アプリのパッケージ ファイルをダブルクリックします。In root folder of your packaged app, double click the Windows app package file.

    Windows アプリのパッケージ ファイル

  5. [インストール] を選択してアプリをインストールします。Install the app, by choosing the Install button.

    [インストール] ボタン

パッケージ アプリを変更するModify the packaged app

パッケージ アプリには、バグの修正、ビジュアル資産の追加、モダン エクスペリエンス (ライブ タイルなど) によるアプリの拡張などのために変更が必要になる可能性があります。You'll likely make changes to your packaged app to address bugs, add visual assets, or enhance your app with modern experiences such as live tiles.

変更を加えた後、もう一度コンバーターを実行する必要はありません。After you make your changes, you don't need to run the converter again. ほとんどの場合、MakeAppx ツールと、DAC によってアプリ用に生成される appxmanifest.xml ファイルを使ってアプリを再パッケージ化することができます。In most cases, you can just repackage your app by using the MakeAppx tool and the appxmanifest.xml file the DAC generates for your app. Windows アプリ パッケージを生成する」をご覧ください。See Generate a Windows app package.

注意

インストーラーによるレジストリ設定を変更した場合は、その変更を適用するために、Desktop App Converter をもう一度実行する必要があります。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.

ビデオVideos

出力の変更と再パッケージ化Modify and repackage output デモ: 出力の変更と再パッケージ化Demo: Modify and repackage output

次の 2 つのセクションでは、パッケージ アプリについて検討可能な調整オプションについて説明します。The following two sections describe a couple of optional fix-ups to the packaged app that you might consider.

不要なファイルとレジストリ キーを削除するDelete unnecessary files and registry keys

Desktop App Converter では、コンテナー内のファイルとシステム ノイズの除去に、非常に保守的なアプローチを取っています。The desktop App Converter takes a very conservative approach to filtering out files and system noise in the container.

VFS フォルダーを確認し、インストーラーに必要ないファイルがあれば、削除することもできます。If you want, you can review the VFS folder and delete any files that your installer doesn't need. また、Reg.dat の内容を確認し、アプリによってインストールされないキーや不要なキーがあれば、削除できます。You can also review the contents of Reg.dat and delete any keys that are not installed/needed by the app.

破損した PEヘッダーを修正するFix corrupted PE headers

DesktopAppConverter は 変換処理中に PEHeaderCertFixTool を自動的に実行し、破損している PEヘッダーを修正します。During the conversion process, the DesktopAppConverter automatically runs the PEHeaderCertFixTool to fixup any corrupted PE headers. ただし、UWP の Windows アプリ パッケージ、ルーズ ファイル、または特定のバイナリで、PEHeaderCertFixTool を実行することも可能です。However, you can also run the PEHeaderCertFixTool on a UWP Windows app package, loose files, or a specific binary. 次に例を示します。Here's an example.

PEHeaderCertFixTool.exe <binary file>|<.appx package>|&lt;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

Desktop App Converter の利用統計情報Telemetry from Desktop App Converter

Desktop App Converter は、ソフトウェアの使用者と使用方法に関する情報を収集して、この情報を Microsoft に送信することがあります。Desktop App Converter may collect information about you and your use of the software and send this info to Microsoft. Microsoft のデータ収集と製品ドキュメントでの使用の詳細については、「マイクロソフトのプライバシーに関する声明」をご覧ください。You can learn more about Microsoft's data collection and use in the product documentation and in the Microsoft Privacy Statement. マイクロソフトのプライバシーに関する声明の該当するすべての条項に準拠することに同意します。You agree to comply with all applicable provisions of the Microsoft Privacy Statement.

既定では、Desktop App Converter の利用統計情報は有効にされています。By default, telemetry will be enabled for the Desktop App Converter. 利用統計情報を目的の設定に構成するには、次のレジストリ キーを追加します。Add the following registry key to configure telemetry to a desired setting:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\DesktopAppConverter
  • DWORD を 1 に設定して、DisableTelemetry 値を追加または編集します。Add or edit the DisableTelemetry value by using a DWORD set to 1.
  • 利用統計情報を有効にするには、このキーを削除するかキーの値を 0 に設定します。To enable telemetry, remove the key or set the value to 0.

言語サポートLanguage support

Desktop App Converterは、Unicode をサポートしていません。したがって、漢字または非 ASCII 文字をツールで使用することはできません。The Desktop App Converter does not support Unicode; thus, no Chinese characters or non-ASCII characters can be used with the tool.

次のステップNext steps

質問に対する回答を見つけるFind answers to your questions

ご質問がある場合は、Have questions? Stack Overflow でお問い合わせください。Ask us on Stack Overflow. Microsoft のチームでは、これらのタグをチェックしています。Our team monitors these tags. こちらから質問することもできます。You can also ask us here.

ここで既知の問題の一覧を確認することもできます。You can also refer to this list of known issues.

フィードバックの提供または機能の提案を行うGive feedback or make feature suggestions

UserVoice のページをご覧ください。See UserVoice.

アプリを実行する/問題を検出して修正するRun your app / find and fix issues

パッケージ デスクトップ アプリの実行、デバッグ、テスト (デスクトップ ブリッジ) をご覧ください。See Run, debug, and test a packaged desktop app (Desktop Bridge)

アプリを配布するDistribute your app

パッケージ デスクトップ アプリの配布 (デスクトップ ブリッジ) をご覧ください。See Distribute a packaged desktop app (Desktop Bridge)