XuqmGroup-AndroidSDK/sdk-push/README.md

# sdk-push

XuqmGroup Android SDK 推送模块。支持多厂商推送（华为/小米/OPPO/vivo/荣耀/FCM/APNs）。

## 依赖

```kotlin
implementation("com.xuqm:sdk-push:VERSION")
implementation("com.xuqm:sdk-core:VERSION")  // 必须
```

## 使用

**无需手动初始化或单独登录。** 宿主调用 `XuqmSDK.setUserInfo(...)` 后自动完成推送
token 注册；传入 `null` 时自动解绑。

```kotlin
// 开启/关闭接收推送
PushSDK.setReceivePush(context, enabled = false)
PushSDK.setReceivePush(context, enabled = true)
```

## 支持厂商

HUAWEI / XIAOMI / OPPO / VIVO / HONOR / FCM / APNS

## 与 IM 联动

IM 和推送服务均已开启时，IM 离线消息自动触发推送通知。

## 注意事项

- 需要各厂商 SDK 配置（App ID / App Secret）
- Firebase Messaging 需提供 `google-services.json`
- FCM token 通过 `FirebaseMessagingService.onNewToken()` 自动接收