Mobile Platform as a Service:mPaaS プラグインの使用

mPaaS プラグインは、グラフィカルインターフェイスを提供し、Android プロジェクトへの mPaaS の迅速な統合と各種機能の利用を支援します。

mPaaS プラグインには、ネイティブ AAR インテグレーション、コンポーネントベースのインテグレーション、基本ツール、ヘルプ、ビルド などの機能が含まれています。

• ネイティブ AAR インテグレーション と コンポーネントベースのインテグレーション：プロジェクトに mPaaS を追加するためのステップバイステップ形式のパネルです。統合後、同じパネルからベースラインのアップグレードやコンポーネントの管理を行うことができます。

• 基本ツール：ホットパッチ、暗号化画像の生成 (Apsara Stack 設定ファイル)、UC Key 署名情報の生成、ブルーシールド暗号化画像の生成 が含まれます。これらのツールを使用して、mPaaS 機能に必要なアセットを準備します。

• 基本ツール には、コンソール用署名付き APK の生成 も含まれます。これを使用して、完全なプロジェクトビルドが利用可能になる前に、署名パラメータから最小限の署名付き APK を生成します。

• ヘルプ：ログ診断ツール、よくある質問、ドキュメントの表示 が含まれます。問題が発生した際に、これらのツールを使用してサポートを受けることができます。

• ビルド：統合後にプロジェクトをビルドします。

ネイティブ AAR インテグレーション

手順

1. Android Studio でプロジェクトを開き、[mPaaS] > [ネイティブ AAR インテグレーション] を選択します。

2. アプリケーション設定をインポートします。統合パネルで [Start import] をクリックし、手動インポート の方法を使用して設定ファイルを追加します。

次のステップ

1. ベースラインの統合/アップグレード

2. コンポーネントの設定/更新

コンポーネントベースのインテグレーション

手順

1. Android Studio でプロジェクトを開き、[mPaaS] > [コンポーネントベースのインテグレーション] を選択します。

2. アプリケーション設定をインポートします。統合パネルで [Start import] をクリックし、手動インポート の方法を使用して設定ファイルを追加します。

3. プロジェクトを変換します。プロジェクトがネイティブ Android プロジェクトの場合、統合パネルで [Install mPaaS Portal] をクリックします。[Install mPaaS Portal] ウィンドウで、元のプロジェクトの場所と設定ファイルを選択し、[OK] をクリックします。

次のステップ

1. ベースラインの統合/アップグレード

2. コンポーネントの設定/更新

ベースラインの統合/アップグレード

通常のベースラインへのアップグレード

手順

1. [mPaaS] > [ネイティブ AAR インテグレーション] または [コンポーネントベースのインテグレーション] を選択します。統合パネルで、[Integrate/Upgrade baseline] の下にある [Start configuration] をクリックします。

2. 対象のベースラインバージョンを選択し、[OK] をクリックします。アップグレードが成功すると、成功メッセージが表示されます。

次のステップ

統合パネルで [Upgrade baseline] をクリックし、新しいベースラインのバージョン番号を確認します。

カスタムベースラインへのアップグレード

標準ベースライン (10.1.32、10.1.60、10.1.68 など) は、すべてのお客様で共有されています。mPaaS 機能をカスタマイズするには、mPaaS の担当者に要件を提出してください。mPaaS チームがカスタムベースラインを作成し、カスタムベースライン ID を提供します。このプラグインでこの ID を入力して、カスタムベースラインを取得します。

前提条件

Android Studio mPaaS プラグインのバージョンが V2.19111217 以降である必要があります。現在のバージョンを確認してプラグインをアップグレードする方法については、「mPaaS プラグインの更新」をご参照ください。

手順

1. Android Studio プロジェクトから mpaas_package.json ファイルを削除します。

2. [mPaaS] > [ネイティブ AAR インテグレーション] または [コンポーネントベースのインテグレーション] を選択します。統合パネルで、[Integrate/Upgrade baseline] の下にある [Start configuration] をクリックします。

3. [Baseline Upgrade] ダイアログボックスで、[Custom baseline] チェックボックスを選択し、受け取ったカスタムベースライン ID を入力します。

4. [OK] をクリックして、カスタムベースラインをインポートします。

コンポーネントの設定/更新

mPaaS コンポーネント管理 (AAR)

前提条件

ベースラインのアップグレードが完了していること。

手順

1. [mPaaS] > [ネイティブ AAR インテグレーション] を選択します。統合パネルで、[Configure/Update components] の下にある [Start configuration] をクリックします。

2. 管理ウィンドウで、[mPaaS Component Management] をクリックします。管理するモジュールを選択し、追加するコンポーネントを選択して、[OK] をクリックします。プロジェクトに複数のモジュールがある場合は、各モジュールを個別に設定してください。

3. コンポーネントを追加した後、[OK] をクリックします。

コンポーネント管理

手順

1. [mPaaS] > [コンポーネントベースのインテグレーション] を選択します。統合パネルで、[Configure/Update components] の下にある [Start configuration] をクリックします。

2. [Component Management] ウィンドウで、ボタンをクリックして必要なコンポーネントをインストールします。

暗号化画像の生成 (Apsara Stack 設定ファイル)

セキュリティ上の理由から、一部の mPaaS コンポーネントは、ネットワークにアクセスする際にコンテンツを暗号化する必要があります。

• yw_1222.jpg という特別な名前の画像が、暗号化と復号化のキーを提供します。 mPaaS コンポーネントは、この画像を暗号化と復号化に自動的に使用するため、追加の操作は必要ありません。

• この暗号化画像は、パブリッククラウド環境では非推奨です。パブリッククラウドユーザーは、このセクションをスキップできます。

前提条件

暗号化画像は APK 署名に紐付けられています。続行する前に、Portal プロジェクト用の署名付き APK を準備してください。署名手順については、Android 開発者サイトの「アプリへの署名」をご参照ください。

手順

mPaaS プラグインを使用して暗号化画像を生成します。

1. Android Studio で、[mPaaS] > [基本ツール] > [暗号化画像の生成 (Apsara Stack 設定ファイル)] を選択します。

2. [Release Apk] フィールドで、Portal プロジェクトの署名付き APK ファイルを選択します。[RSA] フィールドは自動的に入力されます。

3. [mPaaS 設定ファイル] フィールドで、Portal プロジェクトの .config ファイルを選択します。 workSpaceId、appId、および packageName フィールドは自動的に入力されます。 入力されない場合は、プロジェクトの .config ファイルから入力します。

4. appsecret を入力します。

   注： サーバー側の管理者として、コンソールで appid に対応する appsecret を照会してください。

5. [jpg Version] フィールドに、Security Guard 画像のバージョン番号を入力します。

   説明

   Portal プロジェクトのメインモジュールの build.gradle ファイルで securityguard のバージョンを確認します。バージョンが 5.4 未満の場合は、4 を入力します。たとえば、ベースラインで securityguard-build:5.1.38.180402194514 が提供されている場合は、4 を入力します。それ以外の場合は、5 を入力します。

6. [outPath] フィールドで、yw_1222.jpg のローカルの出力パスを選択します。

7. [OK] をクリックして、暗号化画像を生成します。

使用方法

1. yw_1222.jpg を Portal プロジェクトの res/drawable フォルダーに保存します。

2. ProGuard を使用する場合、暗号化画像が難読化されないようにしてください。

   1. build.gradleに、以下が設定されているか確認します。

      minifyEnabled true
      shrinkResources true

   2. この設定が存在する場合、暗号化された画像を難読化から除外するには、keep.xml ファイルを res/raw ディレクトリに作成します:

      <?xml version="1.0" encoding="utf-8"?>
      <resources xmlns:tools="http://schemas.android.com/tools"
      tools:keep="@drawable/yw_1222*" /><!--tools:discard="@layout/unused2"-->

ブルーシールド暗号化画像の生成

mPaaS コンソールからダウンロードした .config ファイル内の absBase64Code の値が空の場合は、[ブルーシールドイメージの生成] 操作を実行してください。これは Apsara Stack のシナリオに適用されます。

[mPaaS] > [基本ツール] > [ブルーシールド暗号化画像の生成] を選択し、必要な情報を入力して画像を生成します。

主なパラメータ：

• [Release Apk]：mPaaS が統合されたプロジェクトの署名付きリリース APK。

• MD5: リリース APK をアップロードすると、自動的に入力されます。これは APK パッケージの public md5 key です。

• mPaaS 設定ファイル: mPaaS コンソールで[設定のダウンロード]をクリックしてダウンロードした.config ファイルを、ここで指定します。

• [appSecret]：この値は mPaaS コンソールで確認してください。

• appId、packageName、outPath は、上記の情報を入力すると、自動的に検出され入力されます。

生成された画像をプロジェクトの assets ディレクトリに追加します。

コンソール用署名付き APK の生成

mPaaS コンソールから設定ファイルを取得する際、署名付き APK をアップロードする必要があります。まだプロジェクトを作成していない、または署名付き APK をコンパイルしていない場合、この要件のために作業を進めることができません。[コンソール用署名付き APK の生成] 機能は、署名関連のパラメータのみを使用して署名付き APK を生成することで、この問題を解決します。

生成

1. [mPaaS] > [基本ツール] > [コンソール用署名付き APK の生成] を選択して、[Construct Signed APK] ページを開きます。

2. 必要な設定情報を入力します。

3. [OK] をクリックして、署名付き APK ファイルを生成します。

4. [Finder で表示] をクリックして、生成されたファイル mpaas-signed.apk を特定します。

   この APK ファイルは小さく、すでに署名されています。

UC Key 署名情報の生成

UC SDK の統合により、さまざまなベンダーのブラウザとの互換性の問題が解決されます。UC SDK を追加する前に、UC SDK の承認を申請してください。この機能は、承認を迅速に取得するのに役立ちます。以下のセクションでは、UC SDK 承認を申請するためのエンドツーエンドの手順について説明します。

手順

1. プロジェクトに UC Kernel (UCCORE) 依存関係を追加します。

2. アプリケーションの Android ネイティブパッケージ名を提供します。

3. [mPaaS] > [基本ツール] > [UC Key 署名情報の生成] を選択して、[Query Signature Information] ページを開きます。

4. 必要な設定情報を入力し、[Next] をクリックします。

5. 取得した SHA1 情報をコピーします。

6. UC キー申請フォーム に記入して送信します。

   説明

   製品戦略の変更により、UC は公開申請を受け付けなくなりました。2022 年 12 月 1 日以降、UC Keys の公開申請はサポートされていません。関連情報をフォームに記入してください。mPaaS チームが申請内容を確認し、フィードバックを返します。

7. 取得したキーを Portal プロジェクトの AndroidManifest.xml ファイルに追加します: <meta-data android:name="UCSDKAppKey" android:value="申請したキー"/>。

   説明

   UC SDK 承認は、APK の パッケージ名 と 署名 に紐付けられています。UCWebView が動作しない場合、署名とパッケージ名が申請時に使用したものと一致していることを確認してください。

ヘルプ

ログ診断ツール

1. [mPaaS] > [ヘルプ] > [ログ診断ツール] を選択します。

2. ログの内容を入力ボックスに貼り付けて、[Next] をクリックします。

3. 分析が完了するまで待ちます。

4. 結果を確認します。各結果には 原因 と 解決策 が含まれています。提供された具体的な情報に基づいてコードを更新してください。

5. 変更を行った後、[Finish] をクリックしてウィンドウを閉じます。

よくある質問

[mPaaS] > [ヘルプ] > [よくある質問] を選択して、「Android 統合のよくある質問」を開きます。ここには、統合中に発生する一般的な問題が記載されています。

ドキュメントの表示

[mPaaS] > [ヘルプ] > [ドキュメントの表示] を選択して、「mPaaS ドキュメントセンター」を開き、各コンポーネントのドキュメントを参照します。

ビルド

Android Studio で、[mPaaS] > [ビルド] を選択して、プロジェクトをビルドします。