チュートリアル: Windows App SDK を使用する、外部の場所でパッケージ化されたアプリまたはパッケージ化されていないアプリでブートストラップ API を使用する

[アーティクル]
07/05/2024

この記事では、MSIX を使用してインストールされていないアプリ (つまり、外部の場所にパッケージ化されているか、パッケージ化されていない) を構成し、ブートストラップ API を使用して、Windows アプリ SDK ランタイムを明示的に読み込み、WINDOWS アプリ SDK API を呼び出す方法について説明します。 MSIX 経由でインストールされないアプリには、外部の場所でパッケージ化されたアプリと、パッケージ化されていないアプリが含まれます。

重要

Windows App SDK 1.0 以降、外部の場所でパッケージ化されたアプリから、またはパッケージ化されていないアプリから Windows App SDK を読み込むための既定の方法は、<WindowsPackageType> プロジェクトプロパティを介して自動初期化を使用する (と同時に追加の構成変更を行う) というものです。 WinUI 3 プロジェクトのコンテキストでの自動初期化に関連する手順については、「最初の WinUI 3 プロジェクトを作成するを参照してください。または、WinUI 3 ではない既存のプロジェクトがある場合は、「既存のプロジェクトで Windows App SDK を使用する」を参照してください。

高度なニーズ (カスタムエラー処理や、特定のバージョンの Windows App SDK の読み込みなど) がある場合は、代わりにブートストラップ API を明示的に呼び出すことができます。これは、このトピックで示すアプローチです。また、詳細については、「外部の場所でパッケージ化されたアプリまたはパッケージ化されていないアプリのWindows アプリ SDK ランタイムを使用するを参照してください。

このトピックでは、基本的なコンソールアプリプロジェクトからブートストラップ API を明示的に呼び出す方法について説明します。ただし、この手順は、Windows アプリ SDKを使用するパッケージ化されていないデスクトップアプリに適用されます。

このチュートリアルを完了する前に、Runtime アーキテクチャを確認しFrameworkWindows アプリ SDKを使用するときにアプリが受け取るパッケージの依存関係、および外部の場所またはパッケージ化されていないアプリで動作するために必要な追加コンポーネントについて学習することをお勧めします。

前提条件

Windows App SDK 用のツールをインストールする
外部の場所とパッケージ化されていないアプリでパッケージ化されたすべての依存関係がインストールされていることを確認します (外部の場所またはパッケージ化されていないWindows アプリ SDKパッケージ化されたフレームワーク依存アプリの展開ガイドを参照してください)。これを行う簡単な方法は、Windows アプリ SDKランタイムインストーラーを実行することです。

手順

C# または C++ プロジェクトを使用して、このチュートリアルに従うことができます。

Note

動的依存関係とブートストラップ API は、管理者特権でのプロセスによって呼び出されると失敗します。そのため、Visual Studio を管理者特権で起動しないでください。詳細については、「 Dynamic Dependencies doesn't support elevation #567 」を参照してください。

次の手順に従って、外部の場所でパッケージ化されているか、パッケージ化されていない C# WinUI 3 プロジェクトを構成します。

Visual Studio で、新しい C# Console App プロジェクトを作成します。プロジェクトに DynamicDependenciesTest という名前を付けます。プロジェクトを作成すると、"Hello, World!" が作成されます。C# コンソールアプリ。
次に、プロジェクトを構成します。
1. ソリューションエクスプローラーで、プロジェクトを右クリックし、[プロジェクトファイルの編集] を選択します。
2. [TargetFramework] 要素の値を、ターゲットフレームワークモニカーに置き換えます。たとえば、アプリが Windows 10 バージョン 2004 を対象としている場合は、次のコードを使用します。
```
<TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
```
1. プロジェクトファイルを保存して閉じます。
ソリューションのプラットフォームを x64 に変更します。 .NET プロジェクトの既定値は AnyCPU ですが、WinUI 3 ではそのプラットフォームはサポートされていません。
1. [ビルド]>[構成マネージャー] を選択します。
2. [アクティブソリューションプラットフォーム] の下にあるドロップダウンを選択し、[新規] をクリックして [新しいソリューションプラットフォーム] ダイアログボックスを開きます。
3. [新しいプラットフォームを入力または選択してください] の下のドロップダウンで、[x64] を選択します。
4. [OK] をクリックして [新しいソリューションプラットフォーム] ダイアログボックスを閉じます。
5. 構成マネージャーで、[閉じる] をクリックします。
プロジェクトに Windows アプリ SDK の NuGet パッケージをインストールします。
1. ソリューションエクスプローラーで、[依存関係] ノードを右クリックし、[NuGet パッケージの管理] を選択します。
2. NuGet パッケージマネージャー ウィンドウで Browse タブを選択し、Microsoft.WindowsAppSDK パッケージをインストールします。
これで、ブートストラップ API を使用する準備ができました (外部の場所またはパッケージ化されていないアプリのWindows アプリ SDK ランタイムを使用するを参照)、Windows アプリ SDK フレームワークパッケージへの依存関係を動的に取得します。これにより、アプリで Windows アプリ SDK API を使用できるようになります。

Program.cs コードファイルを開き、既定のコードを次のコードに置き換えて、ブートストラップを初期化する Bootstrap.Initialize メソッドを呼び出します。このコードでは、ブートストラップの初期化時にアプリが依存するWindows アプリ SDKのバージョンを定義します。

重要

特定の構成に合わせて、以下のコードを編集する必要があります。インストールしたWindows アプリ SDKのバージョンのいずれかを指定できるように、Bootstrap.Initialize メソッドのパラメーターの説明を参照してください。
```
using System;
using Microsoft.Windows.ApplicationModel.DynamicDependency;

namespace DynamicDependenciesTest
{
    class Program
    {
        static void Main(string[] args)
        {
            Bootstrap.Initialize(0x00010002);
            Console.WriteLine("Hello, World!");

            // Release the DDLM and clean up.
            Bootstrap.Shutdown();
        }
    }
}
```
ブートストラップ API は、アプリで Windows アプリ SDK API を使用できるようにするネイティブ C/C++ API です。ただし、Windows アプリ SDK 1.0 以降を使用する .NET アプリでは、ブートストラップ API に .NET ラッパーを使用できます。このラッパーは、ネイティブの C/C++ 関数を直接呼び出すよりも、.NET アプリでブートストラップ API を呼び出す簡単な方法を提供します。前のコード例では、ブートストラップ API の .NET ラッパーの Bootstrap クラスの静的な Initialize メソッドと Shutdown メソッドを呼び出します。
Windows アプリ SDK のランタイムコンポーネントが正しく読み込まれたことを示すために、Windows アプリ SDK の ResourceManager クラスを使用して文字列リソースを読み込むコードを追加します。
1. プロジェクトに新しい Resources File (.resw) を追加します (既定の名前のままにします)。
2. エディターでリソースファイルを開いて、次のプロパティを使用して新しい文字列リソースを作成します。
  - 名前: Message
  - 値: Hello, resources!
3. リソースファイルを保存します。
4. Program.cs コードファイルを開き、Console.WriteLine("Hello, World!");行を次のコードに置き換えます。
```
// Create a resource manager using the resource index generated during build.
   var manager = new Microsoft.Windows.ApplicationModel.Resources.ResourceManager("DynamicDependenciesTest.pri");

// Look up a string in the .resw file using its name.
Console.WriteLine(manager.MainResourceMap.GetValue("Resources/Message").ValueAsString);
```
1. [デバッグなしで開始]< (または [デバッグの開始) をクリックして、アプリをビルドして実行します。 Hello, resources! という文字列が正常に表示されることを確認します。

次の手順に従って、外部の場所にパッケージ化されているか、パッケージ化されていない C++ WinUI 3 プロジェクトを構成します。

Visual Studio で、新しい C++ コンソールアプリ プロジェクトを作成します。プロジェクトに DynamicDependenciesTest という名前を付けます。

プロジェクトを作成すると、"Hello, World!" が作成されます。C++ コンソールアプリ。
次に、プロジェクトに Windows アプリ SDK の NuGet パッケージをインストールします。
1. ソリューションエクスプローラーで、[参照] ノードを右クリックし、[NuGet パッケージの管理] を選択します。
2. NuGet パッケージマネージャー ウィンドウで、[Browse タブを選択し、Microsoft.WindowsAppSDK を検索します。
これで、ブートストラップ API を使用する準備ができました (「外部の場所でパッケージ化されたアプリまたはパッケージ化されていないアプリのWindows アプリ SDK ランタイムを使用する)」を参照して、アプリ内のWindows アプリ SDKランタイムを初期化します。これにより、アプリで Windows アプリ SDK API を使用できるようになります。
1. DynamicDependenciesTest.cpp ファイルの先頭に次のインクルードファイルを追加します。 mddbootstrap.h ヘッダーは、Windows アプリ SDK の NuGet パッケージから入手できます。
```
#include <windows.h>
#include <MddBootstrap.h>
```
1. 次に、このコードを main メソッドの先頭に追加して、 MddBootstrapInitialize 関数を呼び出してブートストラップを初期化し、エラーを処理します。このコードでは、ブートストラップの初期化時にアプリが依存するWindows アプリ SDKのバージョンを定義します。
重要

特定の構成に合わせて、以下のコードを編集する必要があります。インストールしたWindows アプリ SDKのバージョンのいずれかを指定できるように、MddBootstrapInitialize 関数のパラメーターの説明を参照してください。
```
const UINT32 majorMinorVersion{ 0x00010002 }; 
PCWSTR versionTag{ L"" }; 
const PACKAGE_VERSION minVersion{};

const HRESULT hr{ MddBootstrapInitialize(majorMinorVersion, versionTag, minVersion) }; 

// Check the return code for errors. If there is an error, display the result.
if (FAILED(hr)) 
{ 
    wprintf(L"Error 0x%X in MddBootstrapInitialize(0x%08X, %s, %hu.%hu.%hu.%hu)\n", 
        hr, majorMinorVersion, versionTag, minVersion.Major, minVersion.Minor, minVersion.Build, minVersion.Revision); 
    return hr; 
} 
```
1. 最後に、このコードを追加して文字列 Hello, World! を表示し、 MddBootstrapShutdown 関数を呼び出してブートストラップを初期化解除します。
```
std::cout << "Hello, World!\n"; 

// Release the DDLM and clean up.
MddBootstrapShutdown(); 
```
1. 最終的なコードは次のようになります。
```
#include <iostream> 
#include <windows.h> 
#include <MddBootstrap.h>

int main() 
{ 
    // Take a dependency on Windows App SDK Stable.
    const UINT32 majorMinorVersion{ 0x00010002 }; 
    PCWSTR versionTag{ L"" }; 
    const PACKAGE_VERSION minVersion{};

    const HRESULT hr{ MddBootstrapInitialize(majorMinorVersion, versionTag, minVersion) }; 

    // Check the return code. If there is a failure, display the result.
    if (FAILED(hr)) 
    { 
        wprintf(L"Error 0x%X in MddBootstrapInitialize(0x%08X, %s, %hu.%hu.%hu.%hu)\n", 
            hr, majorMinorVersion, versionTag, minVersion.Major, minVersion.Minor, minVersion.Build, minVersion.Revision); 
        return hr; 
    } 

    std::cout << "Hello, World!\n"; 

    // Release the DDLM and clean up.
    MddBootstrapShutdown(); 
} 
```
[デバッグなしで開始]< (または [デバッグの開始) をクリックして、アプリをビルドして実行します。

プロジェクトが WPF の場合

Windows Presentation Foundation (WPF) アプリについては、「 WPF アプリでWindows アプリ SDKを使用するを参照してください。

次の方法で共有

チュートリアル: Windows App SDK を使用する、外部の場所でパッケージ化されたアプリまたはパッケージ化されていないアプリでブートストラップ API を使用する

前提条件

手順

プロジェクトが WPF の場合

その他のリソース

次の方法で共有

チュートリアル: Windows App SDK を使用する、外部の場所でパッケージ化されたアプリまたはパッケージ化されていないアプリでブートストラップ API を使用する

前提条件

手順

プロジェクトが WPF の場合

関連トピック

その他のリソース