导入 CallKit SDK

融云支持使用 Maven 远程仓库、本地库模块（Module）和源代码三种方式，将 CallKit SDK 导入到您的应用工程中。

环境要求

• （SDK ≧ 5.6.3）使用 Android 5.0（API 21）或更高版本
• （SDK < 5.6.3）使用 Android 4.4（API 19）或更高版本

检查版本

在导入 SDK 前，您可以前往 融云官网 SDK 下载页面 确认当前最新版本号。

Maven

使用 Gradle 添加对 CallKit、CallLib、IMKit、IMLib 四个模块的依赖关系。请注意使用 融云的 Maven 仓库。

1. 打开根目录下的 build.gradle（Project 视图下），声明融云的 Maven 代码库。

   Groovy

   allprojects {
       repositories {
           ...
           //融云 maven 仓库地址
           maven {url "https://maven.rongcloud.cn/repository/maven-releases/"}
       }
   }

2. 在应用的 build.gradle 中，添加如下远程依赖项。注意，融云 RTC 业务依赖 IM 通道，所以必须同时集成 IMLib。

   Groovy

   dependencies {
       // x.y.z，请填写具体的 SDK 版本号，新集成用户建议使用最新版。
       implementation 'cn.rongcloud.sdk:call_kit:x.y.z'
       implementation 'cn.rongcloud.sdk:call_lib:x.y.z'
       implementation 'cn.rongcloud.sdk:im_kit:x.y.z'
       implementation 'cn.rongcloud.sdk:im_lib:x.y.z'
   
       implementation 'cn.rongcloud.sdk:face_beautifier:x.y.z' // 美颜扩展库（可选）
   }

   注意

   • 各个 SDK 的最新版本号可能不相同，还可能是 x.y.z.h，可前往 融云官网 SDK 下载页面 或 融云的 Maven 代码库 查询。
   • 从 5.2.0 版本开始，CallKit/CallLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致（前三位必须保持一致）。

Android 本地库模块 (Module)

在导入 SDK 前，您需要 前往融云官网 SDK 下载页面，将音视频通话（含 UI）SDK 下载到本地。

1. 在 Android Studio 中打开工程后，依次点击 File > New > Import Module，找到下载的 Module 组件并导入。

2. 在应用的 build.gradle 中，添加本地库模块依赖项。

   Groovy

   dependencies {
       implementation project(':CallKit')
       implementation project(':CallLib')
       implementation project(':IMKit')
       implementation project(':IMLib')
   }

源码手动导入

融云提供 CallKit 源码，是为方便开发者根据 App 风格对呼叫 UI 做个性化的修改，比如色调搭配，按钮位置等，都可以自由定制。

CallKit Github 源代码地址：GitHub · Gitee

1. 先按照 Maven 导入或本地手动导入的方式，集成 CallLib、IMKit、IMLib 三个 CallKit 依赖库，并确保都是当时官网的最新版本，如下：

   Groovy

   dependencies {
       implementation 'cn.rongcloud.sdk:call_lib:x.y.z'
       implementation 'cn.rongcloud.sdk:im_kit:x.y.z'
       implementation 'cn.rongcloud.sdk:im_lib:x.y.z'
   }

   注意

   • 融云不提供老版本 CallKit 开源代码下载。用户配合 CallKit 所使用的 CallLib、IMKit、IMLib 版本需要是官网当前最新版本。
   • 从 5.2.0 版本开始，CallKit/CallLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致（前三位必须保持一致）。

2. 进入工程目录，克隆 CallKit 源码：

   shell

   cd <ProjectFolder>
   git clone https://github.com/rongcloud/callkit-android.git

3. 在 settings.gradle 文件中，添加引用：

   Groovy

   include ':callkit-android'

4. 在应用的 build.gradle 中，添加依赖：

   Groovy

   dependencies {
       ...
       implementation project(':callkit-android')
   }