ConvivaSDK 框架

ConvivaSDK 框架支持 CocoaPods 和手动安装。该库以静态框架的形式提供，支持 iOS 12 及以上版本的部署。同时支持 iOS/tvOS 15。

从 2.141.0 以下版本迁移

对于已经集成了 Conviva 库 2.141.0 以下版本的客户，我们建议他们迁移到最新版本 2.141.0。请按照以下步骤将迁移到 2.141.0 版本：

1. 从 Xcode 的“链接二进制库”中移除 libiOSSdkCore.a
2. 从您的应用程序中移除以下头文件，并遵循 cocoaPods 或手动安装方式。
   • #import "CISSystemInterfaceProtocol.h"
   • #import "CISSystemFactoryProtocol.h"
   • #import "CISSystemSettings.h"
   • #import "CISClientSettingProtocol.h"
   • #import "CISClientProtocol.h"
   • #import "IOSSystemInterfaceFactory.h"
   • #import "CISSystemFactoryCreator.h"
   • #import "CISClientSettingCreator.h"
   • #import "CISClientCreator.h"
   • #import "CISConstants.h"
   • #import "CISPlayerStateManagerProtocol.h"

Cocoapods 安装

Add the following line to your pod file and run 'pod install'

// Without Advertising Identifier(IDFA) support
pod 'ConvivaSDK','4.0.39'

OR 

// With Advertising Identifier(IDFA) support
// Application must be built with XCode 12 or above.
// Application's plist file must have an entry for NSUserTrackingUsageDescription key with appropriate message.
// Example message:
// <key>NSUserTrackingUsageDescription</key>
// <string>App would like to access IDFA to uniquely identify the user.</string>

pod 'ConvivaSDK','4.0.38'

Swift 包管理工具安装

1. 将包依赖存储库 URL 添加为 https://github.com/Conviva/conviva-ios-sdk-spm
2. 选择版本：
   • 4.0.38（带有广告标识符支持）。
   • 4.0.39（没有广告标识符支持）。

手动安装

要将 ConvivaSDK 库手动添加到项目中

1. 从以下路径下载最新的 ConvivaSDK。

   • 没有广告标识符（IDFA）支持 或
   • 有广告标识符（IDFA）支持

2. 解压包并将 ConvivaSDK.xcframework 添加到构建阶段的 "链接二进制库" 中。

3. 将以下系统框架添加到 Xcode 的 "链接二进制库" 部分的 "CoreMedia"、"SystemConfiguration"、"MobileCoreServices"、"CoreTelephony（仅限 iOS）"、"Network（弱引用）"、"AVFoundation" 和 "AppTrackingTransparency（弱引用）"（仅适用于支持广告标识符的库，应用必须使用 XCode 12 或更高版本构建）。

   • CoreMedia
   • SystemConfiguration
   • MobileCoreServices
   • CoreTelephony (iOS only)
   • Network (weak)
   • AVFoundation
   • AppTrackingTransparency(weak) - 仅需支持广告标识符的库（应用必须使用 XCode 12 或更高版本构建）。

4. 将 “-ObjC” 添加到 Xcode 的 “其他链接器标志”。

导入语句

将以下导入语句添加到您的源代码中，以便引用 Conviva 类。

* @import ConvivaSDK; (Objective-C)
* import ConvivaSDK (Swift)

备注

• 请参考https://pulse.conviva.com/learning-center/content/sensor_developer_center/sensor_integration/ios/ios_stream_sensor.html获得集成指南。
• 请参考https://pulse.conviva.com/learning-center/content/sensor_developer_center/sensor_api/ios_api/index.html获得API文档。