iOS OCTokenSDK集成与使用指南

"这是关于iOS平台上的OCTokenSDK的使用文档，主要涵盖了SDK的导入配置、URLScheme设置、白名单及ATS安全配置，以及一系列关键API的使用方法，包括初始化、授权、充值、提现和回调处理。" 在iOS开发中，OCTokenSDK是一个专门用于处理数字资产操作的库，例如授权、充值和提现。以下是对这个SDK的详细说明： 1. 导入配置： 在使用OCTokenSDK前，你需要将`OCTokenSDK.framework`框架直接拖入你的Xcode工程中。为了使SDK能够正确处理回调，还需要配置URLScheme。URLScheme应设置为`OCToken+appName`的形式，其中`appName`是你的应用的简称，必须是唯一的标识。 2. URLScheme与ATS安全配置： - URLScheme的设置有助于在应用间跳转并接收回调数据。例如，如果您的应用名为“OCTokenSDKDemo”，则URLScheme应设为“OCToken+OCTokenSDKDemo”。 - 添加白名单是为了允许应用查询OCToken相关的URL。在`info.plist`文件中，需要在`LSApplicationQueriesSchemes`数组中添加“OCToken”。 - ATS（App Transport Security）安全配置确保了网络通信的安全性，需根据需求配置以支持非HTTPS连接。 3. OCTokenSDKManager： 这个类提供了SDK的主要功能接口： - 初始化：通过`+(void)initWithAppScheme:(NSString*)scheme andAppName:(NSString*)appName;`方法，传入自定义的URLScheme和应用名称来初始化SDK。 - 开始授权：使用`+(void)startOAuth;`启动授权流程，让用户授权访问其数字钱包。 - 充值：`+(void)startRechargeWithChargeAmount:(float)amount andOrderNum:(NSString*)orderNum;`方法处理充值操作，需要传入充值金额和订单号。 - 提现：`+(void)startWithdrawWithTargetWallet:(NSString*)addrress;`用于用户提现到指定的钱包地址。 - 回调处理：`+(void)OAuthCallBackByURL:(NSString*)url completion:(OCTokenAuthCompletion)completion;`方法处理来自URL的回调信息，完成授权或交易后的后续操作。 4. 回调信息： 回调数据包含了关键的参数，如： - 授权回调：返回钱包名称、地址、时间戳和签名等信息，用于验证授权的合法性。 - 充值回调：包含充值金额和订单号，用于跟踪充值状态。 - 提现回调：可能包括提现钱包地址和其他相关信息。 5. 回调处理： 应在`AppDelegate`中的`application:openURL:options:`方法中捕获回调URL，然后通过`OAuthCallBackByURL`方法处理回调，传递回调URL和一个完成处理的Block，Block中可以获取到授权或交易的详细信息。 在实际应用中，开发者需要根据这些接口和回调信息来构建用户界面和业务逻辑，确保安全地处理数字资产的授权和交易操作。理解并正确使用这些API是成功集成OCTokenSDK的关键步骤。