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: 群组详情页面。

部分 UI 展示

会话 通讯录

聊天窗口 群组详情


上一页:GCM、华为推送

下一页:EaseUI使用指南