自 1.40.2 版本起，iOS 播放器 SDK 升级了动态库。与旧版本动态库相比，新版本动态库具有以下优势：

• 实现包的精细化拆分，以精简下载包的大小。
• 对齐静态库的依赖关系，便于动态库和静态库的迁移切换。
• 优化集成方式，规范头文件的引入方式，并与系统标准动态库对齐。

本文为您介绍如何升级至新版本动态库。

从旧版本动态库升级至新版本动态库 #

如果您在 1.40.2 版本之前使用的是动态库，可按照以下步骤，将其升级至 1.40.2 及之后版本的动态库。

1. 保留 Podfile 文件中 CocoaPods 集成方式。如需精简下载包的大小，可指定 subspecs 字段，例如 :subspecs => ['Player-SR'] 表示仅使用点播相关能力。
2. 如果升级 SDK 后，您遇到找不到头文件的报错，可按如下两种方式处理：
   • 方式一：修改代码中的 import 方式
     • 如果您先前使用 #import <原模块名/头文件名.h> 引入 TTSDK 头文件，请将模块名改为 TTSDKFramework，保留实际头文件名。这里的“原模块名”和“头文件名”仅表示格式，不是要搜索的字面字符串；只修改 TTSDK 的引用，不要替换其他库的 import。
     • 如果您先前使用了独立库的单独文件，例如 #import <TTSDKPUFramework/TTSDKPUFramework.h>，需替换成 #import <TTSDKFramework/TTSDKFramework.h>。
   • 方式二：不修改代码中的 import 方式
     如果您不想修改头文件依赖方式，则需在 Podfile 文件中增加以下环境变量： ENV['TTSDK_FRAMEWORK_MODULE_NAME'] = '原来的 Framework 名称'

从静态库切换至新版本动态库 #

如果您此前使用的是静态库，可参考以下步骤切换至新版本动态库：

1. 将 Podfile 文件中 CocoaPods 集成方式修改成以下：

   pod 'TTSDKFramework', :subspecs => ['Player-SR']
   

2. 如果您通过 #import "xxx.h" 方式引入头文件，则无需修改任何代码。但是如果您通过 #import <TTSDK/xxx.h> 方式引入头文件，可按如下两种方式处理：

   • 方式一（推荐）：在 Podfile 文件中增加环境变量 ENV['TTSDK_FRAMEWORK_MODULE_NAME'] = 'TTSDK'。
   • 方式二：查找项目中以 #import <TTSDK/ 开头的引用，逐项确认后改为 #import <TTSDKFramework/TTSDKFramework.h>。这里的 xxx.h 表示实际头文件名，不应作为字面字符串搜索。

subspecs 字段与能力的对应关系 #

集成 iOS SDK 时，您可以在 Podfile 中使用 subspecs 字段指定集成你需要的库，以排除你不需要使用的能力，从而减少包体积。subspecs 字段与能力的对应关系详见下表：