背景

無線保鏢客戶端 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 加入釘釘群或提交工單咨詢對應的售后及技術支持人員，是否可切換到 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 進行回歸測試。