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 の最新のベースラインにスペックアップし、関連する適合を行ってください。

現在のベースラインがカスタムベースラインの場合

カスタムベースラインを使用している場合は、グループ番号 41708565 を検索して DingTalk グループに参加するか、チケットを送信して対応するアフターサービスおよびテクニカルサポーターに相談してください。

ツールチェーンのスペックアップとブルシールドの切り替え

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'

ブルシールド画像の生成 (プライベートクラウド環境の場合)

mPaaS コンソールからダウンロードした .config ファイル内の absBase64Code 値が空の場合は、次の手順を実行してBlue Shield イメージを生成します。

次の図に示すように、関連情報を入力してブルシールド画像を生成します。

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

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

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

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

• appSecret: 次の図に示すように、mPaaS コンソールで表示します。

  

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

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

Blue Shield イメージが正常に構成されていることを確認する

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

ブルシールドへの切り替えの構成

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

!" -- 値の説明: antGroup はブルシールドです -->
        <meta-data
            android:name="mpaas_security_mode"
            android:value="antGroup"/>

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

• モバイル ゲートウェイ

• モバイルディスパッチセンター

• データ同期

• マルチメディア

• ミニプログラム

• 位置情報サービス

• 統合ストレージ

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

• Ant Dynamic Card

テスト検証の範囲

ブルシールドの切り替えが完了したら、上記の変更リストに基づいてアプリの回帰テストを実行します。