接入步骤

按照以下步骤在 Android / iOS / uniapp 项目中集成晓葆终端 SDK。 整个过程约 10 分钟。

Android 接入

添加依赖

在项目根 settings.gradle 中添加 Maven 仓库：

dependencyResolutionManagement {
    repositories {
        maven { url "https://maven.xiaobaotop.com/releases" }
        google()
        mavenCentral()
    }
}

在应用模块 app/build.gradle 中添加依赖：

dependencies {
    implementation 'com.xiaobaotop:terminal-sdk:2.0.0'
}

初始化

在 Application.onCreate() 中完成 SDK 初始化：

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        XiaobaoSDK.init(
            context   = this,
            appId     = "YOUR_APP_ID",
            appKey    = "YOUR_APP_KEY",
            appSecret = "YOUR_APP_SECRET",   // 建议从后端下发，勿硬编码
            env       = XiaobaoEnv.SANDBOX   // 上线前改为 XiaobaoEnv.PROD
        )
    }
}

iOS 接入

添加依赖

Swift Package Manager（推荐）：

Xcode → File → Add Package Dependencies，输入：

https://github.com/xiaobaotop/terminal-sdk-ios

CocoaPods：

pod 'XiaobaoSDK', '~> 2.0'

初始化

// AppDelegate.swift
import XiaobaoSDK

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    XiaobaoSDK.initialize(
        appId:     "YOUR_APP_ID",
        appKey:    "YOUR_APP_KEY",
        appSecret: "YOUR_APP_SECRET",
        env:       .sandbox  // 上线前改为 .production
    )
    return true
}

uniapp 接入

安装 npm 包（确保使用 HBuilderX 3.8.0+ 和 Vue 3 模式）：

npm install @xiaobaotop/uni-sdk

在 main.ts 中初始化：

import { createApp } from 'vue'
import { XiaobaoSDK } from '@xiaobaotop/uni-sdk'
import App from './App.vue'

const app = createApp(App)

XiaobaoSDK.init({
  appId:     'YOUR_APP_ID',
  appKey:    'YOUR_APP_KEY',
  appSecret: 'YOUR_APP_SECRET',
  env:       'sandbox'  // 上线前改为 'production'
})

app.mount('#app')

验证接入

初始化成功后调用以下方法验证 SDK 状态：

// Android / Kotlin
val status = XiaobaoSDK.getStatus()
Log.d("SDK", "initialized: ${status.isInitialized}, env: ${status.env}")

正常情况下 isInitialized 为 true，表示 SDK 已就绪。 如果初始化失败，检查 App ID / AppKey 是否与控制台一致，以及网络连接是否正常。