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

85 行
2.0 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# Android 安装配置
**版本**0.5.x · **最低 Android 版本**API 24 (Android 7.0) · **语言**Kotlin
---
## Gradle 仓库配置
`settings.gradle.kts` 中添加 XuqmGroup Maven 仓库:
```kotlin
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` 中按需引入:
```kotlin
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 = 24`Android 7.0
- `compileSdk` 与项目保持一致(建议 34+
- Java 11 / Kotlin 1.9+
---
## ProGuard / R8 混淆规则
各模块已自带 `consumer-rules.pro`,业务方**无需额外配置**。如需手动维护,可添加:
```proguard
# 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.** { *; }
```
---
## 下一步
- [Android IM 接入 →](./im)
- [Android Push 接入 →](./push)
- [Android 版本更新 →](./update)