====== iOS SDK 更新日志 ======

----

===== 版本：V2.3.4 2018-05-11 =====
bug fix：
  - 修复使用 com.apple.springboard.lockcomplete 导致不能通过App Store审核


===== 版本：V2.3.3 2017-09-15 =====
bug fix：
  - 某些情况下，退出登录之后再次登录，发送聊天消息失败；
  - 禁止多次调用登录接口。
===== 版本：V2.3.2 2017-05-16 =====
bug fix：
  - 修复集成第三方推送，绑定devicetoken失败问题
  - 修复rest群组加人偶尔导致的crash问题
  - 修复登录加载好友偶尔导致的crash问题
  - 修复有时进入后台收不到推送问题
===== 版本：V2.3.1 2017-02-17 =====
新功能/改进:
  - 修改HttpsOnly参数默认值,默认设置为NO(由于苹果强制ATS政策延缓, 所以SDK默认关闭httpsOnly)<code objc>[[EaseMob sharedInstance].chatManager setIsUseHttpsOnly:YES];//设置httpsonly,YES开启,NO关闭</code>
  - 增加获取日志压缩文件路径接口(具体上传日志方式可由开发者决定, Demo是通过邮件的形式上报日志)
  - 优化群组过多时重连卡顿问题
  - 修复离线已读回执有时丢失问题
  - 修复SDK收到特殊消息闪退问题
===== 版本：V2.3.0 2016-12-28 =====
新功能/改进:
  - 修复2.2.9升级覆盖2.1.5至2.2.3版本,可能无法登录的bug
  - 增加HttpsOnly参数,允许用户配置,默认设置为YES
  - SDK支持bitcode
===== 版本：V2.2.9 2016-12-06 =====
新功能/改进:
  - SDK满足apple ATS的要求(SDK2.1.5至2.2.3版本覆盖升级时,SDK初始化需要添加参数otherConfig:@{kSDKConfigUseHttps:@YES})
  - 修复接收大量群组邀请阻塞UI问题
  - 修复搜索消息的bug
===== 版本：V2.2.8 2016-11-04 =====
新功能/改进:
  - 红包增加个人间转账功能及拆红包音效
  - 获取聊天室列表支持分批获取
  - 修复消息批量发消息阻塞UI问题
===== 版本：V2.2.7 2016-09-08 =====
SDK细节调整:
  - SDK中检查附件大小，附件大小不恰当时返回错误
  - 群组批量加人时合并了加人请求，避免耗时随着人数增加
  - 改善会话加载消息时的性能
===== 版本：V2.2.6 2016-06-28 =====
红包功能优化和修改:
  - 支持群内的专属红包，只有指定用户才能抢红包；
  - 支持支付宝；
  - 支持系统发的群红包，用户只能看到自己的领取情况；
  - 支持绑定多张银行卡，支持解绑银行卡；
  - 零钱页支持充值；
  - 改版零钱页；
  - 支持上传身份证照片做第三通道验证；
  - 红包UI细节打磨，包括双title和各个页面细节，安卓和iOS文案统一；
  - 错误信息梳理，关键错误基于对话框引导；
  - 服务端性能数倍的提升；
  - 红包数据平台完善统计项；
  - 其他优化：优化代码结构，剥离第三方库减少和开发者库的冲突；透传消息仅给发红包用户而非群内全部用户；优化token获取和更新机制；修复若干bug。
===== 版本：V2.2.5r1 2016-05-20 =====
bug fix：
  - SDK bug：修复创建会话有时crash的问题
===== 版本：V2.2.5 2016-05-18 =====
新功能：
  - SDK支持ipv6
红包新版本:
  - 增加群红包，支持拼手气红包和普通群红包;
  - 优化支付流程，支付更便捷；
  - 优化绑卡流程，绑卡更安全；
  - HTML5的页面基于React重构，主要流程通过原生SDK实现，提升速度和交互体验；
  - 增加了红包历史记录；
  - 提供了红包产品的数据统计，App可登录红包的管理后台查看；
  - 增加了太平洋保险的账户安全险。
bug fix：
  - SDK bug：正常网络下登录、退出偶尔超时问题
===== 版本：V2.2.4 2016-05-07 =====

新功能：

  - 视频通话时支持根据当前网速自动调整码率（默认关闭）。

bug fix：

  - SDK bug：修复收到异常消息crash问题。
  - SDK bug：修复登录相关的问题。

===== 版本：V2.2.3 2016-03-22 =====

新功能:

  - easeui及demo增加阅后即焚及消息撤回(增值功能)功能。
  - 新增发送红包消息功能(体验版)，有需要的请参考压缩包里的红包文档。

bug fix：

  - SDK bug：视频消息重复存储问题。

SDK细节调整:

  - 优化实时通话的弱网监测功能。

===== 版本：V2.2.2 2016-02-02 =====

新功能：

  - 实时通话新增弱网监测、暂停或打开音频视频流等API(相应增加的方法可查看文档)。
  - 实时视频新增录制功能(相应增加的方法可查看文档)。

bug fix：

  - SDK bug：iphone 6s 实时视频挂断crash。
  - SDK bug：优化iphone6s 实时语音外放噪音。
  - SDK bug：使用 SDK 发送高分辨率图片crush bug。
  - SDK bug：附件下载失败，附件下载状态为成功的bug。

SDK细节调整：

  - 提升实时语音音质

===== 版本：V2.2.1r2 2015-12-26 =====

bug fix：

  - SDK bug：内部优化。

===== 版本：V2.2.1 2015-10-28 =====

新功能：

  - 新增一个 UI 库 EaseUI，方便开发者更加快速的集成环信 SDK，新的 Demo 也基于此库开发，旧 Demo 将不再维护。

bug fix：

  - SDK bug：修复离线收不到被踢出群及群解散的通知的bug。

SDK细节调整：

  - 视频通话优化了优化了码率控制，降低码率视频质量不下降。

===== 版本：V2.2.0r1 2015-09-23 =====

bug fix：

  - SDK bug：修复群组有时不能正常解散bug。
  - SDK bug：修复偶尔消息插入数据库失败bug。

===== 版本：V2.2.0 2015-08-17 =====

新功能：

  - Demo 集成 Parse SDK，展示如何获取联系人头像和昵称。

bug fix：

  - SDK bug：修复当离线消息数为0时回调的bug。
  - SDK bug：当群组创建时群组实际人数错误bug。
  - SDK bug：图片发送时按照图片分辨率进行剪裁压缩,保证图片正常显示。
  - SDK bug：修复群组功能有时崩溃的bug。

SDK细节调整:

  - SDK支持iOS9。
  - 图片发送支持按原分辨率发送图片。

===== 版本：V2.1.9 2015-07-10 =====

新功能：

1、环信小助手功能，可自动回复，在demo中有体现。 

bug fix:

1、demo bug：好友删除，对应的会话不被删除。

SDK细节调整：

1、使用 SDK 后，在沙盒中生成的存储数据的文件夹，不同步到iCloud；
2、自动登录流程优化；
3、接收离线消息的回调接口有所调整，具体请参考[[start:300iosclientintegration:200iosreleasedetails:iosv219|2.1.9release note]]。

===== 版本：V2.1.8 2015-06-19 =====

新功能：

1、支持不同网络类型间的实时音视频的互通(wifi/2G/3G/4G，beta版)。 

SDK性能优化:

1、从数据库获取EMMessage速度优化。

SDK细节调整：

1、EMError描述国际化：SDK提供EMError的中文和英文描述，默认为英文描述。 

===== 更早版本 =====

==== 版本：V2.1.7 2015-05-28 ====

bug fix:

1、sdk的bug：登录后，免打扰群组列表获取有延迟；

2、demo的bug：连续播放音频时可能crash；

3、demo的bug：iPhone4上，点击重发按钮，重发按钮不会立刻消失。相应的修改代码在demo的重发操作里。

新功能：

1、聊天室，大家期待已久的聊天室上线了。 

2、将语音的录制和播放相关代码从SDK中开源出来了，SDK不再管理相关代码，请开发者自由定制;

3、请使用EaseMob单实例引用callManager. 在从2.1.7版本开始不会提供EMSDKFull及其头文件. EMSDKFull的功能将整合进EaseMob中;

4、登录操作返回的错误码调整;

5、支持分页获取公开群组。

具体请参考[[start:300iosclientintegration:200iosreleasedetails:iosv217|2.1.7release note]]。

==== 版本：V2.1.6 2015-04-30 ====

性能优化

  - 优化wifi && 非rely环境下的实时语音接通率；
  - 减小实时语音的静态库大小；

新功能：

  - 添加实时视频功能，beta版。需要在demo中添加依赖库libc++.dylib，实时视频不支持后台运行。 
  - 添加接口：离开群时是否自动删除群会话(Default is YES)，该接口的设置不会进行存储，需要开发者每次启动sdk之前设置一下 <code objc> [[EaseMob sharedInstance].chatManager isAutoDeleteConversationWhenLeaveGroup];</code>
  - 接口修改

具体请参考：[[start:300iosclientintegration:200iosreleasedetails:iosv216|2.1.6release note]]

==== 版本：V2.1.5 2015-04-08 ====

bug fix：

1、调用申请加入群组[applyJoinPublicGroup:]相关接口，有时会出现发送申请失败的情况；

2、调用[asyncUpdatePushOptions:]接口时，未赋值的属性会被同步成默认值。

新功能：

1、判断当前socket是否连接。

细节调整：

1、Error列表整理，请使用Error的枚举声明进行判断，不要使用对应的数字编号；

2、EMCallManager文件结构整理。需要监听call相关的回调，请引用协议 EMCallManagerDelegate;

3、登录成功之后，sdk内部不再自动获取群组列表，请自行调用。

具体请参考：[[start:300iosclientintegration:200iosreleasedetails:iosv215|2.1.5release note]]

==== 版本：V2.1.4 2015-03-14 ====

bug fix：

1、会话conversation数量很多的时候，偶尔会出现两条一样的;

2、群名称中包含“（”或者“）”，会造成crash;

3、EMConversation.latestMessage.deliveryState值有时不对.

性能优化：

1、实时语音通话接通概率；

2、从数据库load conversation的速度.

新功能：

1、自定义是否关闭打印的log，不能关闭log写入文件，目前我们需要log文件定位问题，望见谅；

2、添加DNS解析功能.

具体请参考：[[start:300iosclientintegration:200iosreleasedetails:iosv214|2.1.4release note]]

==== 版本：V2.1.3r3 2015-02-04 ====

紧急修复：

1、ios2.1.3版本客户端创建群组，rest无法查到；

==== 版本：V2.1.3r2 2015-02-02 ====

紧急修复：

1、覆盖安装自动登录失效；

2、只引用libEaseMobClientSDKLite.a会调用到libCallServer.a的方法，造成crash；

==== 版本：V2.1.3 2015-01-31 ====

功能改进：

1、优化登录操作；

2、离线消息分为离线cmd消息和离线非cmd消息两种类型；

3、因为Android SDK暂时不支持多body，为了统一，iOS SDK请暂时不要使用多body的EMMessage结构。

Bug Fix：

1、修复：Database的数据存到了Document目录下，迁移到Library目录下；

2、修复：特殊情况下，会出现收到离线消息的时候SDK中的Database还没有open，造成第一条离线消息无法存进去;

新功能：

1、实时语音beta版。目前只支持wifi非relay情况下使用。如果想在黑屏状态或后台下能继续通话，请在工程里选择上"Voice over IP"或者“Audio and AirPlay”。

具体请参考：[[start:300iosclientintegration:200iosreleasedetails:iosv213|2.1.3release note]]

==== 版本：V2.1.2 2014-12-19 ====

功能改进：

1、需要新引入libsqlite3.dylib；

2、在登录成功之后调用[importDataToNewDatabase]将数据导入新的数据库，使用示例：

<code objc>
EMError *error = [[EaseMob sharedInstance].chatManager importDataToNewDatabase]; 
if (!error) { error = [[EaseMob sharedInstance].chatManager loadDataFromDatabase]; }；
</code>

3、检测工程中编译产生的所有error和warning，接口的更改会造成编译的失败或警告。

4、离线消息需要监听[didFinishedReceiveOfflineMessages:]回调方法，不会在[didReceiveMessage:]返回；

5、cmd类型的消息监听[didReceiveCmdMessage:]，不会在[didReceiveMessage:]返回

替换快捷方法：

setp1、将旧的sdk从工程中删除，导入新的sdk；

setp2、编译工程，会出现一系列的warning;

setp3、将error和warning逐个击破，千万不要忽略warning，亲~~。

Bug Fix：

1、修复：附件默认下载状态。

2、修复：设置自动登录，没网情况下启动app，再连网会自动进行重新登录。

具体请参考：[[start:300iosclientintegration:200iosreleasedetails:iosv212|2.1.2release note]]

==== 版本：V2.1.1 2014-11-07 ====

功能改进：

1、发送透传消息（cmd类型），不存入数据库。

Bug Fix：

1、修复：群成员屏蔽群消息之后，无法退出群组。

2、修复：接收到的图片消息，大图的状态默认为undownload（旧版本默认为downloading）。

==== 版本：V2.1.0 2014-10-18 ====

新功能/改进：

1、取消自动获取好友操作，添加是否自动获取好友开关，并添加手动获取好友列表API。

2、透传功能：cmd类型的message。

Bug Fix：

1、修复"自动登录过程中，发送消息直接失败"的bug。

2、修复"断线重连过程中，发送消息直接失败"的bug。

3、修复"APP被kill或者退出登录时，正在发送的消息，未标记为发送失败"的bug。

4、修复"APP被kill或者退出登录时，正在获取的大图 download 状态，未标记为 failed"的bug。

==== 版本：V2.0.9.1 2014-09-23 ====

紧急Bug Fix：

紧急修复wifi 和 3G 切换时，重连失败的bug

==== 版本：V2.0.9 2014-09-20 ====

新功能/改进：

1、屏蔽/取消屏蔽 群消息(服务器不发送消息)。

2、添加消息送达回执。

3、本地缩略图显示模糊。

Bug Fix：

1、消息附件下载状态修复。

==== 版本：V2.0.8 2014-08-28 ====

新功能/改进：

1、EMMessage中新添加了isOfflineMessage属性，在didReceiveMessage的时候，可以根据是否为离线消息而决定是否重绘界面。 同时在offline message在接收过程中，会有willReceiveOfflineMessages和didFinishedReceiveOfflineMessages：发出，用户可以根据此事件决定是否需要重绘UI。

2、屏蔽群消息：接收并提醒 && 只接收不提醒。

Bug Fix：

1、消息中的图片缩略图，在某些情况下，size.height为0。

2、修正断线重连方面：切到后台，3分钟后，切回前台，有时会掉线的问题。

==== 版本：V2.0.7 2014-08-14 ====

新功能/改进：

1、创建群组时，支持传最大成员数 EMGroupStyleSetting.groupMaxUsersCount，3 ~ 2000，iOS默认是200；

2、已创建的群组，获取详情时增加属性：群组实际总人数和群组;

3、添加 获取群组详情相关信息的接口;

4、添加图片压缩比率开关 IChatImageOptions;

5、后台发送纯文字信息（暂不支持发送图片），客户端正常显示。

Bug Fix：

1、创建群组时，invitees中去除创建者自己的username。

性能优化

2、优化聊天记录搜索功能；

3、优化聊天记录获取。

==== 版本：V2.0.6 2014-07-31 ====

新功能/改进：

1、好友黑名单

Bug Fix：

1、修复了 登录后设置消息推送昵称失败

==== 版本：V2.0.5 2014-07-23 ====

新功能/改进：

1、应用后台行为有播放音乐改成 background task 2、改进群组操作，提高易用性和速度

Bug Fix：

1、修复了UI demo 里推送badge number 显示错误

2、修改200个conversation时出现的性能问题

==== 版本：V2.0.4 2014-07-16 ====

新功能/改进：

1、改进视频录制格式为MP4以和anroid 互通

Bug Fix：

1、解决与ShareSDK等三方库的冲突问题

2、解决群组在断网又恢复后出现的一些问题

3、解决后台删除用户在client端没有正确处理的问题

4、解决录音时锁屏的问题

==== 版本：V2.0.3 2014-07-07 ====

新功能/改进：

1、公开群支持用户申请群主批准入群

2、支持群成员邀请其他用户入群

3、64位支持，XCode6 Beta2 适配

Bug Fix：

1、修复Push 通知发送到多个设备的问题

2、修复群组相关bugs

==== 版本：V2.0.2 2014-07-01 ====

新功能/改进：

1、支持发送视频文件

2、支持自动登录

Bug Fix：

1、修复获取公开群相关的bug

2、修复ChatDemo UI 上的重复对话项的bug

==== 版本：V2.0.1 2014-06-25 ====

1、公开群组的支持

2、推送通知的支持

3、SDK里添加自动登录支持

4、bug fix

==== 版本：V2.0.0_GA 2014-06-17 ====

1、群聊功能隆重上线

2、完善errorCode，错误处理更明确

3、bug fixes

==== 版本：V2.0.0_beta6 2014-06-11 ====

1、优化断线重连功能

2、优化音频播放

3、优化消息发送队列和消息发送失败时的检测

4、bug fixes

==== 版本：V2.0.0_beta5 2014-06-09 ====

1、UIDemo增加同一账号在不同手机上登录时踢出旧账号的功能

2、添加"被好友删除"时的回调通知

3、添加"好友请求被接受"时的回调通知

4、bug fixes

==== 版本：V2.0.0_beta4 2014-06-03 ====

1、添加聊天记录分页功能

2、添加音频播放动画

3、添加聊天消息和附件加密功能

4、bug fixes

==== 版本：V2.0.0_beta3 2014-05-16 ====

1、更新帮助文档

2、更新无UIdemo

3、更新有UIdemo

4、bug fixes

==== 版本：V2.0.0_beta2 2014-05-01 ====

1、更新帮助文档

2、更新无UIdemo

3、添加有UIdemo

==== 版本：V2.0.0_beta1 2014-04-25 ====

环信即时通讯云SDK V2.0重装上线。2.0是在1.0版基础上彻底的重写。更简洁易懂的API,更方便集成。

==== 版本：V 1.1.0 2014-01-08 ====

1、环信即时通讯云SDK 1.1.0上线啦。

2、say hello to Huanxin!

----
<WRAP group>
<WRAP half column>
上一页：[[start:300iosclientintegration:120appledoc|Apple Doc]]
</WRAP>

<WRAP half column>
下一章节：[[start:350linuxsdkintegration:10sdkintegration|Linux SDK集成]]
</WRAP>
</WRAP>