碎碎念

最近听闻gitHub要被微软收购了，不知广大码农们作何感想。我最大的想法就是觉得gitHub的员工应该有一个蛮不错的CEO，为什么呢？因为他们的CEO 万斯特拉斯，简称万总，一个典型的码农。当然万总是一个天才级的码农，使用了各种先进的技术，创立了github，并不断优化。后来随着公司越来越大，万总已经不能完全投入精力去研究他喜欢的新技术，也要管理公司.....
根据彭博社获得的财务数据显示，万总上一财年的工资和福利开了7100万美元，2016 年 2 月至 10 月的开支更是达到1.08 亿美元!
可以说万总是很照顾员工了，花钱的速度都比赚钱的速度快，大概觉得咱们码农都不容易。但是gitHub 在万总的经营下，有了亏损，同时也受到了外界的质疑。然后万总最近表示也很不开心，吗的这不是劳资天才码农要的生活，劳资要赶紧把这公司卖了，做一个旅行的小青蛙，顺便再写点代码，美滋滋。
（PS：以上内容纯属个人想象，下面开始敲黑板）

一、简介

主要记录我在集成环信的SDK及使用easeUI库过程中，遇到的一些问题，包括：定制化一些UI界面、群聊、红包功能等。一篇文章可能讲不完，后续会慢慢整理。

二、集成

集成有两种方式，一种是导入本地导入，另一种通过gradle远程链接导入，我是通过本地导入方式集成的：

首先要从环信官网上下载相应SDK 解压之后可以看到4个文件夹

1、在自行开发的应用中，集成环信聊天需要把 libs 文件夹下的 so 文件复制到你的项目的 libs 文件夹相应位置就可以了，不用导入jar包，下面会解释原因。

如果不需要语音和视频通话功能，导入libs.without.audio 下的文件即可。
（PS:这句话是环信官网上的，我也没找到libs.without.audio，忽略这句话好了。）

2、之后导入easeui Model，并在AndroidStudio中打开ProjectStructure窗口，在dependencies选项中添加依赖。可以在项目中打开easeui中的libs文件夹，我们可以看到里面已经有了hyphenatechat_x.x.0.jar

3、在清单文件 AndroidManifest.xml 里加入以下权限，以及写上你注册的 AppKey。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="Your Package"
    android:versionCode="100"
    android:versionName="1.0.0">
  
    <!-- Required -->
    <uses-permission android:name="android.permission.VIBRATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>  
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
 
    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:name="Your Application">
  
   	<!-- 设置环信应用的AppKey -->
    	<meta-data android:name="EASEMOB_APPKEY"  android:value="Your AppKey" />
    	<!-- 声明SDK所需的service SDK核心功能-->
    	<service android:name="com.hyphenate.chat.EMChatService" android:exported="true"/>
        <service android:name="com.hyphenate.chat.EMJobService"
            android:permission="android.permission.BIND_JOB_SERVICE"
            android:exported="true"
            />
        <!-- 声明SDK所需的receiver -->
        <receiver android:name="com.hyphenate.chat.EMMonitorReceiver">
            <intent-filter>
                <action android:name="android.intent.action.PACKAGE_REMOVED"/>
                <data android:scheme="package"/>
            </intent-filter>
            <!-- 可选filter -->
            <intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED"/>
                <action android:name="android.intent.action.USER_PRESENT" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

4、打包混淆配置

-keep class com.hyphenate.** {*;}
-dontwarn  com.hyphenate.**

需要注意：

（1）不要导入 hyphenatechat_3.3.9.jar，否则会和 easeui 中依赖的jar包冲突在打包时会出现：

Error:Execution failed for task ':app:transformClassesWithJarMergingForRelease'.
> com.android.build.api.transform.TransformException: java.util.zip.ZipException: duplicate entry: com/hyphenate/EMCallBack.class

（2）当找不到 .so 库文件报错时：

 java.lang.UnsatisfiedLinkError:

检查 module 中 build.gradle 中

ndk {
    //选择要添加的对应cpu类型的.so库。
    abiFilters 'arm64-v8a', 'armeabi-v7a', 'x86'
    // 还可以添加 'x86', 'mips', 'mips64'
}

是否添加了以上指定类型的 so 库。至此，环信就集成完毕了。

三、环信初始化及相关问题

这块部分环信官网上已经有说明了，所以说一下其他方面需要初始化的操作，先贴一下官网的代码：

EMOptions options = new EMOptions();
// 默认添加好友时，是不需要验证的，改成需要验证
options.setAcceptInvitationAlways(false);
// 是否自动将消息附件上传到环信服务器，默认为True是使用环信服务器上传下载，如果设为 false，需要开发者自己处理附件消息的上传和下载
options.setAutoTransferMessageAttachments(true);
// 是否自动下载附件类消息的缩略图等，默认为 true 这里和上边这个参数相关联
options.setAutoDownloadThumbnail(true);
...
//初始化
EMClient.getInstance().init(applicationContext, options);
//在做打包混淆时，关闭debug模式，避免消耗不必要的资源
EMClient.getInstance().setDebugMode(true);

1、其中的 EMOptions 类比较关键，我们还可以通过它设置：添加好友是否需要验证，是否需要环信 sdk 自动登录等。 这个时候会出现环信的一个坑——自动登录 官网上的说明是这样的：

事实上自动登录的确不稳定，经常出现点击会话，进入聊天界面之后，消息发送不出去，因为你没有登录成功。。。 所以这块还是墙裂建议关掉自动登录，自己手动登录吧。

        //设置手动登录
        options.setAutoLogin(false);

2、由于在项目中我使用到了 easeUi ，所以需要对 easeUi 进行初始化操作。

//初始化easeUi.
 EaseUI.getInstance().init(application.getApplicationContext(), options);

3、EaseAvatarOptions 设置头像形状。

public void setEaseUIProviders(){
    //设置EaseUI控件参数
    EaseAvatarOptions avatarOptions = new EaseAvatarOptions();
    //0：默认，1：圆形，2：矩形
    avatarOptions.setAvatarShape(2);
    EaseUI.getInstance().setAvatarOptions(avatarOptions);
}

4、如果需要显示用户的昵称头像，请设置用户信息提供者 EaseUserProfileProvider。

// set profile provider if you want easeUI to handle avatar and nickname
        EaseUI.getInstance().setUserProfileProvider(new EaseUI.EaseUserProfileProvider() {

            @Override
            public EaseUser getUser(String username) {
                //userName即环信用户id或环信群id
                return getUserInfo(username);
            }
    
        });

5、其中的 EaseUserProfileProvider 就是关键所在了，我们需要实现 getUser 方法，用来获取缓存在本地数据库中的用户信息、群组信息，例如用户的昵称、性别等。具体可以参考下一篇文章。

6、下面是最后一步，设置以下全局监听器：
消息监听——EMMessageListener、
群组事件监听——EMGroupChangeListener、
好友变化监听——EMContactListener、
连接监听——EMConnectionListener

我们可以参考环信demo中 DemoHelper 类的部分监听处理，来实现自己的业务逻辑。
（温馨提示：其中的 EMMessageListener、EMGroupChangeListener 这两个基本上可以直接拿来使用。）

最终贴上我们最终初始化的代码：

private void initEasy() {
        EMOptions options = new EMOptions();
        // 默认添加好友时，是不需要验证的，改成需要验证由于在
        options.setAcceptInvitationAlways(false);
        // 是否自动将消息附件上传到环信服务器，默认为True是使用环信服务器上传下载，如果设为 false，需要开发者自己处理附件消息的上传和下载
        options.setAutoTransferMessageAttachments(true);
        // 是否自动下载附件类消息的缩略图等，默认为 true 这里和上边这个参数相关联
        options.setAutoDownloadThumbnail(true);
        //设置手动登录
        options.setAutoLogin(false);
        //初始化
        EaseUI.getInstance().init(application.getApplicationContext(), options);
        EMClient.getInstance().init(application.getApplicationContext(), options);
        //在做打包混淆时，关闭debug模式，避免消耗不必要的资源
        EMClient.getInstance().setDebugMode(true);

        //设置
        EaseHelper.getEaseHelper(this).setEaseUIProviders();
        //设置全局的消息监听
        EaseHelper.getEaseHelper(this).registerMessageListener();
        EaseHelper.getEaseHelper(this).registerGroupAndContactListener();
        EaseHelper.getEaseHelper(this).registerConnectionListener();

    }

四、单点登录

错误字段：
EMError.USER_LOGIN_ANOTHER_DEVICE、 EMError.USER_KICKED_BY_OTHER_DEVICE

    //设置连接监听，单点登录
    private EMConnectionListener connectionListener = new EMConnectionListener() {
        @Override
        public void onConnected() {
        }
        @Override
        public void onDisconnected(int error) {
            if (error == EMError.USER_LOGIN_ANOTHER_DEVICE || error == EMError.USER_KICKED_BY_OTHER_DEVICE){
                EventBusUtil.post(new LogoutEvent("您的账号已在其他设备登录，请重新登录"));
            }
        }
    };
    public void registerConnectionListener(){
        EMClient.getInstance().addConnectionListener(connectionListener);
    }