コンポーネントベースの統合方法を使用する場合、統合プロセスを完了するには、次の一般的な手順を実行する必要があります。
クライアントで新しいプロジェクトを作成する
このトピックでは、Windows ベースの開発環境でローカルアプリを作成、コンパイル、パッケージ化し、実行可能な .apk パッケージを取得する方法について説明します。
まず、次の手順を実行する必要があります。
Portal プロジェクトを作成する
コンポーネントベースの統合は、必要な場所で利用できます。まず Portal プロジェクトを作成する必要があります。
Portal には通常、ビジネスコードは含まれず、バンドルを単一の実行可能な .apk パッケージに結合するためにのみ使用されます。したがって、Portal プロジェクトを作成すると、Launcher というサフィックスが付いたバンドルプロジェクトがデフォルトで作成されます。
作成手順は次のとおりです。
Android Studio を起動した後、ウェルカムページで 新しい mPaaS プロジェクトを開始する をクリックします。
新しい mPaaS プロジェクトを作成するmPaaS ポータル次へ ウィンドウで、 を選択します。 をクリックします。
プロジェクト名 を入力します。 構成ファイルパスを選択 する場合は、コンソールで コードの管理 > コード構成 からダウンロードした .config ファイル を選択します。 mPaaS プラグインは、選択した構成ファイルに基づいて パッケージ名 を自動的に解析して入力します。 [次へ] をクリックします。
mPaaS SDK のバージョンを選択し、必要なモジュール依存関係を確認します。次へ ボタンをクリックします。
重要必要に応じてモジュールの依存関係を確認してください。依存関係の詳細については、各コンポーネントのドキュメントを参照してください。
フレームワークに必要な依存関係のみを選択できます。アプリを作成した後、mPaaS プラグイン > コンポーネント管理 機能を使用して、必要な依存関係を追加できます。
デフォルトで作成されたバンドルプロジェクトの情報を確認します。完了 ボタンをクリックします。
これで、Portal プロジェクトが作成され、デフォルトで作成されたバンドルプロジェクトが取得されました。
Bundle プロジェクトを作成する
mPaaS フレームワークは複数のバンドルプロジェクトをサポートしているため、プロジェクト用に複数のバンドルプロジェクトを作成できます。
ファイル新規新しい mPaaS プロジェクトを開始する > > メニューをクリックします。
新しい mPaaS プロジェクトを作成するmPaaS ポータル次へ ウィンドウで、 を選択します。 をクリックします。
プロジェクト名 を入力します。 構成ファイルパスを選択 する場合は、コンソールで コードの管理 > コード構成 からダウンロードした .config ファイル を選択します。 mPaaS プラグインは、選択した構成ファイルに基づいて パッケージ名 を自動的に解析し、入力します。 [次へ] をクリックします。
mPaaS SDK のバージョンを選択し、必要なモジュール依存関係を確認します。次へ ボタンをクリックします。
デフォルトで作成されたバンドルプロジェクトの情報を確認します。完了 ボタンをクリックします。
これで、バンドルプロジェクトが作成されました。バンドル開発の詳細については、「バンドルプロジェクト」をご参照ください。
後続の手順
mPaaS コンポーネント を統合して使用するには、各コンポーネントの統合ドキュメントを参照してください。
関連トピック
コンポーネントベースの統合 > 概要: Portal プロジェクトとバンドルプロジェクトのコード構造、コンパイルとパッケージの結果、ネイティブプロジェクトとの違いについて説明します。
コンポーネントの依存関係を管理する
mPaaS SDK ベースラインのアップグレードとコンポーネントの依存関係の管理を容易にするために、最初に Android Studio mPaaS プラグインを最新バージョンにアップグレードする必要があります。 mPaaS プラグインのアップグレード方法の詳細については、「mPaaS プラグインをアップグレードする」をご参照ください。
コンポーネントの依存関係を管理する
mPaaS コンポーネントを使用するには、まず Portal プロジェクトとバンドルプロジェクトのそれぞれに、このコンポーネントの依存関係を追加する必要があります。
Portal プロジェクトに依存関係を追加すると、この依存関係が apk にパッケージ化されて含まれるようになります。
バンドルプロジェクトに依存関係を追加すると、バンドルプロジェクトでこのコンポーネントの API を呼び出すことができるようになります。
単一の Portal プロジェクトの場合は、この Portal プロジェクトに依存関係を追加するだけで済みます。
mPaaS プロジェクトの作成時に使用するコンポーネントを既に選択している場合でも、次のようにコンポーネントを追加および削除できます。
手順
Android Studio で、mPaaS > コンポーネントベースのアクセス を選択し、表示される統合パネルで、コンポーネントの設定/更新 の下の [設定の開始] をクリックします。
表示されるコンポーネント管理ウィンドウで、対応するボタンをクリックして、必要なコンポーネントをインストールします。
コンポーネントがインストールされていない場合、対応するボタンには「未インストール」と表示されます。このボタンをクリックして、コンポーネントをインストールします。
コンポーネントがインストールされている場合、対応するボタンには「インストール済み」と表示されます。この場合、このボタンをもう一度クリックすると、このコンポーネントがアンインストールされます。
後続の手順
以前 Android Studio mPaaS プラグインを使用してコンポーネントの依存関係を管理しておらず、コンポーネント管理 機能を初めて使用する場合は、コンポーネントを追加した後、次の構成も確認または変更する必要があります。
Portal プロジェクトとバンドルプロジェクトのルートディレクトリにある
build.gradleファイルを確認します。ファイルに次の依存関係が含まれており、バージョンが次のバージョンより前でないことを確認します。buildscript { ... dependencies { classpath 'com.android.boost.easyconfig:easyconfig:2.8.4' } }Portal プロジェクトのメインモジュールにある
build.gradleファイルを確認します。ファイルに次の内容が含まれていることを確認します。apply plugin: 'com.alipay.portal' portal { allSlinks true mergeAssets true } apply plugin: 'com.alipay.apollo.baseline.update' mpaascomponents{ excludeDependencies=[] }古い依存関係を削除します。
重要削除する前に、次のバックアップを作成することを強くお勧めします。
Portal + バンドルモードの場合は、Portal プロジェクトのメインモジュールにある
build.gradleファイルの dependencies ノードにある mPaaS コンポーネントの依存関係 (mpaas-baseresjarを除く) を削除する必要があります。単一の Portal プロジェクトの場合は、メインモジュールにある
build.gradleファイルから次のものを削除する必要があります。apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_bundles.gradle" apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_apis.gradle"また、プロジェクトのルートディレクトリにある
mpaas_bundles.gradleファイルとmpaas_apis.gradleファイルを削除します。mpaas_apis.gradleファイルを削除すると、コンパイルエラーが発生する可能性があることに注意してください。次のセクションで説明するように、サブモジュールで構成を変更する必要があります。
サブモジュールから mPaaS コンポーネントの API を呼び出すには、次の手順を実行します。
Portal + バンドルプロジェクトの場合は、バンドルプロジェクトのサブモジュールにある
build.gradleファイルに次を追加する必要があります。apply plugin: 'com.alipay.apollo.baseline.update'単一の Portal プロジェクトの場合は、サブモジュールにある
build.gradleファイルから次のものを削除する必要があります。apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_apis.gradle"そして、次を追加します。
apply plugin: 'com.alipay.apollo.baseline.update'
元の依存関係にカスタム依存関係が含まれている場合は、カスタム依存関係を追加する 必要があります。
ライブラリの競合が原因でコンパイルに失敗した場合は、依存関係の競合を解決する ことができます。
ベースラインをアップグレードする
Android Studio で、mPaaS > コンポーネントベースのアクセス をクリックし、表示される統合パネルで、アクセス/ベースラインのアップグレード の下の [構成の開始] をクリックします。
バージョン ドロップダウン ボックスを [クリック] し、新しいバージョンを選択し、[OK] ボタンをクリックしてベースラインをアップグレードします。
単一コンポーネントをアップグレードする
新しいバージョン
Android Studio で、mPaaS > [コンポーネントのアップグレード] を選択して、コンポーネントのリストを表示します。
コンポーネントのステータスを表示し、コンポーネントをアップグレードします。右上隅にアップデートが利用可能な場合は、クリックしてアップデートします。
古いバージョン
Android Studio で、mPaaS > [コンポーネントのアップグレード] を選択して、コンポーネントのリストを表示します。
コンポーネントのステータスを表示し、コンポーネントをアップグレードします。
最新バージョンが現在使用されている場合は、このコンポーネントのアップグレードは必要ありません。
それ以外の場合は、このコンポーネントの新しいバージョンが利用可能です。ステータスボタンをクリックして、このコンポーネントをアップグレードします。
カスタム依存関係を追加する
[コンポーネント管理] 機能を使用してコンポーネントを管理するのが初めての場合 (SDK のアップグレードではない場合)、カスタム依存関係を Portal プロジェクトのメインモジュールにある
build.gradleファイルの dependencies ノードに書き込むだけで済みます。次に例を示します。bundle 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.180322162837@jar' manifest 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.180322162837:AndroidManifest@xml'コンポーネント管理機能を使用してコンポーネントを管理し SDK をアップグレードする場合、または ベースラインアップグレード機能を使用して SDK をアップグレードする場合で、初めてこれらの機能を使用する場合は、新しいバージョンに基づいてカスタム依存関係を再カスタマイズする必要がある場合があります。チケットを送信するか、mPaaS サポートに連絡して確認してください。再カスタマイズ後、または再カスタマイズが不要であることを確認した後、上記のようにカスタム依存関係を追加できます。
ビルドする
Android Studio mPaaS プラグインが提供する [ビルド] 機能を使用して、プロジェクトをコンパイルします。