TLS开发指南（iOS版本）.doc

TLS开发指南(iOS版本) 本文档主要描述如何集成TLSSDK到开发者的iOS应用中去，并完成注册、登录的流程。 环境搭建 本节主要介绍如何使用Xcode创建一个应用，并集成TLSSDK。由于TLSSDK依赖IMSDK，这里假设用户已经了解如何集成IMSDK，如有疑问，可参考IMSDK相关文档。 获取iOS SDK TLSSDK以framework形式提供，可以从官网下载iOS SDK：TLSSDK.framework 为了方便开发者使用，我们SDK同时支持了i386 x86_64 armv7 armv7s arm64多个平台。开发者需要关注的是Headers目录，该目录下包含了TSLSDK提供的所有接口，目前开发者只需要关注以下几个文件： 通用类接口： TLSErrInfo.h - 定义了TLS的错误信息，包含错误返回码、出错提示等 Version.h - 定义了当前SDK的版本号 TLSUserInfo.h - 定义了用户账号信息 账号类接口： TLSAccountHelper.h - 定义了注册相关的接口 TLSSmsRegListener.h - 定义了注册相关的回调，开发者需要实现这些回调，以实现短信注册功能 登录类接口： TLSLoginHelper.h - 定义了登录相关的接口 TLSSmsLoginListener.h - 定义了登录相关的回调，开发者需要实现这些回调，以实现短信登录功能 TLSRefreshTicketListener.h - 定义了刷新票据相关的回调，开发者需要实现这些回调，以实现刷新票据功能 创建应用 打开xcode，新建工程： 工程命名为tlsdemo：   配置工程 拷贝TLSSDK.framwork、ImSDK.framework到tlsdemo目录（由于TLSSDK依赖了ImSDK，因此要ImSDK.framework也加进来）。 选中tlsdemo的Target，在Build Phases面板中的Link Binary With Libraries添加依赖库。 需要添加的依赖库有： TLSSDK.framwork ImSDK.framework libz.dylib CoreTelephony.framework SystemConfiguration.framework libstdc++.dylib libstdc++.6.dylib libsqlite3.dylib 其中，除TLSSDK.framwork、ImSDK.framework外，其余均为系统内置库 编译工程： 以上步骤进行完后，编译工程，如果没有报错，恭喜你，集成SDK成功，可以进行下一步的功能开发了。 基础流程介绍 本节主要介绍TLSSDK的基础流程，包括注册流程、登录流程及刷新票据流程。通过阅读本小节，能够帮助开发者在实际编码前，对TLS的整体实现流程有一定的了解。 TLS的注册及登录流程分别由以下两个类（TLSAccountHelper和TLSLoginHelper），以及若干回调实现，详细流程如下： 注册流程 TLSAccountHelper与TLSSmsRegListener配合以实现注册功能，总体注册流程如下图： TLS注册流程简述：用户提交手机号到后台请求注册，后台收到请求后会给用户下发短信验证码；用户收到短信验证码后提交给后台验证，验证通过即可完成注册流程。 登录流程 TLSLoginHelper与TLSSmsLoginListener配合以实现登录功，总体登录流程如下图： TLS登录流程简述：用户输入手机号请求登录，后台收到请求后给用户手机下发短信验证码；用户收到短信验证码后提交给后台验证，验证通过即可成功登录。 刷新票据流程 为降低用户登录门槛，实现自动登录逻辑，SDK提供了刷新票据功能，即通过刷新本地票据实现自动登录功能（不用短信验证码即可登录），总体流程如下图： TLS刷新票据流程简述：开发者先判断用户是否可以自动登录（调用needLogin接口），如果判断可以自动登录，则调用换票接口完成登录；否则需要重新走上一小节的登录流程。 基础功能开发 本节主要介绍如何在应用中调用SDK接口实现帐号注册、登录的基础功能。 SDK接口中，大部分与网络有关的操作，我们采用了异步的方式来实现，所有需要异步返回结果的接口都提供了listener回调参数。回调命名为Listener，而不是delegate，是为了和Android SDK接口命名统一。 初始化SDK 在使用各种功能接口之前，需要对SDK进行初始化。一般注册和登录功能需要同时实现，因此示例代码中会同时初始化（TLSAccountHelper和TLSLoginHelper）。首先要引