既存の Windows アプリケーションのマイグレーション

概説

IBM MobileFirst™ Platform Foundation バージョン 6.2.0 以降で作成された既存のネイティブ Windows プロジェクトをマイグレーションするには、現行バージョンの SDK を使用するようにプロジェクトを変更する必要があります。 次に、v8.0 で使用が中止された、または v8.0 に含まれていないクライアント・サイド API を置き換えます。 マイグレーション・アシスト・ツールはコードをスキャンし、置き換える API のレポートを生成できます。

ジャンプ先

• バージョンアップの前準備として既存のMobileFirst ネイティブ Windows アプリケーションをスキャン
• Windows プロジェクトのマイグレーション
• Windows コードの更新

バージョンアップの前準備として既存の MobileFirst ネイティブ Windows アプリケーションをスキャン

マイグレーション・アシスト・ツールは、ネイティブ Windows アプリケーションのソースをスキャンし、V8.0 で非推奨または使用中止となった API のレポートを生成することにより、以前のバージョンの IBM MobileFirst™ Platform Foundation で作成されたアプリケーションのマイグレーションの準備を支援します。

マイグレーション・アシスト・ツールを使用する前に、以下の情報を知っておくことが重要です。

• 既存の IBM MobileFirst Platform Foundation ネイティブ Windows アプリケーションがある必要があります。
• インターネット・アクセスが必要です。
• node.js バージョン 4.0.0 以降がインストールされている必要があります。
• マイグレーション・プロセスの制限についてよく読み、理解します。 詳しくは、以前のリリースからのアプリケーションのマイグレーションを参照してください。

以前のバージョンの IBM MobileFirst Platform Foundation で作成されたアプリケーションは、一部変更を行わないと V8.0 ではサポートされません。 マイグレーション・アシスト・ツールは、既存のネイティブ Windows アプリケーションのソース・ファイルをスキャンすることによりこのプロセスを簡素化し、V8.0 で非推奨となった API、非サポート対象となった API、または変更された API を識別します。

マイグレーション・アシスト・ツールでは、アプリケーションの開発者コードおよびコメントの変更や移動は行いません。

1. 以下のいずれかの方法を使用してマイグレーション・アシスト・ツールをダウンロードします。
   • Git リポジトリーから .tgz ファイルをダウンロードします。
   • MobileFirst Operations Console から MobileFirst Developer Kit をダウンロードします。これには、mfpmigrate-cli.tgz という名前のファイルとしてマイグレーション・アシスト・ツールが含まれています。
2. マイグレーション・アシスト・ツールをインストールします。
   • ツールをダウンロードしたディレクトリーに移動します。
   • 以下のコマンドを入力することにより、NPM を使用してツールをインストールします。

   npm install -g
   

3. 以下のコマンドを入力して、IBM MobileFirst Platform Foundation アプリケーションをスキャンします。

   mfpmigrate scan --in source_directory --out destination_directory --type windows
   

   source_directory
   プロジェクトの現在のロケーション。

   destination_directory
   レポートが作成されるディレクトリー。

   マイグレーション・アシスト・ツールを scan コマンドと共に使用すると、ツールは、既存の IBM MobileFirst Platform Foundation アプリケーション内にある、V8.0 で削除された API、非推奨となった API、または変更された API を識別し、識別された宛先ディレクトリーにそれらを保存します。

Windows プロジェクトのマイグレーション

IBM MobileFirst™ Platform Foundation V6.2.0 以降で作成された既存のネイティブ Windows プロジェクトを使用して作業するには、プロジェクトを変更する必要があります。

MobileFirst V8.0 では、Windows Universal 環境 (つまり、Windows 10 Universal Windows Platform (UWP) および Windows 8 Universal (Desktop および Phone)) のみがサポートされます。 Windows Phone 8 Silverlight はサポートされません。

Visual Studio プロジェクトを V8.0 に手動でアップグレードできます。 MobileFirst V8.0 では、以前のバージョンで開発されたアプリケーションを変更する必要が生じる可能性がある、Visual Studio SDK に対する多くの変更が導入されています。 変更された API については、Windows コードの更新を参照してください。

1. MobileFirst SDK を V8.0 に更新します。
   • MobileFirst SDK パッケージを手動で削除します。 これには、wlclient.properties ファイル、および以下の参照が含まれます。
     • Newtonsoft.Json
     • SharpCompress
     • worklight-windows8

     注: アプリケーションでアプリケーション認証性フィーチャーまたは拡張認証性フィーチャーを使用している場合、Microsoft Visual C++ 2013 Runtime Package for Windows または Microsoft Visual C++ 2013 Runtime Package for Windows Phone のいずれかを参照としてアプリケーションに追加する必要があります。 そうするには、Visual Studio で、ネイティブ・プロジェクトの参照を右クリックし、ネイティブ API アプリケーションに追加した環境に応じて以下のいずれかを行います。

     • Windows デスクトップおよびタブレットの場合: 「参照設定」→「参照の追加」→「Windows 8.1」→「拡張機能」→「Microsoft Visual C++ 2013 Runtime Package for Windows」→「OK」の順に右クリックして選択します。
     • Windows Phone 8 Universal の場合: 「参照設定」→「参照の追加」→「Windows 8.1」→「拡張機能」→「Microsoft Visual C++ 2013 Runtime Package for Windows Phone」→「OK」の順に右クリックして選択します。
     • Windows 10 Universal Windows Platform (UWP) の場合: 「参照設定」→「参照の追加」→「Windows 8.1」→「拡張機能」→「Microsoft Visual C++ 2013 Runtime Package for Windows Universal」→「OK」の順に右クリックして選択します。
   • NuGet を使用して MobileFirst V8.0.0 SDK パッケージを追加します。 『NuGet を使用した MobileFirst SDK の追加』を参照してください。
2. MobileFirst V8.0.0 API を使用するようにアプリケーション・コードを更新します。
   • 以前のリリースの場合、Windows API は、IBM.Worklight.namespace の一部でした。 これらの API は現在、廃止され、同等の WorklightNamespace API に置き換えられています。 IBM.Worklight.namespace へのすべての参照を、WorklightNamespace の対応する同等の参照に置き換えるようにアプリケーションを変更する必要があります。

   例えば、以下のようなスニペットを使用します。

   WLResourceRequest request = new WLResourceRequest
                            (new Uri(uriBuilder.ToString()), "GET", "accessRestricted");
                            request.send(listener);
   

   新しい API で更新したスニペットは、以下のようになります。

   WorklightResourceRequest request = newClient.ResourceRequest
                            (new Uri(uriBuilder.ToString(), UriKind.Relative), "GET", "accessRestricted");
                            WorklightResponse response = await request.Send();
   

   • 非同期操作を実行するすべてのメソッドは以前、応答リスナー・コールバック・モデルを使用していました。 これらは、await/async モデルに置き換えられています。

これで、MobileFirst SDK を使用してネイティブ Windows アプリケーションの開発を始めることができます。 MobileFirst V8.0.0 での API の変更を反映するため、コードの更新が必要になる場合があります。

次の作業

使用が中止された、または V8.0 に含まれていないクライアント・サイド API を置き換えます。

Windows コードの更新

Mobile Foundation V8.0 では、Windows SDK に対する多くの変更が導入されています。これにより、以前のバージョンで開発されたアプリケーションの変更が必要になる可能性があります。

非推奨となった Windows C# API クラス

非推奨となった Windows C# API インターフェース