添加 SDK

重要：自 2020 年 6 月 28 日起，mPaaS 停止维护 10.1.32 基线。请使用 10.1.68 或 10.1.60 系列基线。可以参考 mPaaS 10.1.68 升级指南 或 mPaaS 10.1.60 升级指南 进行基线版本升级。

要在 iOS 客户端集成智能投放功能，需要在 iOS 工程中添加智能投放 SDK，并完成工程配置。

前置条件

您已接入工程到 mPaaS。更多信息，请参见以下内容：

添加 SDK

根据您采用的接入方式，请选择相应的添加方式。

使用 mPaaS Xcode Extension 插件

此方式适用于 基于 mPaaS 框架接入 或 基于已有工程且使用 mPaaS 插件接入 的接入方式。

  1. 点击 Xcode 菜单项 Editor > mPaaS > 编辑工程，打开编辑工程页面。
  2. 选择 智能投放，保存后点击 开始编辑，即可完成添加。
    CDP

使用 cocoapods-mPaaS 插件

此方式适用于 基于已有工程且使用 CocoaPods 接入 的接入方式。

  1. 在 Podfile 文件中，使用 mPaaS_pod "mPaaS_CDP" 添加智能投放组件依赖。
    cdp
  2. 执行 pod install 即可完成接入。

配置工程

  1. 在 MobileRuntime.plist 中添加 H5Service 和 NebulaAppService 服务。
    配置工程

  2. 启动下载通道 netctrl。

    说明：建议将代码添加到 -(void)application:(UIApplication *)application beforeDidFinishLaunchingWithOptions:(NSDictionary *)launchOptions，必须保证在启动智能投放组件之前启动下载通道。
    1.  // 启动netctrl
    2.  [[MASSAccess shareInstance] dispatchTokenSvrInfo:nil
    3.                                      uploadInfo:nil
    4.                                    downloadInfo:nil
    5.                              downloadInfoCrypto:nil
    6.                                   configStorage:nil];

  3. 配置 H5 容器。
    在 H5 页面上的投放依赖 H5 容器，并需要对 Nebula 容器进行初始化。必须在 DTFrameworkInterface 的 - (void)application:(UIApplication *)application beforeDidFinishLaunchingWithOptions:(NSDictionary *)launchOptions 中进行初始化。

    1.  // 配置容器
    2.  [MPNebulaAdapterInterface initNebula];

  4. 注册智能投放系统的容器插件。
    具体操作步骤，参见 自定义插件 中注册插件的步骤，并且按照下图中的信息注册智能投放系统所使用的容器插件。
    注册容器插件