バージョン アダプティブ アプリ: 以前のバージョンとの互換性を保ちながら新しい API を使う
Windows 10 SDK の各リリースには、ユーザーが利用したくなるような魅力的な新機能が追加されています。 ただし、すべてのユーザーがデバイスを最新バージョンの Windows 10 に同時に更新するわけではないため、できるだけ幅広いデバイスでアプリが動作するようにする必要があります。 ここでは、アプリが以前のバージョンの Windows 10 で動作するだけでなく、最新の更新プログラムがインストールされたデバイスでアプリを実行したときに新機能を利用できるように、アプリを設計する方法について説明します。
できるだけ幅広い Windows 10 デバイスをアプリでサポートするには、3 つの手順を実行する必要があります。
- まず、最新の API を対象とするように Visual Studio プロジェクトを構成します。 これは、アプリをコンパイルするときの処理に影響します。
- 次に、ランタイム チェックを実行して、アプリが実行されているデバイスに存在する API だけを呼び出すようにします。
- 最後に、最小バージョンとターゲット バージョンの Windows 10 でアプリをテストします。
Visual Studio プロジェクトの構成
複数の Windows 10 バージョンをサポートするための最初の手順は、Visual Studio プロジェクトで、サポートされるターゲットと最小の OS/SDK バージョンを指定することです。
- ターゲット: Visual Studio がアプリ コードをコンパイルし、すべてのツールを実行する際に対象となる SDK バージョン。 この SDK バージョンに含まれているすべての API とリソースは、コンパイル時にアプリ コードで使うことができます。
- 最小: アプリを実行できる (ストアからの展開先となる) 以前の OS バージョンと、Visual Studio がアプリ マークアップ コードをコンパイルする際に対象となるバージョンをサポートする SDK バージョン。
実行時には展開先の OS バージョンに対してアプリが実行されるため、そのバージョンで利用できないリソースを使ったり、そのような API を呼び出したりすると、アプリによって例外がスローされます。 ランタイム チェックを使って適切な API を呼び出す方法については、この記事の後半で説明します。
ターゲットと最小の設定では、OS/SDK バージョンの範囲の両端を指定します。 ただし、最小バージョンでアプリをテストした場合、最小とターゲット間のすべてのバージョンでアプリが実行されるようになります。
ヒント
Visual Studio では API の互換性についての警告は表示されません。 ご自身の責任で最小とターゲットの間にあるすべての OS バージョン (最小とターゲットのバージョンを含む) でアプリが期待どおりに実行されることをテストし、確認してください。
Visual Studio 2015 Update 2 以降で新しいプロジェクトを作成すると、アプリがサポートしているターゲット バージョンと最小バージョンを設定するように求められます。 既定では、ターゲット バージョンはインストール済みの SDK の中で最も高いバージョンで、最小バージョンはインストール済みの SDK バージョンの中で最も低いバージョンです。 コンピューターにインストールされている SDK バージョンからのみ、ターゲットと最小を選ぶことができます。
通常、既定値のままにすることをお勧めします。 ただし、SDK のプレビュー版をインストールしていて、運用コードを記述している場合、ターゲット バージョンを Preview SDK から最新の公式の SDK バージョンに変更する必要があります。
Visual Studio で既に作成済みのプロジェクトの最小バージョンとターゲット バージョンを変更するには、[プロジェクト] -> [プロパティ] -> [アプリケーション] タブ -> [ターゲット] の順に移動します。
参考のために、各 SDK のビルド番号を次の表に示します。
| フレンドリ名 | バージョン | OS/SDK ビルド |
|---|---|---|
| RTM | 1507 | 10240 |
| 11 月の更新プログラム | 1511 | 10586 |
| Anniversary Update | 1607 | 14393 |
| Creators Update | 1703 | 15063 |
| Fall Creators Update | 1709 | 16299 |
| April 2018 Update | 1803 | 17134 |
| October 2018 Update | 1809 | 17763 |
| May 2019 Update | 1903 | 18362 |
SDK のすべてのリリース版は、「Windows SDK とエミュレーターのアーカイブ」からダウンロードできます。 最新の Windows Insider Preview SDK は、Windows Insider サイトの「開発者向け」セクションからダウンロードできます。
Windows 10 更新プログラムについて詳しくは、「Windows 10 リリース情報」をご覧ください。 Windows 10 のサポート ライフサイクルに関する重要な情報については、「Windows ライフサイクルのファクトシート」を参照してください。
API チェックの実行
バージョン アダプティブ アプリの要は、API コントラクトと ApiInformation クラスの組み合わせにあります。 このクラスは、さまざまなデバイスと OS バージョンで、指定した API コントラクト、型、またはメンバーが存在し、安全に API を呼び出すことができるかどうかを検出します。
API コントラクト
デバイス ファミリ内の API のセットは、API コントラクトと呼ばれる小項目に分類されます。 API コントラクトの存在をテストするには、ApiInformation.IsApiContractPresent メソッドを使うことができます。 これは、すべてが API コントラクトの同じバージョンに存在する多数の API の存在をテストする場合に便利です。
bool isScannerDeviceContract_1_Present =
Windows.Foundation.Metadata.ApiInformation.IsApiContractPresent
("Windows.Devices.Scanners.ScannerDeviceContract", 1);
API コントラクトとは何でしょうか。 基本的に、API コントラクトとは機能を表します。これは、何らかの特定の機能を構成する関連 API のセットです。 たとえば、ある API コントラクトは、2 つのクラス、5 つのインターフェイス、1 つの構造体、2 つの列挙体などを含む API のセットを表している可能性があります。
論理的に関連する型は API コントラクトにグループ化され、Windows 10 以降、すべての Windows ランタイム API は何らかの API コントラクトに属しています。 API コントラクトでは、デバイス上の特定の機能や API の存在がチェックされます。デバイスの機能のチェックは、特定のデバイスまたは OS をチェックするよりも効率的に行われます。 API コントラクト内のいずれかの API を実装するプラットフォームには、同じ API コントラクト内のすべての API を実装する必要があります。 つまり、実行中の OS が特定の API コントラクトをサポートしているかどうかをテストし、サポートしていると判明した場合は、その API コントラクト内のすべての API を個別にチェックせずに呼び出すことができます。
最も大規模で最もよく使われる API コントラクトは Windows.Foundation.UniversalApiContract です。 これには、ユニバーサル Windows プラットフォームの API の大部分が含まれています。 「デバイス ファミリの拡張 SDK および API コントラクト」ドキュメントでは、利用できるさまざまな API コントラクトについて説明しています。 ほとんどの API コントラクトは、機能的に関連のある API のセットを表していることがわかります。
Note
まだドキュメントが公開されていないプレビュー版の Windows ソフトウェア開発キット (SDK) をインストールしている場合は、SDK のインストール フォルダーにある "Platform.xml" ファイル ‘(Program Files (x86))\Windows Kits\10\Platforms<platform><SDK version>\Platform.xml’ で API コントラクトのサポートに関する情報を確認できます。
バージョン アダプティブ コードと条件付き XAML
すべてのバージョンの Windows 10 では、コード内の条件式で ApiInformation クラスを使って、呼び出そうとしている API が存在するかどうかをテストできます。 IsTypePresent、IsEventPresent、IsMethodPresent、IsPropertyPresent など、このクラスのさまざまなメソッドをアダプティブ コードで使って、必要に応じた精度で API をテストできます。
詳細と例については、「 バージョン アダプティブ コード 」をご覧ください。
アプリの最小バージョンがビルド 15063 (Creators Update) 以降の場合は、条件付き XAML を使って、プロパティの設定やオブジェクトのインスタンス化をマークアップで行うことができます。この場合、分離コードを使う必要はありません。 条件付き XAML は、マークアップで ApiInformation.IsApiContractPresent メソッドを使う方法を提供するものです。
詳しい説明と例については、「 条件付き XAML 」をご覧ください。
遅延読み込みされた API
QueryOptionalDelayLoadedAPI 関数を使用すると、Microsoft Store アプリ (ポリシーで LoadLibrary を呼び出すことはできません) が、遅延読み込み関数が実際に見つかったかどうかを検出できます。
#include <windows.h>
#include <commdlg.h>
#include <libloaderapi2.h>
#include <stdio.h>
EXTERN_C IMAGE_DOS_HEADER __ImageBase;
#define HMODULE_THISCOMPONENT reinterpret_cast<HMODULE>(&__ImageBase)
int __cdecl main(int argc, char** argv)
{
if (QueryOptionalDelayLoadedAPI(HMODULE_THISCOMPONENT,
"comdlg32.dll", "GetOpenFileNameW", 0))
{
printf("GetOpenFileNameW can be called!\n");
}
return 0;
}
バージョン アダプティブ アプリのテスト
バージョン アダプティブ コードや条件付き XAML を使ってバージョン アダプティブ アプリを作成する場合は、最小バージョンの Windows 10 を実行しているデバイスとターゲット バージョンを実行しているデバイスでアプリをテストする必要があります。
条件付きコードのすべてのパスを 1 台のデバイスでテストすることはできません。 すべてのコード パスを確実にテストするために、サポートされる最小の OS バージョンを実行しているリモート デバイス (または仮想マシン) でアプリを展開してテストする必要があります。 リモート デバッグについて詳しくは、「UWP アプリの展開とデバッグ」をご覧ください。
関連記事
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示