差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
im:android:sdk:releasenote [2020/06/29 09:02]
liujn
im:android:sdk:releasenote [2022/04/19 09:36] (当前版本)
amy.hao [版本 V3.9.1 Dev 2022-4-19]
行 1: 行 1:
 ====== Android SDK 更新日志 ====== ====== Android SDK 更新日志 ======
  
-==== 版本 V3.6.9.1 2020-06-29 ==== +===== 版本 V3.9.1 Dev 2022-4-19 ===== 
 + 
 +=== 新增特性:​ === 
 + 
 +  * [IM SDK] 增加用户在线状态(Presence)订阅功能; 
 +  * [IM SDK] 增加自动翻译接口。除了按需翻译,IM 实现自动翻译。 
 + 
 +=== 优化: ===  
 + 
 +  * [IM SDK] 缩短发送消息超时时间。 
 +  * [IM SDK] DNS 服务器地址列表支持优先级设置,HTTP 和 TCP 请求重试时按 DNS 服务器地址的优先级发送请求,提升请求成功率。  
 +  * [IM SDK] IM SDK 所依赖的 OPPO 推送和 vivo 推送的 SDK 版本升级。 
 + 
 +=== 修复: === 
 + 
 +  * [IM SDK] 修复 PendingIntent 问题,移除 IM 在 Google Play 上架时的警告。 
 + 
 +===== 版本 V3.9.0 Dev 2022-2-22 ===== 
 + 
 +=== 新增特性:​ === 
 + 
 +  * [IM SDK] [EaseIMKIt] 增加单向删除服务端会话 API; 
 +  * [IM SDK] Push 平台增加推送支持扩展字段获取、后续动作、角标设置、透传消息等功能,见 [[push:​apppush:​androidsdk|Android 推送集成]]; 
 +  * [IM SDK] 增加非好友不能发送消息错误码; 
 +  * [IM SDK] [EaseIMKIt] 增加通过 REST 接口撤回消息功能。 
 + 
 +=== 优化: ===  
 + 
 +  * [IM SDK] 减少弱网时发送消息的等待时间。 
 + 
 +=== 修复: === 
 + 
 +  * [IM SDK] 修复消息发送重试被连接成功事件中断; 
 +  * [IM SDK] 修复内存泄漏问题; 
 +  * [IM SDK] 修复因时间统计为负数导致崩溃问题。 
 +===== 版本 V3.8.9.1 2021-12-30 ===== 
 +修复: 
 +  * [IM SDK] 增加极端情况下打开数据库失败时重建数据库的策略。 
 + 
 +===== 版本 V3.8.9 Dev 2021-12-27 ===== 
 +新增: 
 +  * [IM SDK]增加翻译功能 API; 
 +  * [IM SDK]位置消息增加建筑物名称字段; 
 +  * [IM SDK]增加按照时间删除消息的 API; 
 +  * [IM SDK]增加获取会话中消息总数的 API; 
 +修复: 
 +  * [IM SDK]修复部分 crash 的问题; 
 +  * [IM SDK]修复数据库加密的 bug; 
 + 
 +===== 版本 V3.8.8 Dev 2021-12-06 ===== 
 +新增: 
 +  * [IM SDK] 增加获取登录状态的 API。 
 + 
 +更新: 
 +  * [IM SDK] 更新部分函数命名与注释; 
 +  * [IM SDK] 优化推送 token 的更新逻辑,降低对服务器的请求次数; 
 +  * [IM SDK] 优化登录速度; 
 +  * [IM SDK] 优化群组消息在 token 过期时的处理逻辑; 
 +  * [IM SDK] EMOptions 中默认使用 https only。 
 + 
 +修复: 
 +  * [IM SDK] 修复拉取历史漫游消息不全的 bug; 
 +  * [IM SDK] 对荣耀手机推送的支持; 
 +  * [IM SDK] 部分场景下的 crash 问题; 
 +  * [EaseIMKIt] 修复部分场景下消息未读状态显示 bug; 
 +  * [EaseIMKIt] 低版本设备部分场景下的 crash 问题。 
 +  * [EaseIM App] 退出登录时用户信息未完全清除的 bug。 
 + 
 +**请注意: 此版本有偶发不能正常打开数据库的问题,请使用 3.8.9.1 版本。** 
 +===== 版本 V3.8.7 Dev 2021-10-22 ===== 
 +  * 增加:使用token登录时,在token过期时回调给上层app 
 +  * 修复:修复部分场景下传输加密的问题 
 + 
 +===== 版本 V3.8.6.1 Dev 2021-10-12 ===== 
 + 
 +新功能:​ 
 +  * [IM SDK] 增强本地存储数据的安全性 
 +  * [IM SDK] 增强传输数据的安全性 
 +  * [IM SDK] 增加用户被全局禁言时发消息会提示单独的错误码 
 + 
 +更新: 
 +  * [EaseIMKIt] 聊天页面语音消息按钮事件移到APP层 
 +  * [IM SDK] 检查发送ReadAck时to是否为空 
 + 
 +修复: 
 +  * [IM SDK] 修复WAKE_LOCK权限导致应用crash问题 
 +  * [IM SDK] 删除自定义证书异常打印 
 +  * [EaseIMKIt] 修复一般会话列表接收到位置信息后未显示用户昵称问题 
 + 
 + 
 +**请注意:**  
 +  - **从3.8.6.1开始我们采用Dev 和Stable版本并行的方式,用户可以根据需求选择使用的版本。** \\ 稳定版(Stable):基于开发版本,提供稳定的功能,持续修复 Bug,可用于发布应用;​\\ 开发版(Dev):最新版本,体现最新的功能和特性,不定期发布版本,可用于体验;​ 
 +  - **''​V3.8.6.1 Dev仅支持https。''​如您的项目(appkey)配置的是http,请勿升级该版本,否则会导致http用户无法正常登录;如不升级该版本则不受任何影响。** 
 + 
 + 
 +===== 版本 V3.8.5 2021-09-10 ===== 
 + 
 +新功能:​ 
 +  * [IM SDK] 对用户日志加强了安全保护。 
 + 
 +更新: 
 +  * [IM SDK] 设备id 使用随机生成的方式。 
 +  * [IM SDK] 移除对FCM 11.4.0版本的依赖,将FCM的逻辑移到应用层。 
 +  * [IM SDK] 如果设置了EMOptions#​setAutoTransferMessageAttachments(false),SDK发送消息时不再检查附件是否存在。 
 +  * [EaseIMKit] 在EaseChatFragment中暴露消息发送成功的回调onChatSuccess。 
 +  * [EaseIM] 将FCM逻辑移到应用层,并升级FCM Messaging到22.0.0版本,[[https://​docs-im.easemob.com/​im/​android/​push/​thirdpartypush#​sdk_385_%E7%89%88%E6%9C%AC%E4%B9%8B%E5%90%8E%E9%9B%86%E6%88%90%E6%96%B9%E5%BC%8F|FCM集成详见]]。 
 + 
 +修复: 
 +  * [IM SDK] 修复SDK某些场景下数据库损坏导致崩溃的问题。 
 +  * [EaseIMKit] 修复通讯录首字母识别不准确的问题。 
 +  * [EaseIMKit] 移除百度地图so文件。 
 +  * [EaseCallKit] 修复设置Agora appId无效的问题。 
 +  * [EaseCallKit] 修复部分场景下 user id为空导致崩溃的问题。 
 +  * [EaseCallKit] 修复在Android 11手机上,在音视频界面切到后台,音视频中断的问题。 
 + 
 +===== 版本 V3.8.4 2021-08-03===== 
 +新功能:​ 
 +  * [IM SDK] 新增单聊1v1免打扰功能 
 + 
 +更新: 
 +  * [EaseIM App] 增加单聊1v1免打扰开关 
 +  * [IM SDK] EMCmdMessageBody#​getParams方法增加已废弃注解 
 +  * [IM SDK] 更新API注释 
 +  * [IM SDK] 去除收集不必要的设备信息 
 +  * [IM SDK] 增加垃圾消息被拦截的错误码 
 + 
 +修复: 
 +  * [IM SDK] 修复APP运行在前台或者后台判断错误问题 
 +  * [EaseIM App] 修复置顶会话在新消息到达时未置顶的问题 
 +  * [EaseIM App] 修复未添加好友在好友列表显示问题 
 +  * [EaseIMKIt] 修复文本支持超链接时长按事件失效问题 
 + 
 +===== 版本 V3.8.3 2021-07-09 ===== 
 +更新: 
 +  * [IM SDK] 在EMClient中增加了对一些方法的保护; 
 +  * [IM SDK] 移除SDK中获取定位的相关逻辑; 
 +  * [IM SDK] 移除SDK中AndroidManifest的权限声明; 
 + 
 +修复: 
 +  * [EaseIMKIt] 修复某些场景下导致发送失败图标和已读标志重叠的问题; 
 +  * [EaseIMKIt] 修复某些场景下长按聊天条目崩溃的问题; 
 +  * [EaseIMKIt] 修复联系人列表不设置头部布局展示空布局的问题; 
 +  * [EaseIMKIt] 修复接收的图片或者视频封面没有设置宽高导致崩溃的问题; 
 +  * [EaseIM] 修复管理员将群成员加入到黑名单后无法再添加好友的问题; 
 +  * [EaseIM] 修复不能在群组和聊天室发送名片的问题; 
 +  * [EaseIM] 修复了会话列表中不展示群名称的问题; 
 + 
 + 
 +===== 版本 V3.8.2 2021-06-05 ===== 
 +新功能: 
 +  * [IM SDK] 新增增加异常事件上报功能,​ 需要开启,默认不会上报; 
 +  * [IM SDK] 新增增加针对发送前回调拦截的消息的错误码; 
 +  * [IM SDK] 新增支持多种不同应用(相同appkey)使用不同的消息过滤规则; 
 + 
 +修复: 
 +  * [IM SDK] 新增会话列表添加localpath,确保拉取会话列表语音/​视频/​图片可以下载;​ 
 +  * [IM SDK] 新增修复个别场景下长时间在前台可能会离线的bug; 
 +  * [IM SDK] 新增修复附件中含有%时上传失败的问题; 
 +  * [IM SDK] 新增使用登录api时,对于用户已登录增加描述信息(区分当前登录用户); 
 +  * [CallKit]增加与小程序互通功能和显示用户头像昵称; 
 + 
 +===== 版本 V3.8.1 2021-04-13 ===== 
 + 
 +新功能:  
 +    * [IM SDK] 新增设置、获取用户属性的接口,集成参见:[[im:​android:​basics:​profile|用户属性]] 
 +    * [EaseIM App] 新增用户资料(头像、昵称等)的存储、显示;​ 
 +    * [EaseIM App] 新增用户名片消息的发送与展示(使用自定义消息实现);​ 
 +修复: 
 +    * [EaseIMKIt] 修复发送多条带附件的消息时会发送重复的问题;​ 
 +    * [EaseIMKIt] 修复注册聊天类型时排序问题造成的展示问题;​ 
 +    * [EaseIMKIt] 提供发送消息前设置消息属性的接口(OnAddMsgAttrsBeforeSendEvent);​ 
 +    * [EaseIMKIt] 修复设置聊天页面条目的头像会被默认头像遮挡的问题; 
 +    * [EaseIMKIt] 优化上传文件的逻辑,修复部分场景无法上传文件的问题(EaseFileUtils);​ 
 +    * [IM SDK] 修复上传文件消息时没有设置文件长度的问题;​ 
 +    * [IM SDK] 修复SDK3.5.3后数据库从2.0迁移到3.0后加载会话列表消息不全的问题;​ 
 +更新(2021-05-08): 
 +    * [EaseCallkit] 修改加入声网频道的方式,改为使用数字uid加入,增加与小程序的互通,''​与之前版本不互通'',​参见[[im:​android:​other:​easecallkit|EaseCallKit使用指南]];​ 
 + 
 +''​**重大变动:**''​远程仓库统一由JCenter迁移到''​MavenCentral''​,依赖库的域名由"​com.hyphenate"​修改为''"​io.hyphenate"''​,详见[[im:​android:​sdk:​import|Android SDK 介绍及导入]]。 
 +===== 版本 V3.8.0 2021-02-27 ===== 
 + 
 +新功能: 
 + * [EaseCallkit] 发布EaseCallKit,​通话部分模块化为EaseCallKit;  
 + * [IM SDK] 增加群组成员批量操作的Api; 
 + * [IM SDK] 增加getContactsFromLocal()方法; 
 +更新: 
 + * [IM SDK] 3.8.0及以后版本SDK更新名为com.hyphenate:​hyphenate-chat:​x.x.x,​ 只发布IM功能,​ 移除环信音视频功能; 
 + * [EaseIM App] 环信app依赖声网音视频功能;​ 
 + 
 +修复: 
 + * [IM SDK] 修复极端情况用户名为空时请求token的的问题; 
 + * [IM SDK] 在EMGroup和EMChatRoom中增加PermissionType属性用以判断角色; 
 + * [IM SDK] 修复发送文件消息时没有设置文件长度的问题;​ 
 + * [EaseIMKit] 修复会话列表页面删除所有数据后,不展示空布局的问题; 
 +注意: 
 +        * **为提供更好的服务,从3.8.0开始SDK中不再提供音视频功能,而是在EaseCallKit中基于声网的SDK给出了音视频功能的参考实现。该方案呼叫功能不能与之前版本之间互通,请根据情况选择使用新方案或者继续使用之前的版本** 
 +        * EaseCallKit除了可以远程库外,也公布了源码,详情请见:[[http://​docs-im.easemob.com/​im/​android/​other/​easecallkit|EaseCallKit 使用指南]];​ 
 +===== 版本 V3.7.6 2021-09-17 ===== 
 + 
 +修复: 
 +  * [IM SDK] 移除SDK中获取定位的相关逻辑; 
 +  * [IM SDK] 移除SDK中AndroidManifest的权限声明; 
 +  * [IM SDK] 去除收集不必要的设备信息; 
 +  * [IM SDK] 修复音视频偶现空指针的bug; 
 +===== 版本 V3.7.5 2021-06-05 ===== 
 + 
 +修复: 
 + * [IM SDK] 修复个别场景下长时间在前台可能会离线的bug; 
 + 
 +''​**注意:**''​此版本只能从''​MavenCentral''​拉取,依赖库的域名由“com.hyphenate”修改为''"​io.hyphenate"''​,详见[[im:​android:​sdk:​import|Android SDK 介绍及导入]]。 
 +===== 版本 V3.7.4 2021-02-04 ===== 
 + 
 +新功能: 
 + * [IM SDK] 增加针对会话的read ack接口; 
 + * [IM SDK] 增加拉取会话列表的接口; 
 + * [IM SDK] 增加搜索自定义消息(消息类型为CUSTOM)的接口; 
 + 
 +更新: 
 + * [EaseIMKit] EaseChatLayout提供拦截按压录音按钮的方法(OnChatRecordTouchListener); 
 + * [EaseIMKit] 增加发送消息前设置消息属性(比如设置ext)的接口(OnAddMsgAttrsBeforeSendEvent); 
 + * [EaseIMKit] 增加发送会话已读回执的逻辑,减少发送消息回执(read ack)的次数; 
 + * [EaseIM App] 增加从服务器获取会话列表的逻辑(需申请开通); 
 + 
 +修复: 
 + * [IM SDK] 修复部分http重复请求的问题; 
 + * [IM SDK] 移除获取设备IMEI信息相关逻辑; 
 + * [EaseIMKit] 修复动图不发送已读回执(read ack)的问题;​ 
 + * [EaseIMKit] 修复群组会话页面不显示昵称(或者环信id)的问题; 
 + * [EaseIMKit] 修复开启漫游后,获取的历史消息不上屏的问题; 
 + * [EaseIMKit] 修复聊天页面拦截消息长按事件后,复制功能被拦截的问题; 
 + * [EaseIMKit] 修复聊天页面“正在输入”状态无法消失的问题; 
 + * [EaseIM App] 修复首次安装应用登录后偶现不展示群名称的问题; 
 + * [EaseIM App] 修复群主在群组聊天中@成员crash的问题; 
 + * [EaseIM App] 修复删除会话后,主页会话tab未读数未更新的问题; 
 + * [EaseIM App] 修复设置群组消息免打扰接收不到群消息的问题; 
 + * [EaseIM App] 修复通过id搜索公开群crash的问题; 
 + 
 + 
 +===== 版本 V3.7.3 2020-12-31 ===== 
 + 
 +新功能: 
 + * [EaseIMKit]EaseUI的升级版EaseIMKit正式发布远程依赖库了,版本号与IM SDK一致,详情请见:[[im:​android:​other:​easeimkit|EaseIMKit 使用指南]]; 
 + 
 +更新: 
 + * [IM SDK]提升android 音视频通话时音频的比特率(bitrate),提高声音质量; 
 + 
 +修复: 
 + * [IM SDK]修复特殊情况下传输加密引发的crash问题;​ 
 + * [IM SDK]修复部分android 安全问题,移除不必要的app monitor保活; 
 + * [IM SDK]修复调用updateMessage api时无法更新消息body的问题; 
 + * [IM SDK]修复Android Q版本以上手机发送图片消息时无法正确获取文件名的问题; 
 + * [IM SDK]修复删除本地消息后,调用ackMessageRead(发送已读回执) api失败的问题; 
 + 
 +**注意:** 
 +  - EaseIMKit除了可以远程库外,也公布了源码,详情请见:[[im:​android:​other:​easeimkit|EaseIMKit 使用指南]]; 
 +  - 新版App(EaseIM App)采用了新的appkey,不可用之前的账号进行登录,需要重新进行注册。 
 + 
 +===== 版本 V3.7.2 2020-10-30 ===== 
 + 
 +  * 处理相同id在其他设备上发出的read ack,实现已读状态在多个设备上的同步;  
 +  * 修复对于使用网线设备的网络连接判断不准确的bug; 
 +  * 改进加入聊天室,群组的速度,减少请求服务器次数; 
 +  * 注册用户名超过64位时返回错误码: USER_NAME_TOO_LONG;​ 
 +  * 修复群组公告长度判断的问题; 
 +  * 修复清晰度优先1v1作为被叫时不生效的bug;​ 
 +  * 修复外部输入数据时本地预览不能正常显示的bug;​ 
 +  * 修复极端情况下消息回调报错的问题;​  
 +  * 修复偶现的ExecutorService空指针问题;​ 
 +  * 修改添加群成员,邀请文案描述只能是“welcome”的问题; 
 +  * 修复setHostnameVerifier的安全隐患; 
 +  * 修复Android api 21以下(不包括21)delete请求出现异常的问题;​ 
 +  * 对Emclient中的getCurrentUser方法增加同步锁,​ 修复偶现的crash问题;​ 
 + 
 +===== 版本 V3.7.1 2020-08-27 ===== 
 +新功能: 
 + 
 +  * RTC增加设置质量优先的api;​ 
 +  * RTC增加设置获取集群代理的url的api;​ 
 +  * 增加显示推送详情的api;​ 
 + 
 +更新: 
 +  * 升级OPPO推送SDK升级到2.1.0版本;​ 
 +  * 修改更新推送昵称的api;​ 
 + 
 +修复: 
 +  * 修复发送原图,接收方获取不到图片宽高的问题;​ 
 + 
 +===== 版本 V3.7.0 2020-07-29 ===== 
 +新功能: 
 + 
 +  * 实现RTC质量监控,​上报RTC质量数据;​ 
 +  * 增加纯音频推流功能,​可设置音频参数;​ 
 +  * 增加多人推流到CDN接口的api;​ 
 +  * 增加推流到CDN自定义录制接口的api;​ 
 +  * 增加退出聊天室时是否保留会话的api;​ 
 +  * 增加设置心跳间隔的api;​ 
 +  * Demo中把1v1呼叫时的推送选项默认打开;​ 
 +  * 增加1V1语音 视频通话浮窗小窗口;​ 
 +  * 增加网络等异常无视频 音频数据,无数据回调接口;​ 
 +  * 增加发送接收音视频首帧数据的回调; 
 + 
 +修复: 
 +  * 修复构造图片消息时localpath为空时的bug;​ 
 +  * 修复发送图片消息可能会删除原图的bug;​ 
 + 
 + 
 +===== 版本 V3.6.9.1 2020-06-29 ​===== 
 修复: 修复:
   * 修复设置rest server端口设置失效的问题;   * 修复设置rest server端口设置失效的问题;
  
-==== 版本 V3.6.9 2020-06-23 ==== +===== 版本 V3.6.9 2020-06-23 ​===== 
 新功能: 新功能:
  
行 19: 行 325:
   * 修复华为p20 pro手机退出会议后,Demo直接返回到桌面的问题;   * 修复华为p20 pro手机退出会议后,Demo直接返回到桌面的问题;
  
-==== 版本 V3.6.8 2020-06-09 ==== +===== 版本 V3.6.8 2020-06-09 ​===== 
 新功能: 新功能:
  
行 27: 行 333:
 更新: 更新:
  
-  * 适配AndroidQ(支持上传附件通过Uri);+  * 适配AndroidQ(支持上传附件通过Uri,具体用法请参考[[im:​android:​basics:​message|发送消息]]);
   * 移除apache jar包;   * 移除apache jar包;
  
 修复: 修复:
   * 修复群组发起音视频会议无法邀请管理员的问题;   * 修复群组发起音视频会议无法邀请管理员的问题;
- +**注意:配合SDK适配AndroidQ,EaseUi库进行了相应的适配。如果SDK升级到此版本之后,需要对依赖的EaseUi库进行更新。** 
-==== 版本 V3.6.7 2020-05-15 ==== +===== 版本 V3.6.7 2020-05-15 ​===== 
 新功能: 新功能:
  
行 51: 行 357:
   * 兼容AndroidQ版本。   * 兼容AndroidQ版本。
  
-==== 版本 V3.6.6 2020-04-09 ====+===== 版本 V3.6.6 2020-04-09 ​=====
 新功能: 新功能:
   * 音视频会议增加踢人api;   * 音视频会议增加踢人api;
行 64: 行 370:
   * 修复连续两次调用unpublish()接口时crash的问题;   * 修复连续两次调用unpublish()接口时crash的问题;
  
-==== 版本 V3.6.5 2020-03-13 ====+===== 版本 V3.6.5 2020-03-13 ​=====
 新功能: 新功能:
   * 支持群组聊天室白名单管理,全员禁言功能;   * 支持群组聊天室白名单管理,全员禁言功能;
行 78: 行 384:
  
 **注意:该版本视频会议会有小程序端无法看到图像的bug,建议有互通需要的尽快升级最新版本。** **注意:该版本视频会议会有小程序端无法看到图像的bug,建议有互通需要的尽快升级最新版本。**
-==== 版本 V3.6.4 2020-02-12 ====+===== 版本 V3.6.4 2020-02-12 ​=====
 新功能: 新功能:
   * 支持设置视频流水印;   * 支持设置视频流水印;
行 88: 行 394:
   * 修复下麦时crash的问题;   * 修复下麦时crash的问题;
  
-==== 版本 V3.6.3 2020-01-03 ====+===== 版本 V3.6.3 2020-01-03 ​=====
 新功能: 新功能:
   * 支持外部输入音频api;   * 支持外部输入音频api;