入门
此仓库包含可以在您的 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
中提供了工厂方法,允许您初始化服务。
- UIDeviceInterface:获取当前设备的 UUID、型号和系统版本的辅助工具。
static func makeDeviceHelper() -> UIDeviceInterface
- ReachabilityChecking:检测网络连接和蓝牙状态的辅助工具。
static func makeReachablitiyChecker() -> ReachabilityChecking
- V3APITokenManagable:一个助手,用于设置 RealifeTech API,将 deviceId 和配置设置到请求者。
static func makeApiHelper(deviceId: String, configuration: CoreSDKConfiguration) -> V3APITokenManagable
- GraphQLDispatching:请求 RealifeTech GraphQL API 的调度器
static func makeGraphQLDispatcher(
configuration: CoreSDKConfiguration,
tokenHelper: V3APITokenManagable,
deviceId: String,
reachabilityHelper: ReachabilityChecking
) -> GraphQLDispatching
- 获取使用 RealifeTech API 的有效令牌。
static func requestValidToken(fromApiHelper apiHelper: V3APITokenManagable)
为确保在使用 SDK 的任何其他功能之前配置 SDK,我们建议您将代码添加到 AppDelegate’s applicationDidFinishLaunching(_:)
中。