准备工作（重要）
由于用户中心SDK是基于Gitlab创建的私有仓库，所以在集成之前在钉钉上先联系焦晓亭开通Gitlab相关权限，联系之前请提供以下信息
1、 公司名称
2、 需开通权限用户Gitlab用户名列表,如果没有用户名，请联系质量部开通Gitlab账号，
钉钉联系人：史旻德
3、 集成项目的 BundleId
4、 用户中心提供业务号，如果没有请联系用户中心申请，钉钉联系人：马龙清
5、 集成项目的ipa安装包（如不需要集成实人认证功能，可不提供）
Cocoapods集成（推荐）
1、在工程的podfile添加用户中心SDK私有Specs地址：
在podfile中添加 source 'http://gitlab.sinoiov.com/LHJH/IOS/specs.git'
2、在工程的Podfile中添加 pod 'ZJUserCenterKit'
3、执行 pod update 命令，此时会提示输入用户名密码，输入申请的Gitlab用户名密码即可
4、注意：执行pod update时pod会自动安装以下依赖项：
AFNetworking、SDWebImage、MBProgressHUD、Toast、IQKeyboardManager
5、ZJUserCenterKit还支持微信、支付宝第三方登录功能，如果您的项目需要使用第三方登录功能，请在pod中添加以下依赖，注意：微信SDK仅支持到1.8.5，集成1.8.6会出现编译错误的问题
pod 'WechatOpenSDK','1.8.5'
pod 'AlipaySDK-iOS'
6、注意：ZJUserCenterKit 不包含阿里实人认证SDK,如果需要使用阿里实人认证，需联系iOS开发人员定制安装包（原因：阿里SDK会对bundleId验证，不同的工程不能共用一份SDK）
7、添加实人认证验证图片yw_1222_0769.jpg（如不需要集成实人认证功能，可不提供）
Framework源文件集成方式
1、从Giglab上下载demo及SDK，用户中心Demo地址，下载完的工程如下图所示
2、在图示中的“Frameworks”目录中选择对应的版本，拖动你自己的工程中，注意选择 Copy items if needed。
各版本SDK说明
ZJUserCenterSDK.framework 不包含实人认证功能标准SDK
ZJUserCenterSDKForAgent.framework 信源专用SDK
ZJUserCenterSDKForDemo.framework demo专用SDK
集成完注意检查以下两处是否显示SDK(Xcode11环境)
2.1. targets->General->Frameworks,Libraries,and Embedded Content
2.2 targets->Build Phases -> Embed Frameworks
3、将ZJUserCenter.bundle文件拖动自己的工程中，注意选择 Copy items if needed
4、添加实人认证验证图片yw_1222_0769.jpg（如不需要集成实人认证功能，可不提供）
使用方法
1、初始化 SDK
在AppDelegate.m文件的-(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
初始化用户中心SDK
2、将第三方返回信息反馈给用户中心
在AppDelegate.m文件的-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options写入以下代码
3、启动登录页面
3.1 启动默认登录
调用 ZJUserCenter的类方法startLoginPageWithCurrentContrller:completionHandler:，方法说明及定义如下
3.2 启动密码登录
调用 ZJUserCenter的类方法startPwdLoginPage:password:currentContrller:completionHandler，方法说明及定义如下
3.3 启动短信登录
调用 ZJUserCenter的类方法startSMSLoginPage:currentContrller:completionHandler，方法说明及定义如下
3.4 启动一键登录
调用 ZJUserCenter的类方法startOneClickLoginInContrller:currentContrller:completionHandler，方法说明及定义如下
3、打开H5页
打开用户中心H5页面的时序图如下：
打开H5时序图
上述流程中在第5步时调用ZJUserCenter的startH5Page:realAuthTicket:currentContrller:completionHandler方法，传入根据pageTicket组成的URL地址打开用户中心对应的H5页面例如
pageNum码表：
1 个人中心首页；2 个人信息页；3 账号管理；4 实名认证；5 地址信息页；6 发票抬头；8实人认证；9司机认证
SDK 回调码说明
常见问题
1、提示 Reason: image not found
1.1、检查 targets->Build Phases -> Embed Frameworks EmbeddedBinaries 中是否添加了ZJUserCenterKit.framework,
1.2、如果已经存在还出现该错误，尝试删除重新添加
2、提示 Undefined symbols for architecture arm64Showing All Messages
2.1、检查集成的阿里实人认证SDK是否存在target中
2.2、检查集成的阿里实人认证SDK和其依赖的SDK是否缺失，是否在target中
2.3、如果还有问题：参考https://www.jianshu.com/p/da50c3592e63
3、提示：ZJUserCenter.bundle: No such file or directory
查看libz.tbd、libc++.tbd、libiconv.tbd、libresolv.tbd是否在包含在工程的target中
4、提示‘未认证，用户已取消’
未在主工程中添加阿里实人认证图片 yw_1222_0769.jpg即可解决
网友评论