• 文档首页

导入 SDK

环境要求

名称	版本
Android SDK Build-tools	21 及以上
JAVA	JDK 1.7 及以上
Android Support V4	Android Support V4 21 及以上
Android SDK	Android API 15

导入 SDK

SDK 支持以下两种方式导入，您可以任选其一：

导入 maven 方式

1.在工程 build.gradle 配置脚本中 allprojects 段中添加 im_sdk 新 maven 仓库地址：

    allprojects {
        repositories {
            jcenter()
            mavenCentral()
            maven {url  "https://dl.bintray.com/rongcloud/maven"}
        }
    }

2.在项目的 build.gradle 添加远程依赖，示例如下：

api 'cn.rongcloud.sdk:im_kit:2.9.18'
//im_kit必须依赖im_lib，所以需要加入对应依赖
api 'cn.rongcloud.sdk:im_lib:2.9.18'

说明

SDK 版本是不断在迭代升级的，可以修改依赖中的版本号，使用最新版本的 SDK 。参考 https://support.rongcloud.cn/ks/OTUx。

导入 Module 方式

到融云 SDK 下载 https://www.rongcloud.cn/downloads下载 SDK。如图所示：

注意

下载界面默认勾选您需要所有组件，根据需求自主选择。

IMKit 包含会话列表、聊天窗口、消息内容展现、会话设置等功能封装为组件。

IMLib 是不含界面的基础 IM 通讯能力库，封装了通信能力和会话、消息等对象。

SDK 各部分功能以插件化的形式独立提供。各组件的功能如下：

各组件介绍

名称	功能介绍	备注
IMKit	IM 界面组件	——
IMLib	基础通信库	支持的 CPU 架构 armeabi，armeabi-v7a，arm64-v8a，x86
RCSticker	表情组件	——
Sight	小视频	——
LocationLib	位置相关库	——
PushLib	第三方推送库	支持的 CPU 架构 armeabi, armeabi-v7a, arm64-v8a, x86
RedPacket	红包组件	——

打开工程， File -> New -> Import Module

解压 SDK，选择所需要的 SDK 。如图：

配置说明

1 打开 App 的 build.gradle，在 dependencies 中添加相应模块的依赖。如图：

2 打开 IMLib Module 的 AndroidManifest.xml 文件，把 meta-data RONG_CLOUD_APP_KEY 的值修改为自己的 AppKey. 如图：

<meta-data
android:name="RONG_CLOUD_APP_KEY"
android:value="您的应用 AppKey" />

3 在应用的 App Module 的 AndroidManifest.xml 文件中，添加 FileProvider 相关配置，修改 android:authorities 为App 的应用的 “ApplicationId”.FileProvider。

    <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationId}.FileProvider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/rc_file_path" />
    </provider>

适配 Android Q

适配了 Android Q，默认为关闭状态，在 lib 的 rc_configuration.xml 中设置 rc_q_storage_mode_enable 为 True 后开启 Android Q 的存储模式，默认为 false。