XuqmGroup-Web/docs-site/docs/android/setup.md
XuqmGroup 038d862838 License改造:ops平台管理最大设备数、审批有效期、License SDK文档
- ops平台AppDetailView添加License授权管理卡片(内联编辑最大设备数)
- 服务开通审批对话框LICENSE类型支持选择有效期
- ops API新增getAppLicense/updateMaxDevices方法
- 文档站新增Android License SDK集成文档
- setup.md添加sdk-license依赖和ProGuard规则

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-15 22:39:43 +08:00

91 行
2.2 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 更新检查、下载安装 |
| sdk-license | `com.xuqm:sdk-license` | 设备授权注册与验证 |
`app/build.gradle.kts` 中按需引入:
```kotlin
dependencies {
implementation("com.xuqm:sdk-core:0.4.2")
implementation("com.xuqm:sdk-im:0.4.2")
implementation("com.xuqm:sdk-push:0.4.2") // 按需
implementation("com.xuqm:sdk-update:0.4.2") // 按需
implementation("com.xuqm:sdk-license:0.4.2") // 按需
}
```
---
## 最低 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.** { *; }
# XuqmSDK License
-keep class com.xuqm.sdk.license.** { *; }
# GsonIM 消息序列化使用)
-keepattributes Signature
-keepattributes *Annotation*
-keep class com.google.gson.** { *; }
```
---
## 下一步
- [Android IM 接入 →](./im)
- [Android Push 接入 →](./push)
- [Android 版本更新 →](./update)
- [Android 授权管理 →](./license)