iOS开源 - LLWeChat：实现IM基本功能，并且在细节、完成度、bugfree上媲美任何主流IM应用
agxw8956
8年前
<h2>LLWeChat 1.0</h2> <p>本README包含18张效果图，约36M大小，载入时间较长，请耐心等待</p> <h2>写在前面</h2> <p>1、我是以极认真的态度来做这个项目，我不想把它做成一个只能展示给人看的Demo，经不起实际使用，只能远观不可亵玩， 那样没什么意思。</p> <p>2、我不想使用假数据， 所以消息通讯使用环信SDK，保证聊天完全真实。同时对环信SDK进行了彻底封装，做到业务代码和环信完全隔离。</p> <p>3、在整个开发过程中，我以媲美微信为目标， 同时参考支付宝、易信、陌陌和钉钉。以万为目标必能过千，这个项目还是有闪光点的。</p> <p>4、整个开发过程就我一人，没有什么Word文档，我的产品文档就是赤裸裸的截屏，到现在为止微信截屏将近300张。</p> <p>你们一定好奇，干吗要截屏这么多，因为微信的细节是做的最到位的，我想这也是微信一家独大的一个成功因素吧 。</p> <p>5、我只专注于聊天模块，其他功能一概而过，点到为至。添加好友是项目完整性需要，消息搜索纯粹就是想换换大脑，做点别的。</p> <p>6、每一个功能，我会把自己的APP和这五款APP在细节、完成度、bugfree这三个方面作对比，直到我满意为止。我说我的APP不比任何商用的差，不是我站在这张嘴胡咧咧，而是我在一个细节一个细节的对比中、完善中得出的：LLWeChat，不逊于任何人。</p> <p>7、这个项目今年07-15开始，原来打算练练手就得了，没想到越做越认真， 做了3个月，国庆后完善了1个月。由于一个人精力实在有限，第一个版本到此结束。</p> <p>8、我IOS是阅读开源项目入的门，这个项目躺在硬盘里也没什么用，凉出来希望对大家有所帮助。</p> <h2>雕琢细节</h2> <p>要想媲美微信，就必须要雕琢细节，在细节上下功夫，做到位。否则细节上马马虎虎，媲美微信就是一句空话。</p> <h3>（一）、消息输入</h3> <p>1、输入面板基本功能</p> <p><img src="https://simg.open-open.com/show/8b5e61752de230b43ca8aafc649d7b5f.png"></p> <p>2、输入框动态调整高度</p> <ul> <li>细节1：当行数增加、减少时，做出动画，而不是一步到位。</li> <li>细节2：除非用户滚动文本，否则文本编辑时不允许出现某一行只漏出一部分。</li> </ul> <p><img src="https://simg.open-open.com/show/1eab51df3a6c3b512743ba3a4680048a.gif"></p> <p>3、草稿</p> <p>当一个会话有草稿时，应该在会话push动画开始时就完成如下工作：</p> <p>读取最新13条消息，解析消息，获取消息缩略图，布局输入框并显示草稿最后一行，弹出键盘（尤其是第三方键盘），布局TableView。</p> <p>当首次进入会话时，如何高效完成这些工作是一个很大的挑战。我花费了许多力气，但还是不太满意。</p> <p><img src="https://simg.open-open.com/show/0f6bec4e63bebe1742cc089b25083d8b.gif"></p> <h3>(二）、GIF</h3> <ul> <li>细节1：内存大小。把GIF转成imageView，内存会暴涨，不可行。只能播一帧获取一帧图片</li> <li>细节2：重用。GIF快速重用时，因为是后台获取帧图片需要处理好同步，还得记住播放进度，以便重用回来的时候继续播放</li> </ul> <p><img src="https://simg.open-open.com/show/3ed3d6c533e5498a9689987c5b670094.png"></p> <h3>（三）、文本</h3> <ul> <li>细节1：文本中包含的链接有三个行为：点击、长按、高亮。高亮要细心处理，否则效果会很糟糕：滚动文本触及了链接不高亮，点击链接必高亮，高亮后依然允许滚动，触发滚动取消高亮等</li> <li>细节2：文本全屏浏览的触发方式（下面有说明），全屏浏览进入退出时的动画。</li> <li>细节3：AppleSDK识别文本中URL不太精确，需要自己提供正则式，暂未实现。</li> </ul> <p>1、文本链接</p> <p><img src="https://simg.open-open.com/show/c03b95ee1182d821c953b2c295a715c5.gif"></p> <h3>（四）、地图</h3> <ul> <li>细节1：地图附近POI搜索，我想根据用户位置、当前时间等做推荐式搜索，暂未实现。</li> <li>细节2：点击地图Cell后要支持侧滑返回，系统默认的NavigationBar交互式返回动画效果不太好，但也可以接受。</li> </ul> <p>1、地图基本功能</p> <p><img src="https://simg.open-open.com/show/deb0b590c585a651e0b2ed3fe9ed8dac.gif"></p> <p>2、地图搜索</p> <p><img src="https://simg.open-open.com/show/e3a6e1cfcce24af60bf96b29c2c1c645.gif"></p> <h3>（五）、ImagePicker</h3> <p>ImagePicker做了PhotoKit和AssetLibrary适配</p> <ul> <li>细节1：整个ImagePicker的核心就是决定一张照片获取方式是同步还是异步，照片质量是fullScreen还是fullResolution；<br> AssetLibrary框架要自己决定， 而PhotoKit框架替你做了一部分。</li> <li>细节2：需要考虑照片或视频已经被用户删除的情况，这时选择、全屏浏览、发送要特殊处理下</li> </ul> <p>1、照片浏览</p> <p><img src="https://simg.open-open.com/show/c2f88d68866379a986df3e70b93fb2f0.gif"></p> <p>2、照片发送</p> <p><img src="https://simg.open-open.com/show/0ea6f940de5ff5b1ae9dcc646b2efab3.gif"></p> <p>3、视频发送</p> <p><img src="https://simg.open-open.com/show/0219185a7c5a4b1c020e29c83026aada.gif"></p> <h3>（六）、照片视频浏览</h3> <ul> <li>细节1：长照片弹出弹入动画，在ImageView做Frame动画的同时，其包含的image也会从当前偏移位置滚动到目标偏移位置。</li> <li>细节2：视频使用AVPlayer播放，而AVPlayer需要占用主线程，使得快速浏览时明显卡顿，我的解决方法就是用视频第一帧图片代替视频滚动，滚动结束时关联AVPlayer和VideoURL，当用户点击播放按钮或拖动进度条时把图片换成真正的视频。</li> <li>细节3：适应屏幕旋转。特别当用户在设备水平朝向时，点击返回。需要先把照片视频旋转到竖立方向，然后再做弹出动画。</li> <li>细节4：照片视频浏览时的bottomBar的切换，照片视频下载状态的更新，这块规则很多很杂，不列举了</li> </ul> <p>1、照片视频弹入弹出动画</p> <p><img src="https://simg.open-open.com/show/694259ecbe3f90c8b40c8d02260ad419.gif"></p> <p>2、视频下载</p> <p><img src="https://simg.open-open.com/show/e5a876a7f31e274140ee340403c86131.gif"></p> <h3>（七）、语音</h3> <ul> <li>细节1：按压录音按钮小于0.25秒， 弹录音太短Tip，大于则变按钮title为“松开 结束”同时录音开始；小于1.25秒，弹录音太短Tip；大于1.25秒出现录音动画，此时录音时长刚好1秒。51秒时弹倒计时，60秒时强制结束录音并取消录音按钮按压事件。</li> <li>细节2：录音时APP进入后台，则结束并发送录音。再返回APP时，录音按钮第一次点击无效，不清楚原因，暂未解决。</li> <li>细节3：播放录音有：音量太低Tip，播放模式切换，未读声音联播等</li> </ul> <p>1、语音录制</p> <p><img src="https://simg.open-open.com/show/c2ef00375f0b9e2651c53d3e709847a3.png"></p> <p>2、录音最大时长</p> <p><img src="https://simg.open-open.com/show/d9da572dced6c193efaf90b1d524989e.gif"></p> <h3>（八）、缓存</h3> <p>1、MessageCell缓存</p> <ul> <li>GIF、日期消息只重用，不缓存</li> <li>整个APP默认缓存MessageCell 1300条 ，超出的消息采用TableView重用机制</li> <li>退出当前会话后，保留会话最近MessageCell 130条</li> <li>自定义数值，可在 LLMessageCellManager 中更改</li> </ul> <p>2、照片、视频缩略图</p> <ul> <li>本项目没有采用环信SDK提供的缩略图，而是APP负责缩略图的创建、存储、删除</li> <li>照片、视频MessageCell不可见时就清空缩略图，可见时再读取缩略图</li> <li>为了加快缩略图读取，内存中默认缓存缩略图上限 80M</li> <li>APP运行时会把一段时间内未读取过的缩略图从硬盘上删除</li> <li>自定义数值可在 LLMessageThumbnailManager 中更改</li> </ul> <h3>（九）、其他</h3> <p>其他界面只实现了最简单的功能</p> <p>1、批量删除</p> <ul> <li> <p>细节1：弹出的ActionSheet在键盘之上</p> <img src="https://simg.open-open.com/show/65402417358c500623bae4a24b29e28e.gif"></li> </ul> <p>2、添加好友</p> <p><img src="https://simg.open-open.com/show/550e58c1bf58ce5303e159031ec65a91.gif"></p> <p>3、消息搜索</p> <p><img src="https://simg.open-open.com/show/d18461b2664264585e94c3e8e9c91ebc.gif"></p> <p>4、新消息通知</p> <p><img src="https://simg.open-open.com/show/ae5725c0efcd97d3257356caa956cffb.gif"></p> <h2>项目基本信息</h2> <ul> <li>开发语言：Objective-C</li> <li>最低部署版本：IOS8.0</li> <li>支持IOS版本：IOS8、IOS9、IOS10</li> <li>手机适配：iPhone6 plus最好，iPhone6次之。其他机型没有兼顾到</li> </ul> <h2>第三方库</h2> <ul> <li>环信SDK（ 71M ），已包含在项目中</li> <li>高德SDK（ 15.6M ），已包含在项目中</li> <li>MBProgressHUD，已包含在项目中</li> <li>Github下载项目Zip包大小： 40M</li> </ul> <h2>项目安装</h2> <p>1、切换到 Podfile 文件所在目录，运行 pod install （当前版本Podfile内容为空）</p> <p>2、使用高德地图，请到 <a href="/misc/goto?guid=4959647523800656212" rel="nofollow,noindex">高德官网注册APP Key</a> ，然后替换掉 LLGDConfig.h 头文件中APPKey即可。</p> <p>注册步骤为：注册成为开发者->点击右上角控制台->我的应用->创建新应用</p> <p>3、运行 LLWeChat.xcworkspace</p> <h2>项目目录</h2> <table> <thead> <tr> <th>目录</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>General</td> <td>该目录包含和项目耦合性最低的通用模块，包括声音管理器、照片选取器、通用UI、Utilities等</td> </tr> <tr> <td>Server</td> <td>该目录封装环信SDK，环信SDK一共封装成四个类：<br> 1、LLClientManager：管理用户的注册、登陆、登出等<br> 2、LLChatManager：管理会话消息的收发、本地消息的加载更新等<br> 3、LLContactManager： 管理好友列表<br> 4、LLSDKError：环信SDK错误码的封装</td> </tr> <tr> <td>Data</td> <td>数据目录，包括Config、Cache、Model等</td> </tr> <tr> <td>Client</td> <td>该目录是项目的主体，按照业务功能分类，分为会话、聊天、搜索、通讯录、设置等</td> </tr> </tbody> </table> <p>Server、Data可以直接访问SDK，Client代码不允许直接访问环信SDK，要把环信SDK和Client完全隔离开</p> <h2>产品设计</h2> <p>产品设计上的一些想法，汇总在产品设计</p> <h2>下个版本</h2> <p>下个版本实现如下功能：</p> <p>1、小视频</p> <p>2、语音、视频通话</p> <p>3、消息搜索、上拉刷新</p> <p>4、群聊</p> <p>5、通讯录</p> <h2>更新日志：2016-11-24</h2> <p>1、删除stable分支，只保留master、develop两个分支，越简单越好。</p> <p>2、适配IOS10，原项目在IOS10运行会直接奔溃。</p> <h2>Licenses</h2> <p>本项目所有LL-开头的源码遵守MIT license. 本项目绝大部分资源归腾讯公司所有</p> <p> </p> <p> </p>