パラメーターを使用した Windows アプリの起動

[アーティクル]
07/11/2023

調査

スタートメニューの一部の Windows アプリ起動ツールでは、Windows アプリの起動時にパラメーターを実行可能ファイルに渡す必要があります。これを実現するには、まず、パラメーターを必要とする起動ツールを特定してから、Windows アプリをパッケージサポートフレームワークと統合する必要があります。

Windows アプリ起動ツールのパラメーター要件の特定

テストマシンに Windows アプリをインストールします。
Windows の [スタート] メニューを開きます。
スタートメニューから Windows アプリ起動ツールを見つけて選択します。
アプリが起動した場合、問題はありません ([スタート] メニューで関連するすべての Windows アプリ起動ツールをテストします)。
テストコンピューターから Windows アプリをアンインストールします。
Win32 インストールメディアを使用して、アプリケーションをテスト用マシンにインストールします。
Windows の [スタート] メニューを開きます。
スタートメニューから Windows アプリを見つけて右クリックします。
ドロップダウンメニューから [その他]>>[ファイルの場所を開く] を選択します。
関連付けられている最初のアプリケーションショートカットを右クリックします (関連するすべてのアプリケーションショートカットについて、次の 3 つの手順を繰り返します)。
ドロップダウンメニューの [プロパティ] を選択します。
[リンク先] の右側にあるテキストボックスの値を確認します。アプリケーションファイルパスの後にパラメーターが一覧表示されている場合は、このアプリ
後で確認できるように、パラメーターの値を記録します。

解決方法

Windows アプリは、アプリケーションに関連する特定のディレクトリをフォルダーに C:\Program Files\WindowsApps リダイレクトします。アプリケーションが Windows アプリコンテナーに書き込もうとすると、エラーがトリガーされ、書き込みは失敗します。

Windows アプリコンテナーへの書き込みに失敗した Windows アプリに関連する問題を解決するには、次の 4 つの手順に従う必要があります。

Windows アプリをローカルディレクトリにステージングする
Config.json を作成し、必要な PSF ファイルを挿入する
Windows アプリ AppxManifest ファイルを更新する
Windows アプリを再パッケージ化して署名する

上記の手順では、Windows アプリのコンテンツをローカルのステージングディレクトリに抽出し、PSF 修正ファイルをステージングされた Windows アプリディレクトリに挿入し、PSF ランチャーを指すアプリケーション起動ツールを構成し、PSF config.json ファイルを構成して PSF ランチャーを作業ディレクトリを指定するアプリにリダイレクトする方法について説明します。

必要なツールをダウンロードしてインストールする

このプロセスでは、次のツールの取得方法と使用方法について説明します。

NuGet クライアントツール
パッケージサポートフレームワーク
Windows 10 SDK (最新バージョン)
SysInternals プロセスモニター

次に、必要なツールをダウンロードしてインストールする方法について順を追って説明します。

最新 (非プレビュー) バージョンのNuGet クライアントツールをダウンロードし、nuget.exe を C:\PSF\nuget フォルダーに保存します。
管理 PowerShell ウィンドウから次を実行して、Nuget を使用してパッケージサポートフレームワークをダウンロードします。
```
Set-Location "C:\PSF"
.\nuget\nuget.exe install Microsoft.PackageSupportFramework
```
Windows 10 ソフトウェア開発ツールキット (Win 10 SDK) をダウンロードしてインストールします。
1. Win 10 SDK をダウンロードします。
2. 前の手順でダウンロードした winsdksetup.exe を実行します。
3. [次へ] ボタンを選択します。
4. インストールには、次の 3 つの機能のみを選択します。
  - デスクトップアプリ用の Windows SDK 署名ツール
  - UWP C++ アプリ用 Windows SDK
  - UWP アプリのローカライズ用 Windows SDK
5. [インストール] ボタンを選択します。
6. [OK] ボタンを選択します。

Windows アプリをステージングする

Windows アプリをステージングすることで、Windows アプリの内容をローカルディレクトリに抽出/アンパックします。 Windows アプリがステージングの場所に展開されると、PSF Fixup ファイルを挿入して不要なエクスペリエンスを修正できます。

管理 PowerShell ウィンドウを開きます。

特定のアプリファイルと Windows 10 SDK バージョンを対象とする次の変数を設定します。

$AppPath          = "C:\PSF\SourceApp\PSFSampleApp.msix"         ## Path to the MSIX App Installer
$StagingFolder    = "C:\PSF\Staging\PSFSampleApp"                ## Path to where the MSIX App will be staged
$OSArchitecture   = "x$((gcim Win32_Processor).AddressWidth)"    ## Operating System Architecture
$Win10SDKVersion  = "10.0.19041.0"                               ## Latest version of the Win10 SDK

次の PowerShell コマンドレットを実行して、Windows アプリをステージングフォルダーに展開します。

## Sets the directory to the Windows 10 SDK
Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"

## Unpackages the Windows app to the staging folder
.\makeappx.exe unpack /p "$AppPath" /d "$StagingFolder"

必要な PSF ファイルを作成して挿入する

修正アクションを Windows アプリに適用するには、 config.json ファイルを作成し、失敗している Windows アプリ起動ツールに関する情報を提供する必要があります。複数の Windows アプリ起動ツールで問題が発生している場合は、 config.json ファイルを複数のエントリで更新できます。

config.json ファイルを更新した後、config.json ファイルとサポート PSF 修正ファイルを Windows アプリパッケージのルートに移動する必要があります。

Visual Studio Code (VS Code)、またはその他のテキストエディターを開きます。
VS Code の上部にある [ファイル] メニューを選択し、ドロップダウンメニューから [新しいファイル] を選択して、新しいファイルを作成します。
VS Code ウィンドウの上部にある [ファイル] メニューを選択し、ドロップダウンメニューから [保存] を選択して、このファイルを config.json として保存します。 [名前を付けて保存] ウィンドウで、Windows アプリのステージングディレクトリ (C:\PSF\Staging\PSFSampleApp) に移動し、ファイル名config.jsonを . 保存ボタンを選択します。

新しく作成した config.json ファイルに次のコードをコピーします。

{
    "applications": [
        {
            "id": "",
            "executable": "",
            "arguments": ""
        }
    ]
}

VS Code または別のテキストエディターを使用して、Windows アプリステージングフォルダー (C:\PSF\Staging\PSFSampleApp\AppxManifest.xml) にあるステージングされた Windows アプリ AppxManifest ファイルを開きます。

<Applications>
    <Application Id="PSFSAMPLE" Executable="VFS\ProgramFilesX64\PS Sample App\PSFSample.exe" EntryPoint="Windows.FullTrustApplication">
    <uap:VisualElements BackgroundColor="transparent" DisplayName="PSFSample" Square150x150Logo="Assets\StoreLogo.png" Square44x44Logo="Assets\StoreLogo.png" Description="PSFSample">
        <uap:DefaultTile Wide310x150Logo="Assets\StoreLogo.png" Square310x310Logo="Assets\StoreLogo.png" Square71x71Logo="Assets\StoreLogo.png" />
    </uap:VisualElements>
    </Application>
</Applications>

config.json の applications.id 値を、AppxManifest.xml ファイルの Applications.Application.ID フィールドと同じ値になるように設定します。
config.json の applications.executable 値を、AppxManifest.xml ファイルの Applications.Application.Executable フィールドにあるアプリケーションへの相対パスをターゲットとするように設定します。
config.json の applications.arguments 値を、アプリケーションを起動するために使用される引数と一致するように設定します。「調査 - Windows アプリ起動ツールのパラメーター要件の特定」ガイダンスの最後の手順で記録された値を参照してください。
config.json の applications.workingdirectory 値を、AppxManifest.xml ファイルの Applications.Application.Executable フィールドにある相対フォルダーパスをターゲットとするように設定します。

更新した config.json ファイルを保存します。

{
    "applications": [
        {
        "id": "PSFSample",
        "executable": "VFS/ProgramFilesX64/PS Sample App/PSFSample.exe",
        "arguments": "/bootfromsettingshortcut"
        }
    ]
}

アプリケーションの実行可能アーキテクチャに基づくパッケージサポートフレームワークから、ステージングされた Windows アプリのルートに次の 4 つのファイルをコピーします。次のファイルは .\Microsoft.PackageSupportFramework.<Version>\bin 内にあります。

アプリケーション (x64) アプリケーション (x86)

PSFLauncher64.exe PSFLauncher32.exe

PSFRuntime64.dll PSFRuntime32.dll

PSFRunDll64.exe PSFRunDll32.exe

アプリケーション (x64)	アプリケーション (x86)
PSFLauncher64.exe	PSFLauncher32.exe
PSFRuntime64.dll	PSFRuntime32.dll
PSFRunDll64.exe	PSFRunDll32.exe

AppxManifest を更新する

config.json ファイルを作成して更新した後、config.json に含まれていた Windows アプリ起動ツールごとに、Windows アプリの AppxManifest.xml を更新する必要があります。 AppxManifest のアプリケーションは、アプリケーションアーキテクチャに関連付けられた PSFLauncher.exe をターゲットにしている必要があります。

エクスプローラーを開き、ステージングされた MSIX アプリフォルダー (C:\PSF\Staging\PSFSampleApp) に移動します。
AppxManifest.xml を右クリックし、ドロップダウンメニューから [Open with Code] (コード付きで開く) を選択します (必要に応じて、別のテキストエディターで開いてもかまいません)。

次の情報を使用して AppxManifest.xml ファイルを更新します。

<Package ...>
...
<Applications>
    <Application Id="PSFSample"
                Executable="PSFLauncher32.exe"
                EntryPoint="Windows.FullTrustApplication">
    ...
    </Application>
</Applications>
</Package>

アプリケーションを再パッケージ化する

すべての修正が適用され、Windows アプリを MSIX に再パッケージ化し、コード署名証明書を使用して署名できるようになりました。

管理 PowerShell ウィンドウを開きます。

次の変数を設定します。

$AppPath          = "C:\PSF\SourceApp\PSFSampleApp_Updated.msix" ## Path to the MSIX App Installer
$CodeSigningCert  = "C:\PSF\Cert\CodeSigningCertificate.pfx"     ## Path to your code signing certificate
$CodeSigningPass  = "<Password>"                                 ## Password used by the code signing certificate
$StagingFolder    = "C:\PSF\Staging\PSFSampleApp"                ## Path to where the MSIX App will be staged
$OSArchitecture   = "x$((gcim Win32_Processor).AddressWidth)"    ## Operating System Architecture
$Win10SDKVersion  = "10.0.19041.0"                               ## Latest version of the Win10 SDK

次の PowerShell コマンドレットを実行して、ステージングフォルダーから Windows アプリを再パックします。

Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"
.\makeappx.exe pack /p "$AppPath" /d "$StagingFolder"

次の PowerShell コマンドレットを実行して、Windows アプリに署名します。

Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"
.\signtool.exe sign /v /fd sha256 /f $CodeSigningCert /p $CodeSigningPass $AppPath