Bing Maps Trip Optimizer のサンプルでの既存のコードの移行

[アーティクル]
09/08/2014

このドキュメントでは、Bing マップトリップオプティマイザーの ActiveX バージョンから Windows ストアアプリに移行したときに準拠した主要なガイドラインの一部をまとめています。このドキュメントでは、既存のコードを Windows ランタイムに移行する方法については詳細に説明しません。むしろ、経験上の事柄および注意事項を説明しています。

注意

このドキュメントに対応するサンプルコードは、「Bing Maps trip optimizer sample (Bing マップトリップオプティマイザーサンプル)」(Windows ストアアプリ) および「Bing Maps Trip Optimizer (Bing マップトリップオプティマイザー)」(ActiveX Web アプリ) にあります。

この記事の内容

JavaScript 移行キーポイント
C++ 移行キーポイント
Interop 移行キーポイント

JavaScript 移行キーポイント

Bing マップトリップオプティマイザーの ActiveX バージョンは UI として 1 つのコードファイル、つまり OptimizerControl.htm を使用します。このドキュメントで説明されているように、Windows ランタイムを使用するために移行したとき、Web と対話するコンポーネントと Windows ランタイムと対話するコンポーネントについて個別のコンテキストを作成する必要がありました。また、コンテキストが通信できるように追加のコードを記述する必要がありました。ドキュメント「Features and restrictions by context」は、ローカルコンテキストと Web コンテキストの違いについて説明しています。

Windows ストアアプリケーションバージョンの元のバージョンのコードの大半を使用できました。 1 つの大きな違いは、Windows ストアアプリケーションが ActiveX コントロールを参照しなくなったため、object 要素を C++ コンポーネントを表すグローバル変数に置き換えました。この機能は「Bing Maps Trip Optimizer のサンプルでの JavaScript と C++ 間の相互運用」で詳しく説明します。

alert、prompt、open などのウィンドウメソッドは、JavaScript Windows ストアアプリでは機能しません。コントロールの ActiveX バージョンは、alert を使用して、25 か所を超える場所が入力された場合などの問題をユーザーに通知します。アプリの Windows ストアバージョンでは、Windows.UI.Popups.MessageDialog クラスを使用してユーザーにメッセージを表示します。

// Show message dialog.            
new Windows.UI.Popups.MessageDialog(data.message).showAsync().then();

メッセージダイアログが表示された後で実行する操作がないため、then ステートメントは空です。 JavaScript の非同期操作を使用する方法の詳細については、「Asynchronous programming」を参照してください。

JavaScript Windows ストアアプリの既存の HTML 機能の使用方法の相違点については、「HTML, CSS, and JavaScript features and differences」を参照してください。

アプリケーションの ActiveX バージョンでは、UI にマップを表示するために、Bing マップ AJAX コントロール、Version 6.3 を使用しています。 Windows ストアアプリバージョンでは、Bing マップ AJAX コントロール、Version 7.0 を使用します。 Version 6.3 から Version 7.0 へのアップグレードは必須ではありません。Windows ストアアプリケーションで Version 6.3 を使用できます。この実装に Version 7.0 を選択したのは、タッチのパフォーマンスとサポートが向上されていること、および Bing マップから情報を取得する新しい方法を示すためでした。

[このページのトップへ]

C++ 移行キーポイント

Windows ストアコンポーネントの作成に C++/CX を使用する場合、コンパイラと Windows ランタイムは、他のコンポーネントおよび言語と相互運用するために必要なインフラストラクチャを処理します。コントロールの ActiveX バージョンを Windows ストアコンポーネントに移行したとき、カスタム COM インターフェイスを実装するために必要なインフラストラクチャコードを削除できました。たとえば、Windows ランタイムコンポーネントは、インターフェイスを定義する IDL ファイル、およびコンポーネントが提供するイベントを必要としません。加えて、純粋なネイティブコードを使用する実装の詳細を可能な限り保持しました。 C++/CX と Windows ランタイムの使用は、コントロールが Windows ランタイムの他のオブジェクトおよびコンポーネントとやり取りする場合にのみ必要です。

Windows ランタイムを使用するコントロールに ActiveX コントロールを移行する際、次のガイドラインを考慮に入れてください。

ヒント

これらのガイドラインの多くは、C++/CX 構文の使用に関係しています。この構文の詳細については、「Visual C++ の言語リファレンス (C++/CX)」を参照してください。

Visual Studio プロジェクトの作成には WinRT クラスライブラリ テンプレートを使用します。
ActiveX コントロールから Windows ランタイムクラスにパブリックインターフェイスのメソッドとプロパティを追加します。 Windows ランタイムと互換性のある型を使用するために、パラメーターと戻り値の型を変換します。たとえば、TripOptimizerImpl.idl は、ActiveX コントロールの IOptimizerControl インターフェイスを定義します。
```
interface IOptimizerControl : IDispatch{
   [id(1)] HRESULT OptimizeTripAsync([in] VARIANT* waypoints, [in] BSTR travelMode, 
      [in] BSTR optmz, [in] BSTR bingMapsKey,
      [in] DOUBLE alpha, [in] DOUBLE beta, [in] DOUBLE rho, [in] ULONG iterations,
      [in] VARIANT_BOOL parallel);
   [id(2)] HRESULT CancelAsync();
};
```
Windows ストアコンポーネントでは、Windows ランタイムコンポーネントの TripOptimizer::OptimizeTripAsync メソッドの宣言は次のとおりです。 HRESULT ではなく、実際の戻り値の型 Windows::Foundation::Collections::IMap<K, V> を使用します。また、各パラメーターに Windows ランタイムの適切な型も使用します。

注意

この実装では CancelAsync メソッドを削除できました。キャンセルの機能が Windows::Foundation::IAsyncOperationWithProgress<TResult, TProgress>::Cancel メソッドによって提供されるためです。
```
// Optimizes a trip as an asynchronous process.
Windows::Foundation::IAsyncOperationWithProgress<
    Windows::Foundation::Collections::IMap<
        Platform::String^, 
        Windows::Foundation::Collections::IVector<Platform::String^>^>^, 
    Platform::String^>^ OptimizeTripAsync(
        Windows::Foundation::Collections::IVector<Platform::String^>^ waypoints, 
        Platform::String^ travelMode, 
        Platform::String^ optimize,
        Platform::String^ bingMapsKey, 
        double alpha, double beta, double rho,
        unsigned int iterations, bool parallel);
```
TripOptimizer::OptimizeTripAsync メソッドは「TripOptimizer と TripOptimizerImpl クラスの作成」セクションで詳しく説明されています。
ActiveX コントロールから Windows ランタイムクラスにパブリックインターフェイスのイベントを追加します。メソッドやプロパティと同様に、Windows ランタイムと互換性のある型を使用するために、パラメーターと戻り値の型を変換します。

この実装では、ActiveX バージョンで定義されたイベントをすべて削除できました。これらの操作がすべて他の方法で処理されるからです。たとえば、TripOptimizer::OptimizeRouteAsync によって返される IAsyncOperationWithProgress<TResult, TProgress> オブジェクトの一部として結果を直接返すため、完了イベントを定義する必要はありません。エラーおよび進行状況のコールバックも、IAsyncOperationWithProgress<TResult, TProgress> オブジェクトによって処理されます。アプリケーションの JavaScript の部分が非同期操作を使用する方法については、「Bing Maps Trip Optimizer のサンプルでの JavaScript と C++ 間の相互運用」を参照してください。
Windows ランタイムクラスのデータメンバーを定義するとき、適切な標準 C++ および Windows ランタイムタイプを選択します。

たとえば、COptimizerControl クラスは、文字列の値を保持するために _bstr_t などの COM 型を使用します。

アプリの Windows ストアバージョンでは、文字列の値を保持するために C++ の標準文字列型である std::wstring を使用しました。たとえば、TripOptimizerImpl::OptimizeTripAsync メソッドでは Windows::Foundation::Collections::IVector<T> パラメーターと Platform::String パラメーターを std::vector と std::wstring に変換します。これらの変数は Windows ランタイムコンポーネントに渡されないためです。
```
// Copy inputs to a OptimizeTripParams structure.
auto params = make_shared<OptimizeTripParams>();
for (auto waypoint : waypoints)
{
    params->Waypoints.push_back(waypoint->Data());
}
params->TravelMode = wstring(travelMode->Data());
params->Optimize = wstring(optimize->Data());
params->BingMapsKey = UriEncode(bingMapsKey->Data());
params->Alpha = alpha;
params->Beta = beta;
params->Rho = rho;
params->Iterations = iterations;
params->Parallel = parallel;
```
この規則を使用すると、Windows ランタイムに使用される変数をより明確に識別できます。 Windows ランタイムの文字列とコレクションの型 (Windows::Foundation::Collections::IMap<K, V> や Windows::Foundation::Collections::IVector<T> など) は、Windows ランタイムとコードとの間で定期的に通信する場合に便利です。アプリが行う必要のある文字列型変換の数を減らせるためです。または、std::map や std::vector などの標準 C++ コレクション型の使用を検討できます。

コントロールの実装の詳細は、「構成のワークフロー」セクションで詳しく説明されています。
Windows::Foundation::IAsyncAction、Windows::Foundation::IAsyncActionWithProgress<TProgress>、Windows::Foundation::IAsyncOperation<TResult>、または Windows::Foundation::IAsyncOperationWithProgress<TResult, TProgress> インターフェイスを使用して、非同期メソッドを定義できます。 concurrency::create_async 関数は、C++ Windows ストアアプリまたはコンポーネントからこれらのオブジェクトを作成するための推奨される方法です。
可能な限り既存のコードを使用します。コードの変更をほとんど行うことなく、アリの巣の最適化アルゴリズムなどの実装の詳細を移行することができました。ただし、Windows ストアアプリは Win32 および COM API のサブセットを使用できるため、一部のコンポーネントでは代替機能を使用する必要がありました。たとえば、コントロールの ActiveX バージョンでは、IXMLHTTPRequest を使用して HTTP サーバーと通信します。 C++ コンポーネントでは、IXMLHTTPRequest2 を使用します。これは、Windows ストアアプリで HTTP サーバーと通信するための推奨される方法です。 Bing マップからの XML 応答を処理するために、ActiveX コントロールでは XmlLite を使用します。 Windows ストアコンポーネントでは、Windows ランタイム XmlDocument クラスを使用しますが、その理由として、便利であること、また既存の COM コードを更新して Windows ランタイム型を使用する方法を示すことがあります。ただし、Windows ストアアプリで使用できる既存の Win32 または COM コードがある場合は、それを引き続き使用できます。

Windows ストアアプリでの Win32 および COM の使用方法の詳細については、「Win32 and COM for Windows Store apps (Windows ストアアプリの Win32 および COM)」を参照してください。

重要

Windows ストアアプリで Win32 および COM を使用する場合、開発環境で動作しても Windows ストアから配布用に承認されない場合があります。そのため、アプリケーション検証ツールを頻繁に実行して、アプリケーションが検証を渡すことを確認することをお勧めします。詳細については、「アプリの提出」および「方法: パッケージのインストール、検証、およびアップロードを行う」を参照してください。
Visual C++ プロジェクトでは、プリコンパイル済みヘッダーの情報を保持するために pch.h と pch.cpp を使用します。関連する #include ステートメントを stdafx.h から pch.h に移行します。

[このページのトップへ]

Interop 移行キーポイント

Bing マップトリップオプティマイザーの Windows ストアアプリケーションバージョンでは、JavaScript コードの大半を ActiveX バージョンから使用することができました。主な違いは、HTML コードおよび JavaScript コードが C++ コンポーネントを参照する方法です。

ActiveX バージョンは、HTML object タグを使用して C++ コンポーネントを参照します。

そのため、ActiveX バージョンは id 値である "OptimizerControl" を使用して COptimizerControl メソッドを呼び出します。

Bing マップトリップオプティマイザーの Windows ストアアプリケーションバージョンは、プロジェクト参照を設定し、object タグの代わりにグローバル変数を使用します。プロジェクトシステムは、JavaScript アプリケーションが C++ コンポーネントを特定して読み込むために必要な手順を実行します。「C++ での Windows ランタイムコンポーネントの作成」の記事では、プロジェクト参照を設定する方法について詳しく説明しています。

ActiveX バージョンは、イベントを処理するために :: の構文を使用します。

// Event handler for progress notifications from the control.
function document.OptimizerControl::ProgressCallback(message) {
   // Set message.
   ProgressMessageText.innerHTML = message;
}

Windows ストアアプリケーションバージョンは、非同期処理を使用して、C++ コンポーネントからの応答に反応することを約束します。このプロセスについては、「C++ コンポーネントからデータを受け取る」で説明します。

[このページのトップへ]

次の方法で共有

Bing Maps Trip Optimizer のサンプルでの既存のコードの移行

この記事の内容

JavaScript 移行キーポイント

C++ 移行キーポイント

Interop 移行キーポイント

その他のリソース

次の方法で共有

Bing Maps Trip Optimizer のサンプルでの既存のコードの移行

この記事の内容

JavaScript 移行キー ポイント

C++ 移行キー ポイント

Interop 移行キー ポイント

その他のリソース

JavaScript 移行キーポイント

C++ 移行キーポイント

Interop 移行キーポイント