tls开发指南（ios版本）

《tls开发指南（ios版本）》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、TLS开发指南(iOS版本)本文档主要描述如何集成TLSSDK到开发者的iOS应用中去，并完成注册、登录的流程。1.环境搭建本节主要介绍如何使用Xcode创建一个应用，并集成TLSSDK。由于TLSSDK依赖IMSDK，这里假设用户已经了解如何集成IMSDK，如有疑问，可参考IMSDK相关文档。1.1.获取iOSSDKTLSSDK以framework形式提供，可以从官网下载iOSSDK：TLSSDK.framework为了方便开发者使用，我们SDK同时支持了i386x86_64armv7armv7sarm64多个平台。开发

2、者需要关注的是Headers目录，该目录下包含了TSLSDK提供的所有接口，目前开发者只需要关注以下几个文件：l通用类接口：TLSErrInfo.h-定义了TLS的错误信息，包含错误返回码、出错提示等Version.h-定义了当前SDK的版本号TLSUserInfo.h-定义了用户账号信息l账号类接口：TLSAccountHelper.h-定义了注册相关的接口TLSSmsRegListener.h-定义了注册相关的回调，开发者需要实现这些回调，以实现短信注册功能l登录类接口：TLSLoginHelper.h-定义了登录相关

3、的接口TLSSmsLoginListener.h-定义了登录相关的回调，开发者需要实现这些回调，以实现短信登录功能TLSRefreshTicketListener.h-定义了刷新票据相关的回调，开发者需要实现这些回调，以实现刷新票据功能1.2.创建应用打开xcode，新建工程：工程命名为tlsdemo：1.1.配置工程拷贝TLSSDK.framwork、ImSDK.framework到tlsdemo目录（由于TLSSDK依赖了ImSDK，因此要ImSDK.framework也加进来）。选中tlsdemo的Target，在B

4、uildPhases面板中的LinkBinaryWithLibraries添加依赖库。需要添加的依赖库有：TLSSDK.framworkImSDK.frameworklibz.dylibCoreTelephony.frameworkSystemConfiguration.frameworklibstdc++.dyliblibstdc++.6.dyliblibsqlite3.dylib其中，除TLSSDK.framwork、ImSDK.framework外，其余均为系统内置库编译工程：以上步骤进行完后，编译工程，如果没有报错

5、，恭喜你，集成SDK成功，可以进行下一步的功能开发了。1.基础流程介绍本节主要介绍TLSSDK的基础流程，包括注册流程、登录流程及刷新票据流程。通过阅读本小节，能够帮助开发者在实际编码前，对TLS的整体实现流程有一定的了解。TLS的注册及登录流程分别由以下两个类（TLSAccountHelper和TLSLoginHelper），以及若干回调实现，详细流程如下：1.1.注册流程TLSAccountHelper与TLSSmsRegListener配合以实现注册功能，总体注册流程如下图：TLS注册流程简述：用户提交手机号到后台请

6、求注册，后台收到请求后会给用户下发短信验证码；用户收到短信验证码后提交给后台验证，验证通过即可完成注册流程。1.1.登录流程TLSLoginHelper与TLSSmsLoginListener配合以实现登录功，总体登录流程如下图：TLS登录流程简述：用户输入手机号请求登录，后台收到请求后给用户手机下发短信验证码；用户收到短信验证码后提交给后台验证，验证通过即可成功登录。1.1.刷新票据流程为降低用户登录门槛，实现自动登录逻辑，SDK提供了刷新票据功能，即通过刷新本地票据实现自动登录功能（不用短信验证码即可登录），总体流程如

7、下图：TLS刷新票据流程简述：开发者先判断用户是否可以自动登录（调用needLogin接口），如果判断可以自动登录，则调用换票接口完成登录；否则需要重新走上一小节的登录流程。1.基础功能开发本节主要介绍如何在应用中调用SDK接口实现帐号注册、登录的基础功能。SDK接口中，大部分与网络有关的操作，我们采用了异步的方式来实现，所有需要异步返回结果的接口都提供了listener回调参数。回调命名为Listener，而不是delegate，是为了和AndroidSDK接口命名统一。1.1.初始化SDK在使用各种功能接口之前，需要对

8、SDK进行初始化。一般注册和登录功能需要同时实现，因此示例代码中会同时初始化（TLSAccountHelper和TLSLoginHelper）。首先要引入相关头文件#import#import在工程的