集成 Android SDK - IM 即时通讯

开发者中心

IM 即时通讯

集成开发

集成 Android SDK

更新时间： 2024/11/20 13:48:32

网易云信即时通讯（NetEase IM）SDK V10（以下简称 NIM SDK）融合了 V9 接口，本文介绍如何快速将 NIM Android SDK 集成到您的 Android 项目中。

开发环境要求

Android 5.0 及以上版本。

第一步：集成 SDK

方式一：（推荐）Gradle 集成

若您需要创建新项目，在 Android Studio 里，在顶部菜单依次选择 File > New > New Project 新建工程，再依次选择 Phone and Tablet > Empty Activity，单击 Next。

创建 Android 项目成功后，Android Studio 会自动开始同步 gradle, 您需要等同步成功后再进行下一步操作。
在项目根目录下的 build.gradle 文件中，配置 repositories（使用 Maven）。示例代码如下：
```
Groovyallprojects {
    repositories {
        mavenCentral()
    }
}
```

在 app 目录下的 build.gradle 文件中，配置支持的 SO 库架构。示例代码如下：

Groovyandroid {
defaultConfig {
    ndk {
        //设置支持的 SO 库架构
        abiFilters "armeabi-v7a", "x86","arm64-v8a","x86_64"
        }
}
}

根据您的项目的需求，添加对应的依赖。

NIM SDK 组件版本号 必须一致。可在 SDK 更新日志中查看当前最新版本。

Groovydependencies {
    compile fileTree(dir: 'libs', include: '*.jar')
    // 添加依赖。注意，版本号必须一致。

    // 基础功能 (必需)
    implementation "com.netease.nimlib:basesdk:${LATEST_VERSION}"

    // 聊天室需要
    implementation "com.netease.nimlib:chatroom:${LATEST_VERSION}"

    // 通过网易云信来集成小米等厂商推送需要
    implementation "com.netease.nimlib:push:${LATEST_VERSION}"

    // 超大群需要
    implementation "com.netease.nimlib:superteam:${LATEST_VERSION}"

    // 全文检索插件
    implementation "com.netease.nimlib:lucene:${LATEST_VERSION}"
}

方式二：手动集成

手动集成是指您通过下载 SDK，然后集成到工程项目中。

若您需要创建新项目，在 Android Studio 里，在顶部菜单依次选择 File > New > New Project 新建工程，再依次选择 Phone and Tablet > Empty Activity，单击 Next。

创建 Android 项目成功后，Android Studio 会自动开始同步 gradle, 您需要等同步成功后再进行下一步操作。
在 SDK 下载页面下载最新版本的 SDK。

按需将对应的 SDK 文件拷贝至工程的 libs 目录下，即可完成配置。

SDK 文件说明如下：

Bashlibs
├── arm64-v8a
│   ├── libne_audio.so          //语音消息录制功能，必需
│   ├── traceroute.so           //网络探测功能，必需
| ├── libc++_shared.so        //C++动态库，必需
| ├── libhigh-available.so    //高可用功能库，必需
├── armeabi-v7a
│   ├── libne_audio.so
│   ├── traceroute.so
| ├── libc++_shared.so
| ├── libhigh-available.so
├── x86
│   ├── libne_audio.so
│   ├── traceroute.so
| ├── libc++_shared.so
| ├── libhigh-available.so
├── x86_64
│   ├── libne_audio.so
│   ├── traceroute.so
| ├── libc++_shared.so
| ├── libhigh-available.so
│
├── nim-basesdk-x.x.x.jar       //IM 基础功能，必需
├── nim-chatroom-x.x.x.jar      //聊天室功能
├── nim-lucene-x.x.x.jar        //全文检索插件
├── nim-push-x.x.x.jar          //通过网易云信来集成设备厂商（例如小米手机）推送时需要

在 app/build.gradle 文件中设置 libs 路径。

Groovyandroid {
      ...
    compileOptions {
        // SDK 依赖的 JDK 版本为 Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    ...

    dependencies {
        implementation fileTree(dir: "libs", include: ["*.jar"])
        ...
    }
}

单击 File > Sync Project With Gradle Files 按钮，直到同步完成。

第二步：配置权限

您可以根据实际应用需求，设置所需的权限。

在 AndroidManifest.xml 中添加以下配置，并请将 com.netease.nim.demo 替换为自己的包名。

您可在 AndroidManifest.xml 中配置网易云信的 App Key，也可在初始化时配置。App Key 通过在网易云信控制台上创建应用获取。

XML<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.netease.nim.demo">

    <!-- 权限声明 -->
    <!-- 访问网络状态-->
    <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" />

    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>

    <!-- 外置存储存取权限 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

    <!-- 多媒体相关 -->
    <uses-permission android:name="android.permission.CAMERA"/>
    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
    <!-- Android11：V8.6.1 及之后的版本不需要。其他：V4.4.0 及之后的版本不需要。 -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>

    <!-- 控制呼吸灯，振动器等，用于新消息提醒 -->
    <uses-permission android:name="android.permission.FLASHLIGHT" />
    <uses-permission android:name="android.permission.VIBRATE" />

    <!-- 8.0+系统需要-->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

    <!-- 下面的 uses-permission 一起加入到您的 AndroidManifest 文件中。-->
    <permission
        android:name="com.netease.nim.demo.permission.RECEIVE_MSG"
        android:protectionLevel="signature"/>

     <uses-permission android:name="com.netease.nim.demo.permission.RECEIVE_MSG"/>

    <application
        ...>
        <!-- App key, 可以在这里设置，也可以在 SDKOptions 中提供。
            如果 SDKOptions 中提供了，则取 SDKOptions 中的值。-->
        <meta-data
            android:name="com.netease.nim.appKey"
            android:value="key_of_your_app" />

        <!-- 网易云信后台服务，请使用独立进程。-->
        <service
            android:name="com.netease.nimlib.service.NimService"
            android:process=":core"/>
        <!-- 网易云信后台服务，使用 V10 接口需要添加以下代码。-->
        <service
            android:name="com.netease.nimlib.service.NimServiceV2" />

        <!-- 网易云信后台辅助服务 -->
        <service
            android:name="com.netease.nimlib.job.NIMJobService"
            android:exported="false"
            android:permission="android.permission.BIND_JOB_SERVICE"
            android:process=":core"/>

        <!-- 网易云信监视系统启动和网络变化的广播接收器，保持和 NimService 同一进程 -->
        <receiver android:name="com.netease.nimlib.service.NimReceiver"
            android:process=":core"
            android:exported="false">
            <intent-filter>
                <action android:name="android.net.conn.CONNECTIVITY_CHANGE"/>
            </intent-filter>
        </receiver>

        <!-- 网易云信进程间通信 Receiver -->
        <receiver android:name="com.netease.nimlib.service.ResponseReceiver"/>

        <!-- 网易云信进程间通信 service -->
        <service android:name="com.netease.nimlib.service.ResponseService"/>

        <!-- 网易云信进程间通信 provider -->
        <provider
            android:name="com.netease.nimlib.ipc.NIMContentProvider"
            android:authorities="com.netease.nim.demo.ipc.provider"
            android:exported="false"
            android:process=":core" />
        <!-- 网易云信进程间通信 provider，使用 V10 接口需要添加以下代码。-->
        <provider
            android:name="com.netease.nimlib.ipc.NIMContentProviderV2"
            android:authorities="${applicationId}.ipc.provider.v2"
            android:exported="false" />

          <!-- 网易云信内部使用的进程间通信 provider -->
          <!-- SDK 启动时会强制检测该组件的声明是否配置正确，如果检测到该声明不正确，SDK 会主动抛出异常引发崩溃 -->
        <provider
            android:name="com.netease.nimlib.ipc.cp.provider.PreferenceContentProvider"
            android:authorities="com.netease.nim.demo.ipc.provider.preference"
            android:exported="false" />
    </application>
</manifest>

第三步：代码防混淆

代码混淆是指使用简短无意义的名称重命名已存在的类、方法、属性等，增加逆向工程的难度，保障 Android 程序源码的安全性。

为了避免因上述的重命名而导致调用 NIM SDK 异常，请在 proguard-rules.pro 文件中加入以下代码，将 NIM SDK 相关类加入不混淆名单。

ProGuard-dontwarn com.netease.nim.**
-keep class com.netease.nim.** {*;}

-dontwarn com.netease.nimlib.**
-keep class com.netease.nimlib.** {*;}

-dontwarn com.netease.share.**
-keep class com.netease.share.** {*;}

-dontwarn com.netease.mobsec.**
-keep class com.netease.mobsec.** {*;}

#如果您使用全文检索插件，需要加入
-dontwarn org.apache.lucene.**
-keep class org.apache.lucene.** {*;}

#如果您开启数据库功能，需要加入
-keep class net.sqlcipher.** {*;}

下一步

完成 SDK 集成后，需进行初始化。

API 参考

您可以参考 API 概览，查看并了解 NIM SDK API。

此文档是否对你有帮助？

有帮助

去反馈

开发环境要求
第一步：集成 SDK
方式一：（推荐）Gradle 集成
方式二：手动集成
第二步：配置权限
第三步：代码防混淆
下一步
API 参考