SDK 2.x 至 3.x 升级指南

3.0 中的核心类为 EMClient 类，通过 emclient 类可以获取到 chatmanager、groupmanager、contactmanager、chatroommanager 等 manager 对象，此外和这些 manager 不太相关的方法基本 EMClient 类里面，如登录、设置连接监听等方法。message 里的成员变量的获取都变成 getXXX 获取。

从 2.x 升级到 3.0，大部分的变动只需要改变 API 名称就可以了，但是少部分地方因为架构等原因需要一些稍复杂的改动。

这里先列出API大概的变动列表：

消息接发对于以前通过 conversation.addConversation() 方法，然后在 adapter 中发送消息的开发者来说变动稍微有点大，这里再单独列出来修改方法：

首先把 conversation.addMessage(message) 删除掉，然后调用 sendmessage 方法，在 messageadapter 显示消息的地方，不再调用 sendmessage 方法，adapter 里只是根据消息的状态显示相应的 UI 即可，通过调用 message.setMessageStatusCallback(messageReceiveCallback)，监听消息是否发送成功等，这里以发送文字消息作为示例：

protected void sendMessage(EMMessage message){
        if(chatFragmentListener != null){
            //设置扩展属性
            chatFragmentListener.onSetMessageAttributes(message);
        }
        // 如果是群聊，设置chattype,默认是单聊
        if (chatType == EaseConstant.CHATTYPE_GROUP){
            message.setChatType(ChatType.GroupChat);
        }else if(chatType == EaseConstant.CHATTYPE_CHATROOM){
            message.setChatType(ChatType.ChatRoom);
        }
        //发送消息
        EMClient.getInstance().chatManager().sendMessage(message);
        //刷新ui
        messageList.refreshSelectLast();
    }

在显示消息的 adpater 中，根据消息状态显示相应 UI 即可。

protected void handleTextMessage() {
        if (message.direct() == EMMessage.Direct.SEND) {
            setMessageSendCallback();
            switch (message.status()) {
            case CREATE: 
                progressBar.setVisibility(View.GONE);
                statusView.setVisibility(View.VISIBLE);
                break;
            case SUCCESS: // 发送成功
                progressBar.setVisibility(View.GONE);
                statusView.setVisibility(View.GONE);
                break;
            case FAIL: // 发送失败
                progressBar.setVisibility(View.GONE);
                statusView.setVisibility(View.VISIBLE);
                break;
            case INPROGRESS: // 发送中
                progressBar.setVisibility(View.VISIBLE);
                statusView.setVisibility(View.GONE);
                break;
            default:
               break;
            }
        }else{
            if(!message.isAcked() && message.getChatType() == ChatType.Chat){
                try {
                    EMClient.getInstance().chatManager().ackMessageRead(message.getFrom(), message.getMsgId());
                } catch (HyphenateException e) {
                    e.printStackTrace();
                }
            }
        }
    }

• 3.1.5api修改
• 3.2.3api修改
• 3.3.0api修改