XuqmGroup-Web/docs-site/docs/rn/setup.md
XuqmGroup 6cd938cfbc feat(android-sdk): 添加完整的IM客户端SDK实现
- 实现了Android SDK的完整IM功能接口,包括消息、群组、好友、会话等核心功能
- 添加了消息收发、历史记录、撤回编辑等完整的消息操作能力
- 实现了群组管理功能,包括创建、成员管理、权限设置等操作
- 添加了好友关系链管理,支持添加、删除、分组等操作
- 实现了会话管理功能,包括置顶、免打扰、已读状态等
- 添加了黑名单、资料管理、搜索等辅助功能
- 补齐了批量操作接口,提升客户端操作效率
- 实现了WebSocket连接管理和事件监听机制
- 添加了离线消息同步和状态管理功能
2026-05-02 22:57:55 +08:00

2.0 KiB

React Native 安装配置

包名@xuqm/rn-sdk · 版本0.2.x · RN 版本:≥ 0.76.0

rn-sdk 作为内部基础包存在,业务方正常接入时使用 @xuqm/rn-common 和各业务模块即可。


npm / yarn 安装

在项目根目录创建 .npmrc

@xuqm:registry=https://nexus.xuqinmin.com/repository/npm-hosted/

只使用基础能力时,直接安装 rn-common

yarn add @xuqm/rn-common

按需安装模块时,rn-im / rn-push / rn-update 都会自动带上 rn-commonrn-sdk

yarn add @xuqm/rn-common @xuqm/rn-im
# 或全量安装
yarn add @xuqm/rn-common @xuqm/rn-im @xuqm/rn-push @xuqm/rn-update

自动 / 手动链接

React Native 0.60+ 支持自动链接,安装后执行:

cd ios && pod install

若使用 Expo,需先执行 expo prebuild 生成原生项目后再执行 pod install


iOS 配置

Pod 安装

cd ios
pod install

权限声明

Info.plist 中添加:

<key>NSCameraUsageDescription</key>
<string>需要访问相机</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风</string>

Android 配置

Gradle 仓库

android/build.gradle 中确保包含:

allprojects {
    repositories {
        maven { url "https://nexus.xuqinmin.com/repository/android/" }
        google()
        mavenCentral()
    }
}

最低版本

  • minSdkVersion = 24
  • compileSdkVersion = 34

依赖关系

@xuqm/rn-sdkmeta-package,不建议业务方直接引用
  ├── @xuqm/rn-common    ← 初始化、网络、设备信息
  ├── @xuqm/rn-im        ← IM 模块(依赖 WatermelonDB
  ├── @xuqm/rn-push      ← Push 模块
  └── @xuqm/rn-update    ← 更新模块

下一步