JuggleIM Android SDK
面向 Android 的高性能开源实时消息 SDK。
基于 WebSocket 之上的自定义二进制协议构建，开箱即支持聊天、群组、直播聊天室、RTC 信令和朋友圈/动态能力。
功能特性 ·
快速开始 ·
文档 ·
生态 ·
社区
English | 简体中文
---
## 为什么选择 JuggleIM？
从零构建可靠、可扩展的实时消息系统并不容易。**JuggleIM** 提供完整的生产级 IM 平台，包含服务端、管理后台和多端客户端。本仓库提供 **官方 Android SDK**，让你无需放弃协议、数据和基础设施控制权，就能在几分钟内接入聊天能力。
- 自定义二进制协议 - 基于 WebSocket 的 Protobuf 传输，针对低延迟和小体积优化。
- 自动重连 - 在网络不稳定时仍能通过离线消息、ACK 和重传机制保持连接可靠。
- 可组合架构 - 统一的客户端 API，覆盖聊天、群组、聊天室、朋友圈/动态和 RTC 信令。
## ✨ 功能特性
- 核心 IM 能力：连接管理、重连、会话、消息收发、历史消息、未读数。
- 消息类型：文本、图片、文件、自定义消息，以及业务通知消息。
- 聊天场景：单聊、群聊、聊天室、直播聊天室。
- 扩展能力：用户资料、朋友圈/动态、音视频通话、消息上传。
- 推送插件：Google FCM、华为、小米、OPPO、VIVO、荣耀和极光推送。
- 通话插件：Zego、Agora 和 LiveKit。
- 安全能力：近期版本已提供端到端加密相关能力。
- Demo 应用：仓库内包含可运行的 Android Demo，可直接验证登录、会话、消息和通话流程。
## 🚀 快速开始
### 安装
在 `settings.gradle` 或根 Gradle 文件中添加 JuggleIM Maven 仓库：
```gradle
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven { url "https://repo.juggle.im/repository/maven-releases/" }
}
}
```
在应用的 `build.gradle` 中添加 Juggle 依赖：
```gradle
dependencies {
implementation "com.juggle.im:juggle:1.9.0"
}
```
按需添加插件：
```gradle
dependencies {
implementation "com.juggle.push.jg:juggle:1.9.0"
implementation "com.juggle.call.zego:juggle:1.9.0"
implementation "com.juggle.call.agora:juggle:1.9.0"
implementation "com.juggle.call.livekit:juggle:1.9.0"
}
```
### 初始化
在 `Application` 中初始化 SDK：
```java
import com.juggle.im.JIM;
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
List