¶ 企业微信登录

¶ 准备工作

在企业微信管理后台及 Authing 管理控制台进行配置请参阅 企业微信移动端（代开发模式） (opens new window)。

¶ 集成企业微信登录步骤

¶ 第一步：添加依赖

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)。

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

4. Add Package 后勾选 WeCom 。

¶ 第二步：修改项目配置

• 配置跳转 Scheme: LSApplicationQueriesSchemes Key 下添加 wxwork 和 wxworklocal

• 配置企业微信回跳 URL：URL types Key 下 添加企业微信管理后台申请到的 Schema （例如：wwauth803c38cb89ac1d57000002）

¶ 第三步：初始化 WeCom

1. 在 AppDelegate 或 SceneDelegate 中加入 import Guard 和 import WeCom 。

2. WeCom.registerApp 需要传入企业微信发放的 Scheme、AgentID、CorpID, isProxyDevelopment 选择是否为代开发模式。

import Guard
import WeCom

Authing.start(<#AUTHING_APP_ID#>)
WeCom.registerApp(appId: <#Scheme#>, corpId: <#CorpID#>, agentId: <#AgentID#>, isProxyDevelopment: <#Bool#>)

¶ 第四步：添加回调

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

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

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

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

¶ 第五步：发起企业微信授权

SDK 提供了三种授权方式：

1. 开发者在需要登录时调用 API：

WeCom.login { code, message, userInfo in
    if (code == 200) {
        // userInfo：用户信息
    }
}

2. 通过我们提供的语义化 Hyper Component，只需要在 xib 里面放置一个：

WeComLoginButton

设置 Module 为 WeCom，Build success 后点击按钮即可登录。

3. 如果想自己接入 Wecom 授权整个流程，拿到授权码后，可以调用下面 API 换取 Authing 用户信息：

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

参数

• authCode Wecom 授权码

示例

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