TuSDK for iOS 安装与更新

• 如果习惯手动管理依赖库，建议选择手动安装。如果用户已经在使用 CocoaPods，可以选择自动安装。
• 如果用户工程已使用 GPUImage 的部分功能，建议用户使用 Github 提供的 完整版GPUImage 。

文件说明

基础模块

• TuSDK.framework 是 TuSDK 功能调用的基础功能包。

主题模块

• TuSDKGeeV1.framework 是默认主题包（GeeV1），包含：「相机组件」，「相册组件」，「多选相册组件」，「头像组件」，「照片美化组件」和「裁切 + 滤镜组件」等功能。
• TuSDKGeeV2.framework 是 GeeV2 主题包，包含：「相机组件」+「多选相册组件」+「多图片编辑组件」整体调用的功能组件。

资源文件

• TuSDK.bundle 文件包含：滤镜贴纸等资源文件，用户权限的配置文件和 SDK 使用的 UI 图片文件。
• TuSDK.strings 是 TuSDK 的语言文件，目前支持「简体中文」，「繁体中文」和「英文」。

手动安装

首次安装

各个主题包相互之间没有依赖关系，可以同时使用，也可以分开使用，接下来以TuSDKGeeV1.framework默认主题包举例，进行 SDK 的手动集成操作

1、下载 GPUImage 和 TuSDK for iOS，解压缩。拖拽 GPUImage.framework 、 TuSDK.framework 和 TuSDKGeeV1.framework 到 Xcode 项目中。最新版本号请查看下载页面。(使用 TuSDK.framework Version 3.0.0 及以上版本不需要进行 GPUImage.framework 的操作)

2、勾选 Copy items if needed，点击 Finish。

3、打开项目的 app target，查看 Build Settings 中的 Linking - Other Linker Flags 选项，确保含有 -ObjC 一值，若没有则添加。

4、在项目的 app target 中，查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中，手动添加 Photos.framework，并将对应 Status 设置成 Optional；TuSDK.framework Version 3.1.1 及以上版本，手动添加 libresolv.tbd；TuSDK.framework Version 3.2.0及以上版本，手动添加WebKit.framework，并将对应 Status 设置成 Optional。

5、拖拽 Localization/*.lproj/TuSDK.strings到 Xcode 项目中。

6、勾选 Copy items if needed ，点击 Finish。

7、选中 TuSDK.strings 文件，点击 Xcode 的右边栏中的 Localize...，选择相应语言，点击 Localize。

8、点击 Localize，效果图如下。

9、下载 TuSDK-for-iOS-demo 在 Demo 中找到 Resources 文件中的 TuSDK.bundle，右键 Show in Finder。

10、在 Demo 的 Resources 中找到 TuSDK.bundle 文件，并拖拽到到自己的 Xcode 项目中。

11、在 TUTUCLOUD 网站控制台内挑选项目需要的滤镜和贴纸资源，并将客户端需要用到的资源进行「打包」操作，然后在「资源打包」处下载。

12、将下载好的文件替换到 TuSDK.bundle 中。首先请将 Demo 中的旧文件删除，包括 others 目录下的 lsq_tusdk_configs.json 文件和 stickers、textures 两个目录。然后再将从控制台下载的资源文件拖入工程中对应的位置。

13、所有步骤完成效果图如下

• 完成集成操作后用户也可以随时在控制台内配置在线商店中需要显示的资源。例如：用户可以在控制台官方滤镜可以获取滤镜资源，在我的滤镜库中，可以进行打包或上线的操作，上线操作是可以在在线滤镜显示，打包操作是选择的滤镜资源会出现在资源打包选项里，您可以通过资源打包将这些资源打包到本地显示。其他资源的操作也是如此。

更新

• 版本升级：删除旧文件，然后重复首次安装的步骤。
• 权限时间延长：不更换库文件，在控制台确认，包名(BundleID)和秘钥(AppKey)是否和项目中的一致，重新打包资源文件，将资源文件中的 others/lsq_tusdk_configs.json 中的 masterkey 字段替换到项目中 TuSDK.bundle/others/lsq_tusdk_configs.json 对应的位置即可。

自动安装（CocoaPods）

关于 CocoaPods 的安装和使用，以及 gem 更换镜像的方法，请查阅互联网资料。

首次安装

• Cocoapods 线上的 TuSDK 最新版本号，请查看Cocoapods 官网地址查询。
• 进行 pod search 操作无法搜索到 TuSDK 的最新版本，请进行 pod repo update操作。

1、 使用您熟悉的文本编辑器（例如 Vim），在项目的根目录中创建 Podfile 文件。最新版本号请查看下载页面。

• podfile 文件中的 platform 修改为 platform :ios, '6.0'。
• 向 podfile 文件添加依赖并保存：pod 'TuSDK', '~> 2.6.1'。运行后会安装「基础模块」和所有的「主题模块」。

platform :ios, '6.0'
target "PROJECT_NAME" do
pod 'TuSDK', '~> 2.6.1'
end

• 向 podfile 文件添加依赖并保存，运行后会安装「基础模块」和指定的「主题模块」。
• 主题模块功能包可任选其一或全选

platform :ios, '6.0'
pod 'TuSDK/Core', '~> 2.6.1'
pod 'TuSDK/ImageGeeV1', '~> 2.6.1'
pod 'TuSDK/ImageGeeV2', '~> 2.6.1'

2、 然后运行 pod install 即可安装。

3、在项目的 app target 中，查看 Build Phases 中的 Linking - Link Binary With Libraries 选项中，手动添加 Photos.framework，并将对应 Status 设置成 Optional；如果使用 TuSDK.framework Version 3.1.1 及以上版本，手动添加 libresolv.tbd；TuSDK.framework Version 3.2.0及以上版本，手动添加WebKit.framework，并将对应 Status 设置成 Optional。

4、下载 TuSDK-for-iOS-demo 在 Demo 中找到 Resources 文件中的 TuSDK.bundle，右键 Show in Finder。

5、下载 TuSDK-for-iOS-demo 在 Demo 中找到 Resources 文件中的 TuSDK.bundle，右键 Show in Finder。

6、在 Demo 的 Resources 中找到 TuSDK.bundle 文件，并拖拽到到自己的 Xcode 项目中。

7、在 TUTUCLOUD 网站控制台内挑选项目需要的滤镜和贴纸资源，并将客户端需要用到的资源进行「打包」操作，然后在「资源打包」处下载。

8、将下载好的文件替换到 TuSDK.bundle 中。首先请将 Demo 中的旧文件删除，包括 others 目录下的 lsq_tusdk_configs.json 文件和 stickers、textures 两个目录。然后再将从控制台下载的资源文件拖入工程中对应的位置。

完成操作后，用户可以随时在控制台内配置在线滤镜和在线贴纸中需要显示的资源。

更新

1、如果 Podfile 内指定了版本号，先更改至最新。

2、运行 pod update。

3、如果用户只更新 TuSDK 的库文件，而保证项目内其他第三方依赖库不变，请运行 pod update PODNAME。详细资料请参考CocoapodsGuide.pod install vs. pod update

4、如果无法更新到 TuSDK 的最新版，请进行 pod repo update操作，然后再 pod update。

5、Cocoapods 操作资料请参考Cocoapods-guides。