====== Demo（EaseIM App）介绍 ======
更新日期：2022-07-08
-------
环信即时通讯 iOS 端提供示例应用可供体验。为方便体验，建议使用你自己的 Demo 应用，具体步骤如下：
1. 在 [[https://console.easemob.com/user/login|环信即时通讯云 IM 管理后台]] 通过邮箱注册， 可以看到默认的 Demo 应用（默认应用是全功能开通的应用）；
{{:ccim:android:quickstart:2.png?800|}}
2. 在上图页面 Demo 应用右侧点击 **查看**，选择 **开放注册**；
{{:ccim:android:quickstart:3.png?600|}}
3. 下载 Demo，点击 **服务器配置**；
{{:ccim:android:quickstart:androiddemo1.jpg?300|}}
4. 将 Demo 的 App Key 填入，点击 **保存配置**；
{{:ccim:ios:iosdemo2.jpeg?300|}}
5. 杀死 app；
6. 重启，然后点击 **注册用户** 进行体验。
**注意**
注册模式分两种，开放注册和授权注册。只有开放注册时，才可以客户端注册。
* 开放注册是为了测试使用，正式环境中不推荐使用该方式注册环信账号；
* 授权注册的流程应该是你的应用服务器通过环信提供的 REST API 注册，之后保存到你的应用服务器或返回给客户端。
===== 代码下载 =====
您可以通过以下两种方式获取到源代码：
* 下载代码压缩包：[[https://www.easemob.com/download/im|IM SDK 及 Demo 下载]]
* 下载源代码：[[https://github.com/easemob/chat-ios|github 源码地址]]
欢迎大家提交 PR 改进和修复 EaseIM 和 EaseIMKit 中的问题。
===== 运行 EaseIM 工程 =====
从[[https://www.easemob.com/download/im|IM SDK 及 Demo 下载]] 下载 iOS SDK 压缩包，然后解压。解压后在 EaseIM 文件夹下，即为 EaseIM 的工程目录。
终端 cd 到 EaseIM 的 podfile 目录下，终端执行 pod install 命令，等待下载完所有的 pod 依赖库，即可打开 EaseIM.xcworkspace，运行 EaseIM demo 进行自定义再次开发。
===== 使用到的 pod 库 =====
* 环信 SDK pod 'HyphenateChat', '3.8.0'
* 环信 IM UI 库 pod 'EaseIMKit', '3.8.0.1'
* 环信音视频 UI 库 pod 'EaseCallKit', '3.8.0.3'
* 声网音视频 SDK pod 'AgoraRtcEngine_iOS', '3.3.1'
三方库包含
* pod 'MBProgressHUD',
* pod 'Masonry'
* pod 'MJRefresh'
* pod 'SDWebImage'
===== 主要模块介绍 =====
demo 中有几大 UI 功能模块，在集成时将对应的模块添加到工程中即可。
* Helper------自定义库和页面，第三方库，全局通用模块
* Chat------聊天模块
* Conversation------会话列表模块
* Communicate------实时音视频模块（包含 1v1 实时通话以及多人实时通话的功能
* Contact------好友列表模块
* Group------群组模块
* Chatroom------聊天室模块
在集成时，必须要先向自己的工程中导入 ''Helper'' 模块，然后再根据自己的需求导入其他模块。
===== 主要类介绍 =====
* **EaseIMHelper**：环信（EaseIM）全局帮助类，demo 的单例类，主要是全局监听接收消息，好友，群组，聊天室等相关事件的回调，从而进行对应的处理；
* **EMConversationsViewController**：demo 的会话列表功能页面，展示了扩展条目侧滑事件及条目点击事件实现等；
* **EMChatViewController**：demo 的聊天功能页面，展示了扩展条目长按事件，预置条目长按菜单及对重写部分长按事件功能，展示了如何重置及添加更多扩展功能，并展示了实现了头像点击事件及正在输入等事件的相应；
* **EMContactsViewController**：demo 展示的联系人页面，展示了添加条目长按侧滑及实现条目点击事件等；
* **EMGroupInfoViewController**：实现了如下功能：添加群成员，修改群公告及群介绍，上传共享文件，进行群组管理，设置消息免打扰及解散或者退出群组等。
===== 部分 UI 展示 =====
{{:im:android:other:easeim通讯录.jpg?300|联系人列表}}
{{:im:android:other:easeim聊天.jpg?300|聊天页面}}