You need to enable JavaScript to run this app.
导航
动态库升级指南
最近更新时间:2024.01.19 11:29:51首次发布时间:2024.01.19 11:29:51

自 1.40.2 版本起,iOS 上传 SDK 升级了动态库。与旧版本动态库相比,新版本动态库具有以下优势:

  • 实现包的精细化拆分,以精简下载包的大小。

  • 对齐静态库的依赖关系,便于动态库和静态库的迁移切换。

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

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

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

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

  1. 保留 Podfile 文件中 CocoaPods 集成方式。如需精简下载包的大小,可指定 subspecs 字段,例如 :subspecs => ['``Uploader``'] 表示仅使用上传相关能力。

  2. 如果升级 SDK 后,您遇到找不到头文件的报错,可按如下两种方式处理:

    1. 方式一:修改代码中的 import 方式

      • 如果您先前使用 #import <xxx/xxx.h> 添加头文件依赖,需批量搜索替换成 #import <TTSDKFramework/xxx.h>

      • 如果您先前使用了独立库的单独文件,例如 #import <TTSDKPUFramework/TTSDKPUFramework.h>,需替换成 #import <TTSDKFramework/TTSDKFramework.h>

    2. 方式二:不修改代码中的 import 方式 如果您不想修改头文件依赖方式,则需在 Podfile 文件中增加以下环境变量: ENV['TTSDK_FRAMEWORK_MODULE_NAME'] = '原来的 Framework 名称'

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

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

  1. Podfile 文件中 CocoaPods 集成方式修改成以下:
pod 'TTSDKFramework', :subspecs => ['Uploader']
  1. 如果您通过 #import "xxx.h" 方式引入头文件,则无需修改任何代码。但是如果您通过 #import <TTSDK/xxx.h> 方式引入头文件,可按如下两种方式处理:
    1. 方式一(推荐):在 Podfile 文件中增加环境变量 ENV['TTSDK_FRAMEWORK_MODULE_NAME'] = 'TTSDK'

    2. 方式二:全局搜索 #import <TTSDK/xxx.h>,替换为 #import <TTSDKFramework/TTSDKFramework.h>