环信2.x升级3.0变动介绍

2019独角兽企业重金招聘Python工程师标准>>>

SDK 2.x至3.0升级指南

使用升级替换脚本

可以使用SDK中的自动替换脚本替换大部分原有API的变动， 有部分需要手动更新的请见下面的说明。

./replace.sh your_source_folder

注意

该脚本可以允许在linux，mac及cygwin环境下并需要可执行权限

如果在mac下，需要用户用brew或其他方式安装gsed

API大致变动介绍

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();

              }

          }

      }

  }

转载于:https://my.oschina.net/u/2508574/blog/632211