# Android SDK 概览

**版本**：0.1.0 · **最低 Android 版本**：API 24 (Android 7.0) · **语言**：Kotlin

## 功能模块

| 模块 | Artifact | 功能 |
|------|----------|------|
| sdk-core | `com.xuqm:sdk-core` | 初始化、网络、鉴权、设备信息 |
| sdk-im | `com.xuqm:sdk-im` | 单聊、群聊、消息收发 |
| sdk-push | `com.xuqm:sdk-push` | 设备 Token 注册、离线推送 |
| sdk-update | `com.xuqm:sdk-update` | App 更新检查、RN 热更新 |

## 快速接入

### 1. 添加依赖

```kotlin
// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        maven("https://nexus.xuqinmin.com/repository/android/")
        google(); mavenCentral()
    }
}
```

```kotlin
// app/build.gradle.kts
dependencies {
    implementation("com.xuqm:sdk-core:0.1.0")
    implementation("com.xuqm:sdk-im:0.1.0")     // 按需
    implementation("com.xuqm:sdk-update:0.1.0") // 按需
}
```

### 2. 初始化

```kotlin
// Application.onCreate()
XuqmSDK.init(
    context = this,
    appKey = "your_app_id",
    appSecret = "your_app_secret",      // 建议由服务端签发临时凭证
    apiBaseUrl = "https://sentry.xuqinmin.com",
    imBaseUrl = "wss://sentry.xuqinmin.com/ws/im",
    debug = BuildConfig.DEBUG
)
```

### 3. IM 登录与收消息

```kotlin
// 先从你的服务端换取 IM Token，再登录
ImSDK.login(
    appId = "your_app_id",
    userId = "user_001",
    nickname = "张三"
)

// 监听事件
ImSDK.addListener(object : ImEventListener {
    override fun onConnected() { /* WebSocket 已连接 */ }
    override fun onMessage(msg: ImMessage) { /* 处理收到的消息 */ }
    override fun onDisconnected(reason: String?) { /* 断线处理 */ }
})
```

### 4. 发送消息

```kotlin
ImSDK.sendMessage(
    toId = "user_002",
    chatType = ChatType.SINGLE,
    msgType = MsgType.TEXT,
    content = "Hello!"
)
```

[→ 完整安装配置](./setup) · [→ IM 接入详解](./im) · [→ API Reference](./api)