XuqmGroup 041456805e docs(android-sdk): 添加 Android SDK 完整文档与模块配置

- 新增 Android SDK 主文档，包含模块结构、集成方式、快速开始指南
- 添加 sdk-core、sdk-im、sdk-push、sdk-update、sdk-webview 各模块详细说明
- 配置各模块的 build.gradle.kts 文件，设置依赖和发布选项
- 更新 gradle.properties 版本配置和编译参数
- 重构 XWebViewView 组件，增加相机权限、文件选择、下载拦截功能
- 添加 XWebViewTypes.kt 定义配置类和控制器接口
- 集成 Flutter WebView 桥接代码，实现跨平台功能对齐

2026-05-11 15:21:54 +08:00

2.0 KiB

原始文件 Blame 文件历史

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.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")  // 按需
}

最低 Android API 版本

minSdk = 24（Android 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.** { *; }

# Gson（IM 消息序列化使用）
-keepattributes Signature
-keepattributes *Annotation*
-keep class com.google.gson.** { *; }

2.0 KiB 原始文件 Blame 文件历史 Unescape Escape