Tink Link iOS
先决条件
- 按照 入门指南 获取您的
client_id
。 - 使用方案和主机 (
yourapp://host
) 将深链接添加到您的应用程序中,并放入您应用程序设置的 重定向 URI 列表 中。
要求
- iOS 11.0
- Xcode 11.4
安装
在Tink Link包中有两个目标。
TinkLink
是一个银行凭证聚合框架,您可以构建自己的UI,适合需要与长期用户聚合的企业计划客户。TinkLinkUI
是一个具有预定义流程、单入口和可配置UI样式的框架,您可以使用这个框架快速启动您的应用程序。
有关长期用户的更多信息,请参阅此处。
使用Swift包管理器
按照这些说明链接目标到包产品,并在被要求时输入此URL https://github.com/tink-ab/tink-link-ios
作为包仓库。
完成后,您应在您的项目中能够使用 import TinkLink
和 import TinkLinkUI
。
使用CocoaPods
有关使用和安装说明,请参阅他们的指南。
-
将TinkLink和TinkLinkUI添加到Podfile中。
pod "TinkLink" pod "TinkLinkUI"
-
在您的项目目录中运行
pod install
。 -
打开您的
.xcworkspace
文件,然后在Xcode中查看项目。
手动安装
- 从最新Tink Core版本下载并解压
TinkCore.xcframework.zip
。 - 将
TinkCore.xcframework
拖拽到应用目标的 通用 选项卡上的 框架、库和嵌入式内容 部分。 - 从最新Tink Link版本下载并解压
Source code.zip
。 - 向您的应用中添加名为
TinkLink
的新iOS Framework目标。 - 将除 Info.plist 之外的所有文件从
Sources/TinkLink
文件夹拖拽到新目标中。 - 向您的应用中添加名为
TinkLinkUI
的新iOS Framework目标。 - 将除 Info.plist 之外的所有文件从
Sources/TinkLinkUI
文件夹拖拽到新目标中。 - 安装完成
- 将Down添加到TinkLinkUI目标中。
完成后,您应在您的项目中能够使用 import TinkLink
和 import TinkLinkUI
。
如何显示Tink Link
-
引入SDK,并使用您的客户端ID和重定向URI设置配置。
import TinkLink import TinkLinkUI let configuration = TinkLinkConfiguration(clientID: <#String#>, appURI: <#URL#>)
-
根据您要获取的数据类型定义作用域列表。例如,为了检索账户和交易,定义以下作用域
let scopes: [Scope] = [ .accounts(.read), .transactions(.read) ]
-
使用您的配置、市场和作用域列表创建一个
TinkLinkViewController
。let tinkLinkViewController = TinkLinkViewController(configuration: configuration, market: "SE", scopes: scopes) { result in // Handle result }
-
Tink Link 设计为模式呈现。通过在呈现视图控制器上调用
present(_:animated:)
来呈现视图控制器。present(tinkLinkViewController, animated: true)
-
用户完成或取消聚合流程后,完成处理程序将带有结果被调用。成功认证将返回包含可交换访问令牌的授权码的结果。如果出了问题,结果将包含一个错误。
do { let authorizationCode = try result.get() // Exchange the authorization code for a access token. } catch { // Handle any errors }
重定向处理
您需要添加自定义URL方案或支持通用链接来处理第三方认证流程重定向到您的应用。
按照以下链接中的说明操作,了解如何设置此功能
示例
此示例展示了如何使用 TinkLink 构建完整的聚合流程。
文档
需要更详细的使用方法和完整文档,请参阅我们的 Tink Link for iOS 指南。
Tink
Tink 自 2012 年成立以来,旨在改善银行行业。我们建立了欧洲最稳健的开放银行平台——该平台具有最广泛、最深层次的连接和强大的服务,能够创造出金融数据的价值。