Mobile Platform as a Service：步驟 4 mPaaS 10.2.3 支援無線保鏢&藍盾切換（可選）

背景

無線保鏢用戶端 SDK 與無線保鏢圖片搭配作為 mPaaS 的基礎依賴能力之一，在 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群或提交工單諮詢對應的售後及技術支援人員，是否可切換到 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'

產生藍盾圖片（適用於私人雲端情境）

如果您從 mPaaS 控制台下載的 .config 檔案中的 absBase64Code 值為空白，則需進行下面 產生藍盾圖片 的操作。

按下圖步驟填寫相關資訊進行操作即可產生藍盾圖片：

上圖中的重點輸入項說明：

• Release Apk : 接入 mPaaS 的工程打包出的 release apk 包，需要進行簽名。

• MD5: release apk 包上傳之後會自動擷取填入，即 apk 包的 public md5 key。

• mPaaS config File: mPaaS 控制台點擊下載配置即可下 .config 檔案並傳入。

• appSecret：mPaaS 控制台查看，如下圖位置。

  

• 其他項 appId、packageName、outPath 傳入以上資訊後會自動識別填入。

最後將產生的圖片添加到工程的 assets 目錄下。

檢查藍盾圖片是否配置成功

將 apk 包拖到 Android Studio 中看 apk 的 assets 目錄裡面是否有 abs_1222.jpg ，如有，則藍盾圖片配置成功。

配置切換藍盾

在 AndroidManifest.xml 檔案中添加 meta-data 。

 <!--value值說明：antGroup是藍盾-->
        <meta-data
            android:name="mpaas_security_mode"
            android:value="antGroup"/>

支援藍盾更新的庫清單

• 移動網關

• 移動調度中心

• 資料同步

• 多媒體

• 小程式

• 定位服務

• 統一儲存

• 部分內部相依元件

• 螞蟻動態卡片

測實驗證範圍

在完成切換藍盾後，根據上述變更清單對 App 進行迴歸測試。