导入 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。