Truora 软件开发工具包

Truora SDK 是一个 Swift 软件包，它提供了将 Truora 的数字身份 (DI) 和政府服务集成到您的 iOS 应用程序中的功能。该软件包包含用于启动身份验证流程并处理其结果的类和协议。

您可以通过 Swift Package Manager 安装 Truora SDK。只需将以下行添加到您的 Package.swift 文件的依赖项中

dependencies: [
    .package(url: "https://github.com/truora/TruoraSDK.git", from: "1.0.0")
]

1. 导入 TruoraSDK 模块

     import TruoraSDK

2. 初始化 TruoraSDK 要开始使用 Truora SDK，请初始化一个 TruoraSDK 实例，设置其委托并将其添加为您视图的子视图。

   let truoraSDK = TruoraSDK(frame: view.bounds)
   truoraSDK.delegateDI = self
   
   view.addSubview(truoraSDK)

3. 加载 DI 前端 使用 LoadDI 方法加载 DI 前端。您需要提供一个包含您的 API 令牌的 LoadFrontendInput 对象。

   let input = LoadFrontendInput(token: "YOUR_TOKEN_HERE")
   do {
       try truoraSDK.LoadDI(input: input)
   } catch let error {
       print("Error: \(error)")
   }

4. 实现委托方法 实现 TruoraSDKDIDelegate 协议方法以处理事件和错误。

   extension YourViewController: TruoraSDKDIDelegate {
       func close() {
           // Handle close event
           truoraSDK.removeFromSuperview() // Recomended if it was added as a subview
       }
   
       func handleError(error: TruoraError) {
           // Handle error
       }
   
       func stepsCompleted(result: TruoraResultDI) {
           // Handle steps completed event
       }
   
       func processSucceeded(result: TruoraResultDI) {
           // Handle process succeeded event
       }
   
       func processFailed(result: TruoraResultDI) {
           // Handle process failed event
       }
   }

LoadFrontendInput 结构表示使用 Truora SDK 所需的输入参数。

public struct LoadFrontendInput {
    public var token: String = ""

    public init(token: String) {
        self.token = token
    }
}

TruoraSDKDIDelegate 协议定义了用于处理 DI 流程事件和错误的方法。

public protocol TruoraSDKDIDelegate: NSObjectProtocol {
    func close()
    func handleError(error: TruoraError)
    func stepsCompleted(result: TruoraResultDI)
    func processSucceeded(result: TruoraResultDI)
    func processFailed(result: TruoraResultDI)
}

TruoraResultDI 结构表示从 DI 流程返回的值。

public struct TruoraResultDI : Codable {
    public var processID: String = ""
}

TruoraSDK 类提供了一种加载 DI 前端的方法。

public class TruoraSDK: UIView, WKScriptMessageHandler {
    public weak var delegateDI: TruoraSDKDIDelegate?

    public func LoadDI(input: LoadFrontendInput) throws {
        // Load DI frontend through Truora SDK
    }
}

Truora SDK 在捕获或处理过程中会抛出 TruoraError 类型的错误。

• TruoraError.MissingToken：当未提供令牌时抛出。
• TruoraError.InternalError：当发生意外错误时抛出。

• 确保您使用提供的委托适当地处理回调事件。检查 SDK 方法抛出的错误并进行相应处理。
• 此 SDK 需要从 Truora 获得的 API 令牌。

有关更多信息，请参阅 Truora 官方文档。

即将推出...

此 SDK 根据 MIT 许可证提供。有关详细信息，请参阅 LICENSE 文件。