Mobile Platform as a Service:ステップ 4：mPaaS 10.2.3 でのワイヤレスセキュリティガードとブルーシールドの切り替えサポート (オプション)

背景情報

ワイヤレスセキュリティガードのクライアント SDK は、ワイヤレスセキュリティガードのイメージサービスと連携し、mPaaS の基本的な依存機能の 1 つとして、mPaaS プロダクト全体で広く使用されています。さまざまなシナリオにおける mPaaS プロダクトの互換性をさらに向上させ、コンプライアンスなどの分野におけるより高い要件を満たすため、mPaaS はワイヤレスセキュリティガード機能の代替としてブルーシールド機能を導入しました。これにより、ワイヤレスセキュリティガードでは対応しきれないシナリオをサポートします。

現在の状況

mPaaS は、Android ベースラインバージョン 10.2.3.23 以降で、ワイヤレスセキュリティガードからブルーシールドへの切り替えをサポートするために必要な適応とテストを完了しました。ベースライン 10.1.68 またはそれ以前のバージョンをご利用の場合は、最新の 10.2.3 バージョンにアップグレードする必要があります。

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

ベースラインバージョンを 10.2.3.23 以降にアップグレードします。

現在のベースライン：10.1.68 メインベースライン

「mPaaS 10.2.3 アップグレードガイド」をご参照のうえ、最新の 10.2.3 ベースラインにアップグレードし、必要な適応を行ってください。

現行ベースラインはカスタムベースライン

カスタムベースラインをご利用の場合は、DingTalk グループ番号 145930007362 を検索してグループに参加してください。または、チケットを送信して、アフターセールスおよびテクニカルサポートスタッフに 10.2.3 ベースラインに切り替え可能かどうかご相談ください。

ツールチェーンのアップグレードとブルーシールドへの切り替え

Android Studio Flamingo | 2022.2.1 以降、および mPaaS プラグイン 3.0.230609 以降をインストールします。

ワイヤレスセキュリティガードコンポーネントの削除

app module の build.gradle ファイルで、gradle exclude を使用して securityguard-build 依存関係ライブラリを削除します。

configurations.all {
    exclude group: 'com.alipay.android.phone.thirdparty', module:
            'securityguard-build'
}

ブルーシールドコンポーネントの追加

ブルーシールドコンポーネント SDK の依存関係を追加します。

implementation 'com.mpaas.android:blueshield'// ブルーシールド SDK の依存関係

ログコンポーネント SDK の依存関係を追加します。

implementation 'com.mpaas.android:logging'// ログコンポーネント SDK の依存関係

easyconfig プラグインの依存関係をアップグレードします。

classpath 'com.android.boost.easyconfig:easyconfig:2.8.0'

ブルーシールドイメージの生成 (オプション)

.config ファイル内の absBase64Code に値があるか確認します。値がある場合は、このステップをスキップしてください。値がない場合は、以下の手順に従ってブルーシールドイメージを生成します。

下図の手順に従い、必要な情報を入力してブルーシールドイメージを生成します。

図の主な入力項目の説明：

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

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

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

• appSecret： mPaaS コンソールで表示します。下図をご参照ください。

  

• その他の項目 appId、packageName、outPath は、上記の情報が渡されると自動的に識別され、入力されます。

最後に、生成されたイメージをプロジェクトの assets フォルダに追加します。

ブルーシールドイメージが正常に構成されたかの確認

APK パッケージを Android Studio にドラッグし、APK の assets ディレクトリに abs_1222.jpg が存在するか確認します。存在する場合、ブルーシールドイメージは正常に構成されています。

ブルーシールドへの切り替え設定

meta-data を AndroidManifest.xml ファイルに追加します。

 <!--値の説明：antGroup はブルーシールドを指定します-->
        <meta-data
            android:name="mpaas_security_mode"
            android:value="antGroup"/>

ブルーシールドの更新をサポートするライブラリのリスト

• モバイルゲートウェイサービス

• モバイルスケジューリングセンター

• モバイル同期サービス

• マルチメディア

• Mini Program

• 位置情報サービス

• 統合ストレージ

• 一部の内部依存コンポーネント

• Ant Dynamic Card

テスト検証範囲

ブルーシールドに切り替えた後、上記の変更チェックリストを使用して、アプリの回帰テストを実行してください。