XuqmGroup-Web/docs-site/docs/android/setup.md
XuqmGroup 06436394ed docs: fix version numbers, add license SDK docs; fix service gating reactivity
- Android: correct version header 0.5.x→0.4.x, add sdk-license to module table, update artifact versions to 0.4.10
- iOS: correct min version iOS 14→16, bump version to 0.2.0, update SPM ref to from: "0.2.0"
- RN: fix version 0.3.x→0.2.x, standardize npm registry URL, add @xuqm/rn-license to module table
- Flutter: update git ref to v0.2.2, add xuqm_flutter_license to module tables
- Add new docs: ios/license, rn/push, rn/license, flutter/push, flutter/update, flutter/license
- tenant-platform: make appKey a computed ref in Push/VersionManagementView to fix service gating reactivity on route change
- tenant-platform: add requestActivation API endpoint
- tenant-platform: add IM service gating UI (checkServiceEnabled + activation dialog)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 02:23:57 +08:00

2.2 KiB

Android 安装配置

版本0.4.x · 最低 Android 版本API 24 (Android 7.0) · 语言Kotlin


Gradle 仓库配置

settings.gradle.kts 中添加 XuqmGroup Maven 仓库:

dependencyResolutionManagement {
    repositories {
        maven("https://nexus.xuqinmin.com/repository/android/")
        google()
        mavenCentral()
    }
}

各模块 Artifact 和版本

模块 Artifact 功能
sdk-core com.xuqm:sdk-core 初始化、网络、鉴权、Token 存储
sdk-im com.xuqm:sdk-im 单聊、群聊、消息收发、会话、好友、群组
sdk-push com.xuqm:sdk-push 自动检测厂商、设备 Token 注册(华为/小米/OPPO/vivo/荣耀/FCM
sdk-update com.xuqm:sdk-update App 更新检查、下载安装
sdk-license com.xuqm:sdk-license 设备授权注册与验证

app/build.gradle.kts 中按需引入:

dependencies {
    implementation("com.xuqm:sdk-core:0.4.10")
    implementation("com.xuqm:sdk-im:0.4.10")
    implementation("com.xuqm:sdk-push:0.4.10")    // 按需
    implementation("com.xuqm:sdk-update:0.4.10")  // 按需
    implementation("com.xuqm:sdk-license:0.4.10") // 按需
}

最低 Android API 版本

  • minSdk = 24Android 7.0
  • compileSdk 与项目保持一致(建议 34+
  • Java 11 / Kotlin 1.9+

ProGuard / R8 混淆规则

各模块已自带 consumer-rules.pro,业务方无需额外配置。如需手动维护,可添加:

# XuqmSDK Core
-keep class com.xuqm.sdk.** { *; }
-keepclassmembers class com.xuqm.sdk.** { *; }

# XuqmSDK IM
-keep class com.xuqm.sdk.im.** { *; }
-keepclassmembers class com.xuqm.sdk.im.** { *; }

# XuqmSDK Push
-keep class com.xuqm.sdk.push.** { *; }

# XuqmSDK Update
-keep class com.xuqm.sdk.update.** { *; }

# XuqmSDK License
-keep class com.xuqm.sdk.license.** { *; }

# GsonIM 消息序列化使用)
-keepattributes Signature
-keepattributes *Annotation*
-keep class com.google.gson.** { *; }

下一步