小米登录

更新时间: 2024-10-10 07:28:40
编辑

准备工作

在 小米开放平台 (opens new window) 及 Authing Console 控制台 (opens new window)进行配置，请参阅 小米接入准备、小米官方文档 (opens new window)。


集成小米登录

第一步：添加 Xiaomi 依赖

  1. 在 swift package 搜索栏输入：https://github.com/Authing/authing-binary 。

  2. 选择 Authing-binary (opens new window)。

Authing-binary (opens new window) 依赖于 Guard-iOS SDK (opens new window)。

  1. 依赖规则选择 Up to Next Major Version 1.0.0 。

  2. Add Package 后勾选 Xiaomi 。

Xiaomi 依赖于 Guard-iOS 1.4.4 (opens new window) 之后版本。


第二步：修改项目配置

配置小米登录组件回跳 URL：

  1. 选择 Xcode 工程，在 Targets -> Info -> URL Types 中点击加号。
  2. Identifier 填写 xiaomi。
  3. URL Schemes 填写小米开放平台的 AppId。

第三步：初始化小米登录

import Guard
import Xiaomi

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    Authing.start(<#AUTHING_APP_ID#>)
    // appId: 小米的 AppId
    // redirectUrl: 登录回调地址
    Xiaomi.register(appId: <#your_xiaomi_appId#>, redirectUrl: <#your_xiaomi_redirectUrl#>)
}

第四步：处理小米登录回调

小米返回应用后，如果使用了 SceneDelegate，则需要在 SceneDelegate.swift 里面重载下面的函数：

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    if let url = URLContexts.first?.url{
        _ = Xiaomi.handleOpenUrl(url: url)
    }
}

如果未使用 SceneDelegate，则需要在 AppDelegate 里面重载：

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    return Xiaomi.handleOpenUrl(url: url)
}

第五步：发起小米登录授权

小米授权登录

func login(viewController: UIViewController, _ scopes: [String] = [], completion: @escaping Authing.AuthCompletion) -> Void

参数

  • viewController 承载视图的 UIViewController
  • scopes 默认为空

示例

Xiaomi.login(viewController: <#ViewController#>) { code, message, userInfo in
    if (code == 200) {
        // 登录成功
        // userInfo
    }
}

如果开发者自己集成小米登录，拿到 AuthorizationCode 后，可以调用以下 API 换取 Authing 用户信息：

通过小米授权码登录

func loginByXiaomi(_ code: String, completion: @escaping(Int, String?, UserInfo?) -> Void)

参数

code 小米授权码

示例

AuthClient().loginByXiaomi(authCode) { code, message, userInfo in
    if (code == 200) {
        // userInfo：用户信息
    }
}