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

mPaaS プラグインは、ネイティブ AAR アクセス、コンポーネント化アクセス、基本ツール、ヘルプ、および ビルド の機能を提供します。

• ネイティブ AAR アクセス 機能と コンポーネント化アクセス 機能にはアクセス パネルが用意されています。アクセス パネルのアクセス ウィザードでは、特定のアクセス モードでプロジェクトに mPaaS を追加できます。アクセスが完了すると、アクセス パネルでベースラインを更新したり、コンポーネントを管理したりすることもできます。

• mPaaS プラグインは、基本ツール として、暗号化イメージの生成 (Apsara Stack 構成ファイル)、署名付き APK の生成、UC キー署名情報の生成 を提供します。これらのツールは、mPaaS 機能を簡単に使用するために必要な情報を準備するのに役立ちます。

• mPaaS プラグインは、ヘルプ 機能として、ログ診断ツール、よくある問題、ドキュメントの表示 を提供し、一般的な問題のトラブルシューティングをサポートします。

• ビルド では、mPaaS にアクセスした後にプロジェクトをビルドできます。

構成ファイルの追加

アクセス プロセスの主な作業は、プロジェクトに構成ファイルを追加することです。 mPaaS プラグインは、構成ファイルを追加するための 手動インポート をサポートしています。手動インポートの場合は、コンソールで構成ファイルをダウンロードし、mPaaS プラグインを使用して手動でプロジェクトに追加する必要があります。

AAR アクセス

手順

1. Android Studio で既存のプロジェクトを開き、mPaaS > [Native AAR アクセス] をクリックします。

2. アプリ構成をインポートします。アクセス パネルで、インポート開始手動インポート をクリックし、「」に従って構成ファイルを追加します。

後続の手順

1. ベースラインの追加と更新

2. コンポーネントの構成と更新

コンポーネント化アクセス

手順

1. Android Studio で既存のプロジェクトを開き、 [mPaaS] > [コンポーネント化アクセス] をクリックします。

2. アプリ構成をインポートします。

   アクセス パネルで、インポート開始構成ファイルを追加する をクリックし、「」に従って構成ファイルを追加します。

3. プロジェクトを変換します。プロジェクトがネイティブ Android プロジェクトの場合は、プロジェクトを変換する必要があります。

   アクセス パネルで、[mPaaS ポータルのインストール] をクリックします。 mPaaS ポータルをインストールするOK ウィンドウで、元のプロジェクトの場所と構成ファイルを選択し、 をクリックします。

後続の手順

1. ベースラインの追加と更新

2. コンポーネントの構成と更新

ベースラインの追加と更新

共通ベースラインへの更新

手順

1. mPaaSネイティブ AAR アクセスコンポーネント化アクセス開始設定 > または をクリックしてアクセス パネルを開きます。次に、[ベースラインへのアクセス/更新] の下の をクリックします。

2. 更新するベースラインバージョンを選択し、 [OK] をクリックします。更新が完了すると、成功メッセージが表示されます。

後続の手順

アクセス パネルで更新されたベースラインをクリックします。ベースライン選択ウィンドウにベースライン バージョンが表示されます。

カスタム ベースラインへの更新

10.1.32、10.1.60、10.1.68 など、すべてのお客様に固有のベースラインを提供しています。カスタム mPaaS 機能が必要な場合は、担当者にご連絡の上、リクエストを送信してください。ご要望に応じてベースラインをカスタマイズいたします。 mPaaS 担当者がカスタム ベースラインの ID をお届けします。この ID を mPaaS プラグインに入力すると、カスタム ベースラインを取得できます。

前提条件

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

手順

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

2. mPaaSネイティブ AAR アクセスコンポーネントベースのアクセス開始設定 > または をクリックしてアクセス パネルを開きます。次に、[ベースラインの追加と更新] の下の をクリックします。

3. ベースライン更新ダイアログで、カスタム ベースライン を選択し、カスタム ベースライン ID を入力します。

4. [OK] をクリックします。カスタム ベースラインが追加されます。

コンポーネントの構成と更新

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

前提条件

ベースラインを更新している。

手順

1. mPaaS > ネイティブ AAR アクセス をクリックして、アクセス パネルを開きます。次に、[構成とコンポーネントの更新] の下の [構成の開始] をクリックします。

2. 表示された管理ウィンドウで、mPaaS コンポーネント管理OK をクリックします。次に、管理するモジュールとコンポーネントを選択し、 をクリックします。プロジェクトに複数のモジュールが含まれている場合は、個々のモジュールを選択し、各モジュールにコンポーネントをそれぞれ選択できます。

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

コンポーネント管理

手順

1. mPaaSコンポーネントベースのアクセス開始設定 > をクリックしてアクセス パネルを開きます。次に、[コンポーネントの構成と更新] の下の をクリックします。

2. 表示されたコンポーネント管理ウィンドウで、対応するボタンをクリックして必要なコンポーネントをインストールします。

暗号化イメージの生成 (Apsara Stack 構成ファイル)

mPaaS プラグインの一部のコンポーネントがネットワークにアクセスする場合、セキュリティを確保するためにコンテンツを暗号化する必要があります。

• yw_1222.jpg という名前のイメージは、暗号化と復号のための秘密キーを提供します。 mPaaS プラグインのコンポーネントは、このイメージを暗号化と復号に自動的に使用します。

• この暗号化イメージはパブリック クラウド環境では非推奨になっているため、パブリック クラウド ユーザーはこのセクションを無視できます。

以下では、暗号化イメージ yw_1222.jpg を生成して使用する方法について説明します。

準備

暗号化イメージは APK 署名ファイルにバインドされています。したがって、Portal プロジェクトの署名付き APK を準備する必要があります。署名の詳細な手順については、「Android 公式 Web サイト: アプリの署名」をご参照ください。

説明

この APK は、リリース バージョン APK と同じ署名ファイルを使用します。

生成された暗号化イメージは、この APK プロジェクトでのみ使用できます。

生成

mPaaS プラグイン を使用して暗号化イメージを生成できます。

1. Android Studio で、mPaaS > 基本ツール > [暗号化イメージ (Apsara Stack 設定ファイル) の生成] をクリックします。

2. リリース APK で、Portal プロジェクトの署名済み APK を選択します。 RSA フィールドは自動的に塗りつぶされます。

3. mPaaS 構成ファイル.configワークスペース IDappIdpackageName.config で、Portal プロジェクトの ファイルを選択します。 、、 フィールドは自動的に設定されます。これらのフィールドが自動的に設定されない場合は、プロジェクトの ファイルの内容に従って対応する構成を入力します。

4. appsecret フィールドに入力します。

   説明

   サーバー管理者として、コンソールで appid に対応する appsecret をクエリできます。

5. jpg バージョン フィールドに、セキュリティガード イメージのバージョン番号を入力します。

   説明

   Portal プロジェクトのメイン モジュールの下にある build.gradle ファイルで securityguard のバージョンを確認します。バージョンが 5.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. 含まれている場合は、暗号化イメージの混同を避けるために、res/raw の下に keep.xml ファイルを作成する必要があります。ファイルの内容は次のとおりです。

      <?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 値が空の場合は、次の手順を実行して ブルー シールド イメージを生成 します。

[mPaaS] > [基本ツール] > [ブルー シールド暗号化画像の生成] をクリックし、関連情報を入力してブルー シールド イメージを生成します。

上の図の主要な入力項目の説明:

• リリース Apk: mPaaS プロジェクトによってパッケージ化されたリリース apk パッケージ。パッケージに署名する必要があります。

• MD5: リリース apk パッケージがアップロードされると、自動的に設定されます。つまり、apk パッケージの パブリック md5 キー です。

• mPaaS 構成ファイル: mPaaS コンソールで [構成のダウンロード] をクリックして .config ファイルをダウンロードし、インポートします。

• appSecret: mPaaS コンソールで表示します。

• その他の項目 appIdpackageNameoutPath、、 は、上記の情報が渡されると自動的に識別され、設定されます。

最後に、生成されたイメージをプロジェクトの assets ディレクトリに追加します。

署名付き APK の生成

mPaaS コンソールで構成ファイルを取得しようとすると、署名付き APK ファイルをアップロードする必要があります。プロジェクトを作成していないか、署名付き APK をコンパイルしていない場合は、手順が一時停止されます。 mPaaS プラグインは、Android Studio でこの手順を簡素化するために 署名付き APK の生成 機能を提供します。この機能は、APK 署名に必要なパラメータを入力すると、署名付き APK を生成できます。

生成

1. mPaaS > 基本ツール > コンソールで使用する署名付き APK の生成 をクリックして、署名付き APK のビルド ページを開きます。

2. [署名付き APK のビルド] ページで、必要な構成情報を入力します。

3. [OK] をクリックします。署名付き APK が生成されます。

4. [Finder で表示]mpaas-signed.apk をクリックします。生成された APK ファイルを見つけることができます。ファイル名は です。署名付き APK の生成が完了しました。

   APK ファイルを開きます。ファイルが小さく、署名されていることがわかります。

ヘルプ

ログ診断ツール

1. mPaaS > ヘルプ > ログ診断ツール をクリックします。

2. テキストボックスに分析するログをコピーして貼り付け、[次へ] をクリックします。

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

4. 分析結果を表示します。

   分析結果には、原因 と 解決策 が含まれています。問題が見つかった場合は、原因と解決策に従ってコードを変更できます。

5. 変更後、[完了] をクリックしてウィンドウを閉じます。

よくある質問

mPaaS > ヘルプ > 一般的な問題 をクリックして、Android アクセスの一般的な問題 に移動します。 Android アクセス時に発生する可能性のある一般的な問題を確認できます。

ドキュメントの表示

mPaaS > ヘルプ > ドキュメントを表示 をクリックして、mPaaS ドキュメントセンター に移動します。すべてのコンポーネントのドキュメントを表示できます。

ビルド

Android Studio で、mPaaS > ビルド を選択します。その後、プロジェクトをビルドできます。