tls开发指南（ios版本）.doc

文档介绍：TLS开发指南(iOS版本)
本文档主要描述如何集成TLSSDK到开发者的iOS应用中去,并完成注册、登录的流程。
环境搭建
本节主要介绍如何使用Xcode创建一个应用,并集成TLSSDK。由于TLSSDK依赖IMSDK,这里假设用户已经了解如何集成IMSDK,如有疑问,可参考IMSDK相关文档。
获取iOS SDK
TLSSDK以framework形式提供,可以从官网下载iOS SDK:
为了方便开发者使用,我们SDK同时支持了i386 x86_64 armv7 armv7s arm64多个平台。开发者需要关注的是Headers目录,该目录下包含了TSLSDK提供的所有接口,目前开发者只需要关注以下几个文件:
通用类接口:
- 定义了TLS的错误信息,包含错误返回码、出错提示等
- 定义了当前SDK的版本号
- 定义了用户账号信息
账号类接口:
- 定义了注册相关的接口
- 定义了注册相关的回调,开发者需要实现这些回调,以实现短信注册功能
登录类接口:
- 定义了登录相关的接口
- 定义了登录相关的回调,开发者需要实现这些回调,以实现短信登录功能
- 定义了刷新票据相关的回调,开发者需要实现这些回调,以实现刷新票据功能
创建应用
打开xcode,新建工程:
工程命名为tlsdemo:

配置工程
、(由于TLSSDK依赖了ImSDK,)。
选中tlsdemo的Target,在Build Phases面板中的Link Binary With Libraries添加依赖库。
需要添加的依赖库有:





libstdc++.dylib
libstdc++.

其中,、,其余均为系统内置库
编译工程:
以上步骤进行完后,编译工程,如果没有报错,恭喜你,集成SDK成功,可以进行下一步的功能开发了。
基础流程介绍
本节主要介绍TLSSDK的基础流程,包括注册流程、登录流程及刷新票据流程。通过阅读本小节,能够帮助开发者在实际编码前,对TLS的整体实现流程有一定的了解。
TLS的注册及登录流程分别由以下两个类(ountHelper和TLSLoginHelper),以及若干回调实现,详细流程如下:
注册流程
ountHelper与TLSSmsRegListener配合以实现注册功能,总体注册流程如下图:
TLS注册流程简述:用户提交手机号到后台请求注册,后台收到请求后会给用户下发短信验证码;用户收到短信验证码后提交给后台验证,验证通过即可完成注册流程。
登录流程
TLSLoginHelper与TLSSmsLoginListener配合以实现登录功,总体登录流程如下图:
TLS登录流程简述:用户输入手机号请求登录,后台收到请求后给用户手机下发短信验证码;用户收到短信验证码后提交给后台验证,验证通过即可成功登录。
刷新票据流程
为降低用户登录门槛,实现自动登录逻辑,SDK提供了刷新票据功能,即通过刷新本地票据实现自动登录功能(不用短信验证码即可登录),总体流程如下图:
TLS刷新票据流程简述:开发者先判断用户是否可以自动登录(调用needLogin接口),如果判断可以自动登录,则调用换票接口完成登录;否则需要重新走上一小节的登录流程。
基础功能开发
本节主要介绍如何在应用中调用SDK接口实现帐号注册、登录的基础功能。
SDK接口中,大部分与网络有关的操作,我们采用了异步的方式来实现,所有需要异步返回结果的接口都提供了listener回调参数。回调命名为Listener,而不是delegate,是为了和Android SDK接口命名统一。
初始化SDK
在使用各种功能接口之前,需要对SDK进行初始化。一般注册和登录功能需要同时实现,因此示例代码中会同时初始化(ountHelper和TLSLoginHelper)。首先要引入相