背景
无线保镖客户端 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 基线。
升级方式
基于 Extension 插件升级
使用 mPaaS Xcode Extension 插件升级 SDK/组件,您可以选择以下两种方式:
您需要根据自身情况选择升级方式。如果您:
基于 CocoaPods 升级
按照以下步骤,即可安装 10.2.3 版本的最新 SDK:
首先确保 Podfile 中 mPaaS 组件的版本号为 10.2.3。
执行
pod mpaas update 10.2.3
。如果提示命令报错,需通过
pod mpaas update --all
命令先更新插件,再重新执行。执行
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 接入 文档。
移除无线保镖组件
在 podfile 中添加
remove_pod "mPaaS_Security"
。podfile 中如果有
mPaaS_pod "mPaaS_Security"
,则将其移除。如需移除无线保镖图片,需先在项目中删除
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 进行回归测试。