XuqmGroup-Web/docs-site/docs/android/setup.md
XuqmGroup 6cd938cfbc feat(android-sdk): 添加完整的IM客户端SDK实现
- 实现了Android SDK的完整IM功能接口,包括消息、群组、好友、会话等核心功能
- 添加了消息收发、历史记录、撤回编辑等完整的消息操作能力
- 实现了群组管理功能,包括创建、成员管理、权限设置等操作
- 添加了好友关系链管理,支持添加、删除、分组等操作
- 实现了会话管理功能,包括置顶、免打扰、已读状态等
- 添加了黑名单、资料管理、搜索等辅助功能
- 补齐了批量操作接口,提升客户端操作效率
- 实现了WebSocket连接管理和事件监听机制
- 添加了离线消息同步和状态管理功能
2026-05-02 22:57:55 +08:00

2.0 KiB

Android 安装配置

版本0.5.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 更新检查、下载安装

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

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

最低 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.** { *; }

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

下一步