iOS 动态库升级指南

本文为您介绍 iOS 推/拉流 SDK 动态库升级步骤。您可以按照本文所述步骤，将 1.40.1 及以前版本的动态库或任一版本的静态库升级至 1.40.2 及以后版本的动态库。

新版本优势

与 1.40.1 及以前版本相比，新版本动态库具备以下优势：

• SDK 包体积更小。

• 对齐静态库依赖，方便动/静态库迁移切换。

• 优化集成方式，规范头文件引入方式，对齐系统标准动态库。

旧版本动态库升级

如果您已经集成了 1.40.1 及以前版本的 iOS 推/拉流 SDK 动态库，您可以按照以下步骤，将其升级至 1.40.2 及之后版本的动态库。

1. 保持原有的 CocoaPods 集成方式。如您需要精简包大小，可以根据 iOS 集成指南修改子组件名称。例如，在集成基础拉流功能时，您可以将subspecs => ["BasePull"] 修改为 subspecs => ["LivePull"]。

2. 为避免升级后出现头文件导入错误，您可以按如下两种方式修改工程代码：

   1. 方式一：修改头文件引入方式。

      • 如果您的引入方式为 #import <xxx/xxx.h> ，请将其批量替换为 #import <TTSDKFramework/xxx.h>。

      • 如果您使用了独立库的单独文件，例如 #import <TTSDKPUFramework/TTSDKPUFramework.h>，请将其替换为 #import <TTSDKFramework/TTSDKFramework.h>。

   2. 方式二：增加环境变量，不修改头文件引入方式。在 Podfile 文件中增加以下环境变量设置：ENV['TTSDK_FRAMEWORK_MODULE_NAME'] = '原来的 Framework 名称'

新旧版本静态库切换至新版本动态库

如果您已经集成了 iOS 推/拉流 SDK 静态库，您可以按照以下步骤，将其切换至 1.40.2 及之后版本的动态库。

1. 修改 Cocoapods 集成方式，将 Pod 名称由 TTSDK 修改 TTSDKFramework。例如，将 pod 'TTSDK', :subspecs => ['LivePull-RTS'] 修改为 pod 'TTSDKFramework', :subspecs => ['LivePull-RTS']。

2. 修改头文件引入方式：

   1. 如果您的引入方式为 #import "xxx.h"，则无需修改任何代码。

   2. 如果您的引入方式为 #import <TTSDK/xxx.h>，您可以按照以下两种方式修改工程代码：

      1. 方式一（推荐）：在 Podfile 文件中增加以下环境变量设置：ENV['TTSDK_FRAMEWORK_MODULE_NAME'] = 'TTSDK'

      2. 方式二：将 #import <TTSDK/xxx.h> 批量替换为 #import <TTSDKFramework/xxx.h>。