tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
即时通信 IM
    文档
    Download PDF

    Android

    最后更新时间：2024-01-02 16:10:56
    下载PDF
      本文主要介绍如何快速将腾讯云即时通信 IM SDK 集成到您的 Android 项目中。

      开发环境要求

      JDK 1.6。
      Android 4.1（SDK API 16）及以上系统。

      集成 SDK（aar）

      您可以选择使用 Gradle 自动加载的方式，或者手动下载 aar 再将其导入到您当前的工程项目中。

      方法一：自动加载（aar）

      您可以通过配置 gradle 自动下载更新已经发布到 Maven Central 库的 IM SDK。 只需要用 Android Studio 打开需要集成 SDK 的工程，然后通过如下三个步骤修改 app/build.gradle 文件，就可以完成 SDK 集成：

      步骤1：添加 SDK 依赖

      1. 找到 app 的 build.gradle，首先在 repositories 中添加 mavenCentral() 的依赖：
      repositories {
          google()
          jcenter()
          // 增加 mavenCentral 仓库
          mavenCentral()
      }
      2. 然后在 dependencies 中添加 IM SDK 的依赖：
      dependencies {
          // 添加 IM SDK，推荐填写最新的版本号
          api 'com.tencent.imsdk:imsdk-plus:版本号'
           
          // 如果您需要添加 Quic 插件，请取消下一行的注释（注意：要求插件版本号和 IM SDK 版本号相同）
          // api "com.tencent.imsdk:timquic-plugin:版本号"
      }
      说明
      “版本号”应替换为 SDK 的实际版本号，建议使用 最新版本。
      以版本号是5.4.666为例：
      dependencies {
          api 'com.tencent.imsdk:imsdk-plus:5.4.666'
      }
      Quic 插件，提供 axp-quic 多路传输协议，弱网抗性更优，网络丢包率达到 70% 的条件下，仍然可以提供服务。仅对旗舰版用户开放，对于非旗舰版，请购买旗舰版套餐包 后可使用，详见 价格说明。为确保功能正常使用，请将终端 SDK 更新至 7.7.5282 及其以上的版本。

      步骤2：指定 App 使用架构

      在 defaultConfig 中，指定 App 使用的 CPU 架构（从 IM SDK 4.3.118 版本开始支持 armeabi-v7a，arm64-v8a，x86，x86_64）：
      defaultConfig {
          ndk {
              abiFilters "arm64-v8a"
          }
      }

      步骤3：同步 SDK

      单击 Sync 按钮，如果您的网络连接 jcenter 没有问题，SDK 就会自动下载集成到工程里。
      
      
      

      方法二：手动下载（aar）

      如果您的网络连接 jcenter 有问题，也可以手动下载 SDK 集成到工程里：

      步骤1：下载 IM SDK

      在 Github 上可以下载到最新版本的 IM SDK。

      步骤2：拷贝 IM SDK 到工程目录

      
      
      

      步骤3：指定 App 使用架构并编译运行

      在 app/build.gradle 的 defaultConfig 中，指定 App 使用的 CPU 架构（从 IM SDK 4.3.118 版本开始支持 armeabi-v7a，arm64-v8a，x86，x86_64）：
      defaultConfig {
          ndk {
              abiFilters "arm64-v8a"
          }
      }
      说明：
      如果您需要添加 Quic 插件，请参考前面的步骤，手动下载集成 Quic 插件。

      集成 SDK

      如果您不想集成 aar 库，也可以通过导入 jar 和 so 库的方式集成 IM SDK：

      步骤1：下载解压 IM SDK

      在 Github 上可以 下载 到最新版本的 aar 文件。解压后的目录里面主要包含 jar 文件和 so 文件夹，把其中的 classes.jar 重命名成 imsdk.jar 。
      
      
      

      步骤2：拷贝 SDK 文件到工程目录

      将重命名后的 jar 文件和各个架构的 so 文件分别拷贝到 Android Studio 默认加载的目录下：
      
      
      

      步骤3：指定 App 使用架构并编译运行

      在 app/build.gradle 的 defaultConfig 中，指定 App 使用的 CPU 架构（从 IM SDK 4.3.118 版本开始支持 armeabi-v7a，arm64-v8a，x86，x86_64）：
      defaultConfig {
          ndk {
              abiFilters "arm64-v8a"
          }
      }

      配置 App 权限

      在 AndroidManifest.xml 中配置 App 的权限，IM SDK 需要以下权限：
      <uses-permission android:name="android.permission.INTERNET" />
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
      <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

      设置混淆规则

      在 proguard-rules.pro 文件，将 IM SDK 相关类加入不混淆名单：
      -keep class com.tencent.imsdk.** { *; }
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款