iOS应用接入
提示
如果你还没创建应用,请先到控制台 -> 应用管理 新建得到应用ID和应用Secret再继续。
如果你还没配置Bundle ID,请先到控制台 -> 应用管理 -> OAuth设置 配置好再继续。
集成SDK
推荐通过CocoaPods集成,在项目的Podfile添加:
pod 'OnlyID'
集成SDK。
你也可以使用源码集成方式,克隆 代码仓库 到本地后,复制OnlyID文件夹添加到你的工程目录。
提示
如果使用源码集成方式,建议定期更新最新代码文件,以免错过新的产品功能和安全、错误方面的更新。
获取Auth Code
登录按钮
应用界面展示登录按钮,文案为:"用唯ID登录",左侧添加唯ID logo,主题色为 #3F51B5
。
两种参考样式(推荐左侧,更正式更清晰):
提示:logo素材请从上面两个按钮右键另存为获取。
跳转OAuth页
用户点击登录按钮后,打开登录授权页,代码示例:
let config = OnlyIDOAuthConfig(clientId: "你的应用ID")
OnlyID.oauth(config: config, fromController: self, delegate: self)
...
extension ViewController: OnlyIDOAuthDelegate {
func onComplete(code: String, state: String?) { // 获得auth code }
func onError(error: NSError) { // 发生错误 }
func onCancel() { // 用户取消 }
}
提示
如果用户安装了唯ID APP,会唤起APP完成认证,否则通过WebView打开登录页完成认证。
获取用户信息
得到auth code后,通过code换取用户信息的逻辑三端一致(Web、Android、iOS),详见 获取用户信息。
示例Demo
请访问GitHub参考 示例Demo(iOS)。