XuqmGroup-AndroidSDK/sdk-core
XuqmGroup 6d18af496b fix: 移除库模块 isMinifyEnabled 修复 Duplicate class 冲突
Android 库模块开启 isMinifyEnabled=true 时,R8 各自独立混淆,
将内部类重命名为 a.a / a.b 等短名打进 AAR;多个 AAR 合并到 App
时产生 Duplicate class 冲突。

修复:删除全部 7 个库模块 buildTypes.release 中的 isMinifyEnabled,
混淆由 App 的 R8 统一完成。将 proguard-rules.pro 中的保留规则
(manifest 注册类、反射调用入口、dontwarn)合并进各模块的
consumer-rules.pro 随 AAR 打包。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-23 14:57:22 +08:00
..
src/main feat(core): 添加请求签名功能并扩展更新接口 2026-06-19 01:27:56 +08:00
build.gradle.kts fix: 移除库模块 isMinifyEnabled 修复 Duplicate class 冲突 2026-06-23 14:57:22 +08:00
consumer-rules.pro fix: 移除库模块 isMinifyEnabled 修复 Duplicate class 冲突 2026-06-23 14:57:22 +08:00
proguard-rules.pro fix: 移除库模块 isMinifyEnabled 修复 Duplicate class 冲突 2026-06-23 14:57:22 +08:00
README.md refactor: sdk-log → sdk-bugcollect 2026-06-16 17:39:23 +08:00

sdk-core

XuqmGroup Android SDK 核心模块。提供 SDK 初始化、HTTP 请求、Token 管理、文件操作、通用工具。

依赖

implementation("com.xuqm:sdk-core:VERSION")

初始化

方式 A — ContentProvider 自动初始化(推荐)

config.xuqm 放入 src/main/assets/xuqm/,SDK 在 App 启动时自动读取并初始化。

// XuqmInitializerProvider 自动触发,无需代码

方式 B — 手动初始化

// Application.onCreate() 中:
XuqmSDK.initialize(context, appKey = "xxx")
XuqmSDK.initialize(context, appKey = "xxx", platformUrl = "https://xxx")

API

XuqmSDK全局单例

API 说明
XuqmSDK.initialize(context, appKey, platformUrl?, logLevel?) 手动初始化
XuqmSDK.awaitInitialization() 等待平台配置拉取coroutine
XuqmSDK.isInitialized() 检查是否已初始化
XuqmSDK.setUserInfo(info) 设置用户信息,触发所有子模块登录
XuqmSDK.setUserInfo(null) 登出,触发全局登出
XuqmSDK.getUserId() 获取当前 userId
XuqmSDK.getUserInfo() 获取当前用户信息
XuqmSDK.appKey 当前 appKey
XuqmSDK.platformConfig 平台配置init 后可用)
XuqmSDK.bugCollectApiUrl Bug 收集服务地址(从平台配置获取)
XuqmSDK.bugCollectEnabled 是否启用 Bug 收集上报
XuqmSDK.useLocalServiceEndpoints(ip) 切换本地联调环境
XuqmSDK.tokenStore Token 存储EncryptedSharedPreferences

XuqmUserInfo

data class XuqmUserInfo(
    val userId: String,      // 必填
    val userSig: String? = null,  // IM 登录凭证(可选)
    val name: String? = null,
    val phone: String? = null,
    val avatar: String? = null,
)

TokenStore

基于 EncryptedSharedPreferences 持久化存储。

XuqmSDK.tokenStore.saveToken("eyJ...")
val token = XuqmSDK.tokenStore.getToken()
XuqmSDK.tokenStore.clear()

ApiClient

基于 OkHttp 5 + Retrofit 3,自动附加 Bearer Token。

val service = RetrofitFactory.create(MyApiService::class.java)

FileSDK

文件上传、下载、打开的统一入口(com.xuqm.sdk.file)。

// 上传
val result = FileSDK.upload(context, uri, onProgress = { /* 0-100 */ })
val result = FileSDK.uploadBytes(fileName, mimeType, bytes, onProgress)

// 下载
val file = FileSDK.download(context, url, fileName, destination, notificationTitle, onProgress)

// 打开
FileSDK.openFile(context, file)