网易云IM(即时通讯) 集成指南(Android)

新手接入指南

网易云官网地址自行观看，开发文档很清楚。

两种集成方式

1.as 通过gradle导入依赖集成

2.手动下载sdk.

我们这里用第一种方式，毕竟我的as 已经是4.0.1，第一种更方便一些。

1.首先，在整个工程的 build.gradle 文件中，配置 repositories，使用 jcenter 或者 maven ，二选一即可，如下：

allprojects {

repositories {

jcenter() // 或者 mavenCentral()

}

}

2.然后，在主工程的 build.gradle 文件中，添加 dependencies。(说明：添加这个型号的时候可能会影响你之前导入的比如百度地图…或者一些别的第三方插件，如果有影响请去相应网站下载对应的x86 arm这些的.so文件 )

android {

defaultConfig {

ndk {

//设置支持的SO库架构

abiFilters "armeabi-v7a", "x86","arm64-v8a","x86_64"

}

}

}

3.再是根据自己项目的需求，添加不同的依赖。注意：云信的组件版本号必须一致。可在SDK下载页面查看当前最新版本。这里以 x.x.x 版本为例(我用的 7.6.0)：

dependencies {

compile fileTree(dir: 'libs', include: '*.jar')

// 添加依赖。注意，版本号必须一致。

// 基础功能 (必需)

implementation 'com.netease.nimlib:basesdk:x.x.x'

// 聊天室需要

implementation 'com.netease.nimlib:chatroom:x.x.x'

// 通过云信来集成小米等厂商推送需要

implementation 'com.netease.nimlib:push:x.x.x'

// 超大群需要

implementation 'com.netease.nimlib:superteam:x.x.x'

// 全文检索插件

implementation 'com.netease.nimlib:lucene:x.x.x'

}

4. 权限与组件

在 AndroidManifest.xml 中加入以下配置(请将 com.netease.nim.demo 替换为自己的包名):

package="com.netease.nim.demo">

android:name="com.netease.nim.demo.permission.RECEIVE_MSG"

android:protectionLevel="signature"/>

...>

android:name="com.netease.nim.appKey"

android:value="key_of_your_app" />

android:name="com.netease.nimlib.service.NimService"

android:process=":core"/>

android:name="com.netease.nimlib.service.NimService$Aux"

android:process=":core"/>

android:name="com.netease.nimlib.job.NIMJobService"

android:exported="true"

android:permission="android.permission.BIND_JOB_SERVICE"

android:process=":core"/>

android:process=":core"

android:exported="false">

android:name="com.netease.nimlib.ipc.NIMContentProvider"

android:authorities="com.netease.nim.demo.ipc.provider"

android:exported="false"

android:process=":core" />

5.混淆配置

如果你的 apk 最终会经过代码混淆，请在 proguard 配置文件中加入以下代码:

-dontwarn com.netease.**

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

#如果你使用全文检索插件，需要加入

-dontwarn org.apache.lucene.**

-keep class org.apache.lucene.** {*;}

6.初始化

初始化

将SDK集成到客户端后，使用SDK前需要先完成初始化工作。此外请注意：v6.9.0起，改用AndroidX支持库，Target API 改为28，不再支持support库。

推荐在应用的 Application#onCreate 中，加入 SDK 的初始化代码：

public class NimApplication extends Application {

/**

* 注意：每个进程都会创建自己的Application 然后调用onCreate()方法，

* 如果用户有自己的逻辑需要写在Application#onCreate()(还有Application的其他方法)中，一定要注意判断进程，不能把业务逻辑写在core进程，

* 理论上，core进程的Application#onCreate()(还有Application的其他方法)只能做与im sdk 相关的工作

*/

public void onCreate() {

// ... your codes

// SDK初始化(启动后台服务，若已经存在用户登录信息， SDK 将进行自动登录)。不能对初始化语句添加进程判断逻辑。

NIMClient.init(this, loginInfo(), options());

// ... your codes

// 使用 `NIMUtil` 类可以进行主进程判断。

// boolean mainProcess = NIMUtil.isMainProcess(context)

if (NIMUtil.isMainProcess(this)) {

// 注意：以下操作必须在主进程中进行

// 1、UI相关初始化操作

// 2、相关Service调用

}

}

// 如果提供，将同时进行自动登录。如果当前还没有登录用户，请传入null。详见自动登录章节。

private LoginInfo loginInfo() {

return null;

}

// 设置初始化配置参数，如果返回值为 null，则全部使用默认参数。

private SDKOptions options() {

SDKOptions options = new SDKOptions();

...

// 配置是否需要预下载附件缩略图，默认为 true

options.preloadAttach = true;

...

return options;

}

}

到了这里就可以 集成告一段落(下一篇 网易云登录指南)

本文地址：https://blog.csdn.net/shilei_comeon/article/details/108143464

如您对本文有疑问或者有任何想说的，请点击进行留言回复，万千网友为您解惑！