背景

無線保鏢客戶端 SDK 與無線保鏢圖片搭配作為 mPaaS 的基礎依賴能力之一，在 mPaaS 產品中廣泛使用，為了進一步提升 mPaaS 產品在各類場景下的兼容性以及滿足更高的合規等方面的要求，mPaaS 提供藍盾能力作為無線保鏢能力的替代方案，以支持無線保鏢無法滿足的場景。

現狀

目前 mPaaS 已在 iOS 10.2.3.25 及以上的基線版本中完成支持無線保鏢切換藍盾的適配和測試工作，使用 10.1.68 基線或更早的基線請升級到 10.2.3 最新版本。

升級基線

將基線版本升級到 10.2.3.25 及以上。

當前基線為 10.1.68 主基線

請先參考 mPaaS 10.2.3 適配 Xcode14 升級到 10.2.3 最新基線并進行相關適配。

當前基線為定制基線

如果您使用的是定制基線，請搜索群號 41708565 加入釘釘群或提交工單咨詢對應的售后及技術支持人員，是否可切換到 10.2.3 基線。

升級方式

基于 CocoaPods 升級

按照以下步驟，即可安裝 10.2.3 版本的最新 SDK：

1. 首先確保 Podfile 中 mPaaS 組件的版本號為 10.2.3。

2. 執行 pod mpaas update 10.2.3。

   如果提示命令報錯，需通過 pod mpaas update --all 命令先更新插件，再重新執行。

3. 執行 pod install。

升級工具鏈&切換藍盾

使用 mPaaS Extension

移除無線保鏢組件

按照下圖操作移除無線保鏢：

添加藍盾組件

按照下圖操作添加藍盾：

生成藍盾圖片

按照下圖操作生成藍盾圖片：

將藍盾圖片添加到工程目錄下：

使用 mPaaS CocoaPods Plugin

使用如下命令安裝或升級插件：

sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

使用如下命令查看插件版本：

pod plugins installed

如上圖中 0.9.6 即為插件版本，插件使用細節可查看 基于已有工程且使用 CocoaPods 接入 文檔。

移除無線保鏢組件

1. 在 podfile 中添加 remove_pod "mPaaS_Security"。

2. podfile 中如果有 mPaaS_pod "mPaaS_Security"，則將其移除。

3. 如需移除無線保鏢圖片，需先在項目中刪除 yw_1222.jpg 圖片，并且在 mPaaS 配置文件meta.config 中移除 base64Code、v6Base64Code 兩個字段（如存在）。

添加藍盾組件

在 podfile 中添加 mPaaS_pod "mPaaS_BlueShield"。

生成藍盾圖片

在 meta.config 文件中添加 absBase64Code 參數， 按照 mPaaS cocoaPods Plugin 進行 pod install 操作。如圖所示，abs_1222 就是生成的藍盾圖片。

代碼切換藍盾

添加 MPSignatureInterface 的分類，并重寫 securityComponentType 方法返回MPSecurityComponentTypeBS，MPSignatureInterface 的分類中需導入 #import <MPSignatureAdapter/MPSignatureAdapter.h> 頭文件。

支持藍盾更新的庫清單

• 移動網關

• 移動調度中心

• 數據同步

• 多媒體

• 小程序

• 熱修復

• 大數據通道

• 部分內部依賴組件

測試驗證范圍

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