网易云IM(即时通讯) 集成指南(Android)
网易云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 替换为自己的包名):
<?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"/>
<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"/>
<!-- 云信后台辅助服务 -->
<service
android:name="com.netease.nimlib.service.NimService$Aux"
android:process=":core"/>
<!-- 云信后台辅助服务 -->
<service
android:name="com.netease.nimlib.job.NIMJobService"
android:exported="true"
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.intent.action.BOOT_COMPLETED"/>
<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" />
</application>
</manifest>
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
上一篇: 打开注册表的方法
下一篇: Uniapp条件注释实现跨段兼容