Demo 介绍
代码下载
通过 http://www.easemob.com/download/im 下载代码压缩包。
导入 Demo
从 http://www.easemob.com/download/im 下载 Android SDK 压缩包,然后解压。解压后在 examples 文件夹下,会存在以下几个目录:
- ChatDemoUI3.0 – Demo,依赖 EaseUI 库及redpacketlibrary(红包功能库,在ChatDemoUI3.0根目录下)
- easeui – UIkit,包含常用的控件及 fragment 等,EaseUI 使用文档地址为:EaseUI使用指南
导入到 Eclipse
点击 File→Import→点击 Android 下的子目录→Next→选择输入 ChatDemoUI3.0 的根路径→Finish。
使用同样的方法导入 EaseUI。
注意:Demo 中使用了百度地图及友盟,在开发你自己的应用时,请在 AndroidManifest.xml 中把相应的 key 改成你自己申请的。
导入到 Android Studio
ChatDemoUI3.0 同时支持 Android Studio 导入。打开 Android Studio,点击 File→Open,打开 ChatDemoUI3.0 根目录即可,这里不再多赘述。
项目结构
- com.hyphenate.chatuidemo – 根目录,放置了几个全局管理类,如 DemoApplication、DemoHelper 等
- com.hyphenate.chatuidemo.adapter – adapter 包
- com.hyphenate.chatuidemo.db – 放置数据库相关操作的类
- com.hyphenate.chatuidemo.domain – 实体类包
- com.hyphenate.chatuidemo.parse – 第三方库 parse(用于存储 Demo 中用户的信息)管理包
- com.hyphenate.chatuidemo.receiver – 广播接收者包
- com.hyphenate.chatuidemo.task – 放置一些异步任务类
- com.hyphenate.chatuidemo.ui – 放置 activity、fragment 等 UI 类
- com.hyphenate.chatuidemo.utils – 工具包
- com.hyphenate.chatuidemo.video.util – 录制视频的工具包
- com.hyphenate.chatuidemo.widget – 自定义控件包
主要类介绍
- DemoApplication:继承于系统的 Application 类,其 onCreate() 为整个程序的入口,相关的初始化操作都在这里面;
- DemoHelper: Demo 全局帮助类,主要功能为初始化 EaseUI、环信 SDK 及 Demo 相关的实例,以及封装一些全局使用的方法;
- MainActivity: 主页面,包含会话列表页面(ConversationListFragment)、联系人列表页(ContactListFragment)、设置页面(SettingsFragment),前两个继承自己 EaseUI 中的 fragment;
- ChatActivity: 会话页面,这个类代码很少,主要原因是大部分逻辑写在 ChatFragment 中。ChatFragment 继承自 EaseChatFragment,做成 fragment 的好处在于用起来更灵活,可以单独作为一个页面使用,也可以和其他 fragment 一起放到一个 Activity 中;
- GroupDetailsActivity: 群组详情页面。