All Products
Search

This Product

    Mobile Platform as a Service:mPaaS 10.2.3 Support Wireless Bodyguard&Blue Shield Switch

    Document Center

    Mobile Platform as a Service:mPaaS 10.2.3 Support Wireless Bodyguard&Blue Shield Switch

    Last Updated:Jul 03, 2023

    Background information

    The matching of wireless bodyguard client SDK and wireless bodyguard pictures is one of the basic dependency capabilities of mPaaS and is widely used in mPaaS products. In order to further improve the compatibility of mPaaS products in various scenarios and meet higher compliance requirements, mPaaS provides Blue Shield capability as an alternative to wireless bodyguard capability to support scenarios that wireless bodyguards cannot meet.

    Current situation

    At present, mPaaS has completed the adaptation and testing of supporting wireless bodyguard switching Blue Shield in the baseline version of iOS 10.2.3.25 and above. If you use the baseline of 10.1.68 or earlier, please upgrade to the latest version of 10.2.3.

    Upgrade Baseline

    Upgrade the baseline version to 10.2.3.25 or later.

    Current baseline is 10.1.68 primary baseline

    Please refer to mPaaS 10.2.3 adaptation Xcode14 to upgrade to the latest baseline of 10.2.3 and make relevant adaptation.

    The current baseline is a custom baseline

    If you are using a custom baseline, search for the group number 41708565 to join the DingTalk group or submit a ticket to consult the corresponding after-sales and technical helpdesk.

    Update method

    CocoaPods-based upgrade

    Follow these steps to install the latest SDK of the 10.2.3 version:

    1. First, make sure that the version number of the mPaaS component in the Podfile is 10.2.3.

    2. Execute the pod mpaas update 10.2.3.

      If a command error is reported, run the pod mpaas update --all command to update the plug-in and then run the command again.

    3. Execute the pod install.

    Upgrade Toolchain&Switch Blue Shield

    Use mPaaS CocoaPods Plugin

    Run the following command to install or upgrade the plug-in:

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

    Run the following command to view the version of the plug-in:

    pod plugins installed
    image.png

    The 0.9.6 in the preceding figure shows the version of the plug-in. For more information, see Use CocoaPods to access the plug-in based on an existing project.

    Remove the wireless bodyguard component

    1. Add remove_pod "mPaaS_Security" to the podfile.

    2. If there are mPaaS_pod "mPaaS_Security" in the podfile, remove them.

    3. To remove the wireless bodyguard image, you must first delete the yw_1222.jpg image from the project and remove the base64Code and v6Base64Code fields (if present) from the mPaaS configuration file meta.config.

    Add a Blue Shield component

    Add mPaaS_pod "mPaaS_BlueShield" to the podfile.

    Generate a Blue Shield image

    Add the absBase64Code parameter in the meta.config file, and perform pod install operations according to the mPaaS cocoaPods Plugin. As shown in the figure, abs_1222 is the generated blue shield image.

    image.png

    Code Switching Blue Shield

    Add the MPSignatureInterface classification and rewrite the securityComponentType method to return the MPSecurityComponentTypeBS. The #import <MPSignatureAdapter/MPSignatureAdapter.h> header file needs to be imported in the MPSignatureInterface classification.

    image.png

    List of libraries that support Blue Shield updates

    • Mobile Gateway Service

    • mobile dispatching center

    • Data synchronization

    • Multimedia

    • Mini program

    • Hotpatch

    • Big tunnel

    • Some internal dependent components

    Scope of test verification

    After the Blue Shield switch is completed, perform a regression test on the app based on the preceding change list.