跳到主要内容

导入 SDK

本文档将指导您如何将 RTCLib SDK 导入到 Android 应用工程中。融云提供了两种导入方式，您可以根据开发需求选择合适的方式。

导入方式：

  • Gradle 远程依赖：推荐方式，便于版本管理和更新
  • 本地库模块：适用于需要自定义修改或离线开发的场景

环境要求​

在开始导入 SDK 前，请确保您的开发环境满足以下要求：

Android 适配版本：

  • SDK ≥ 5.6.3：Android 5.0（API 21）或更高版本
  • SDK < 5.6.3：Android 4.4（API 19）或更高版本（推荐 Android 5.0）

开发工具要求：

  • Android Studio 3.0 或更高版本

版本查询​

在导入 SDK 前，建议先确认当前最新版本号：

方式一：Gradle 远程依赖（推荐）​

Gradle 是推荐的导入方式，可以自动处理依赖关系并便于版本管理。

1. 配置 Maven 仓库​

在项目根目录的 build.gradle 文件（Project 视图）中添加融云 Maven 仓库：

Groovy
allprojects {
    repositories {
        google()
        mavenCentral()
        // 添加融云 Maven 仓库
        maven { url "https://maven.rongcloud.cn/repository/maven-releases/" }
    }
}

2. 添加 SDK 依赖​

在应用模块的 build.gradle 文件中添加依赖项：

Groovy
dependencies {
    // 基础依赖（必须）
    implementation 'cn.rongcloud.sdk:im_lib:x.y.z'    // 即时通讯基础能力库
    implementation 'cn.rongcloud.sdk:rtc_lib:x.y.z'   // 音视频通话基础能力库

    // 扩展功能（可选）
    implementation 'cn.rongcloud.sdk:face_beautifier:x.y.z' // 美颜扩展库
    implementation 'cn.rongcloud.sdk:player:x.y.z'          // 混音网络资源文件
}
版本兼容性
  • 请将 x.y.z 替换为具体的版本号，建议使用最新版本
  • RTCLib 必须与 IMLib SDK 保持版本兼容：
    • 5.2.0 至 5.4.4（不含）：要求前三位版本号一致
    • 5.4.4 及以上：要求前两位版本号一致
    • RTCLib 5.4.4 不兼容低于 5.4.4 的 IM SDK
版本查询

各个 SDK 的版本号可能不同，请前往融云官网 SDK 下载页面或融云的 Maven 代码库查询最新版本。

方式二：本地库模块导入​

1. 下载 SDK​

往融云官网 SDK 下载页面下载以下组件：

  • 音视频基础能力-RTCLib
  • 即时通讯基础能力-IMLib

2. 导入模块​

在 Android Studio 中导入下载的模块：

  1. 依次点击 File → New → Import Module
  2. 选择下载的 RTCLib 和 IMLib 模块文件夹
  3. 按照导入向导完成模块导入

3. 配置依赖​

在应用模块的 build.gradle 文件中添加本地模块依赖：

Groovy
dependencies {
    // 本地模块依赖
    implementation project(':RTCLib')  // 音视频通话基础能力库
    implementation project(':IMLib')   // 即时通讯基础能力库
}
版本兼容性

RTCLib 必须与 IMLib SDK 保持版本兼容：

  • 5.2.0 至 5.4.4（不含）：要求前三位版本号一致
  • 5.4.4 及以上：要求前两位版本号一致
  • RTCLib 5.4.4 不兼容低于 5.4.4 的 IM SDK
最后于 更新