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

概説

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

ジャンプ先

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

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

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

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

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

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

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

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

   npm install -g
   

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

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

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

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

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

Gradle を使用した Android プロジェクトのマイグレーション

Gradle を使用して、MobileFirst SDK が追加された Android アプリケーションをマイグレーションします。

Android Studio および Android SDK が適切にセットアップされていることを確認します。 システムのセットアップ方法について詳しくは、Android Studio 概要を参照してください。 プロジェクトは、Android Studio/Gradle セットアップに準拠していて、Mobile Foundation にアップグレードする前にエラーなしでコンパイルされる必要があります。

注: このタスクでは、Android プロジェクトが Android Studio を使用して作成されていること、および Android Studio (7.1) の使用による新規アプリケーションまたは既存アプリケーションへの Mobile Foundation SDK の追加で述べられているように、MobileFirst SDK が追加されていることを想定しています。

Android Studio プロジェクトが、MobileFirst SDK の以前のバージョンを追加するようにセットアップされている場合は、build.gradle 依存関係エンクロージャーから compile グループを削除します。 例えば、7.1 からアップグレードする場合は、以下のグループを削除します。

compile group: 'com.ibm.mobile.foundation',
            name:'ibmmobilefirstplatformfoundation',
            version:'7.1.0.0',
            ext: 'aar',
            transitive: true

これで、ローカルまたはリモートの SDK ファイルを使用して V8.0.0 の SDK と構成を追加できるようになりました。 Android アプリケーションへの MobileFirst SDK の追加を参照してください。

注: 新しい SDK をインポートした後は、Javadoc ファイルを手動でインポートする必要があります。 『Android Studio Gradle プロジェクトへの Javadoc の登録』を参照してください。

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

次の作業

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

Android コードの更新

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

使用が中止された Android API エレメント

サポートされなくなった、レガシー org.apach.http API に依存している Android API