RealifeTech-CoreSDK 1.0.11

RealifeTech-CoreSDK 1.0.11

Mickey LeeYou-Hsuan[email protected] 维护。



 
依赖
SwiftLint>= 0
RxSwift~> 5.1.1
RxCocoa~> 5.1.1
Apollo~> 0.40.0
Apollo/SQLite>= 0
 

  • 作者:
  • Mickey Lee 和 Jonathon Albert

入门

此仓库包含可以在您的 Swift 项目中使用 CocoaPods 依赖管理器安装的 RealifeTech Core SDK。在此,您可以找到入门指南以及 SDK 功能的用法示例。

1. 确保满足以下要求

  • Xcode 11.3+
  • iOS 13.0+ 的部署目标
  • CocoaPods 1.8.4+
  • Swift 5 注意,我们的 SDK 依赖于 RxSwift 包,这些包通过 CocoaPods 自动管理。该包应与任何大于 4.2 的 RxSwift 和 RxCocoa 版本的版本要求兼容。

2. 安装 RealifeTech-CoreSDK Pod 依赖项

在您的 .podfile 中的 Apps 目标下添加以下行

pod 'RealifeTech-CoreSDK', '~> 1.0.5'

打开您的终端,导航到包含您的 podfile 的目录,并运行

$ pod install

3. 创建核心服务

配置

要使用 SDK 的核心服务,您首先需要初始化 CoreSDKConfiguration。使用以下函数来配置 SDK。您的启动过程将提供必需的值。请注意,除非作为启动过程的一部分提供唯一的端点,否则 SDK 提供其 API 端点的默认值,您可以留这些字段为空。

let configuration = CoreSDKConfiguration(
    appCode: “APPLICATION_CODE”,
    clientSecret: “API_SECRET”,
    apiUrl: “http://API_URL”, // OPTIONAL
    graphApiUrl: “http://GRAPH_API_URL” // OPTIONAL
)

设置核心服务

RealifeTech-CoreSDK 在 CoreFactory 中提供了工厂方法,允许您初始化服务。

  1. UIDeviceInterface:获取当前设备的 UUID、型号和系统版本的辅助工具。
static func makeDeviceHelper() -> UIDeviceInterface
  1. ReachabilityChecking:检测网络连接和蓝牙状态的辅助工具。
static func makeReachablitiyChecker() -> ReachabilityChecking
  1. V3APITokenManagable:一个助手,用于设置 RealifeTech API,将 deviceId 和配置设置到请求者。
static func makeApiHelper(deviceId: String, configuration: CoreSDKConfiguration) -> V3APITokenManagable
  1. GraphQLDispatching:请求 RealifeTech GraphQL API 的调度器
static func makeGraphQLDispatcher(
        configuration: CoreSDKConfiguration,
        tokenHelper: V3APITokenManagable,
        deviceId: String,
        reachabilityHelper: ReachabilityChecking
    ) -> GraphQLDispatching
  1. 获取使用 RealifeTech API 的有效令牌。
static func requestValidToken(fromApiHelper apiHelper: V3APITokenManagable)

为确保在使用 SDK 的任何其他功能之前配置 SDK,我们建议您将代码添加到 AppDelegate’s applicationDidFinishLaunching(_:) 中。