====== 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 使用文档地址为：[[im:200androidclientintegration:135easeuiuseguide|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 展示 =====

{{:im:200androidcleintintegration:3.0_cvslist1.png?360|会话}} {{:im:200androidcleintintegration:3.0_ctslist1.png?360|通讯录}} 

{{:im:200androidcleintintegration:3.0_chat1.png?360|聊天窗口}} {{:im:200androidcleintintegration:3.0_group_details1.png?360|群组详情}}

----
<WRAP group>
<WRAP half column>
上一页：[[im:200androidclientintegration:125fcmupgrade|FCM推送升级]]
</WRAP>

<WRAP half column>
下一页：[[im:200androidclientintegration:135easeuiuseguide|EaseUI使用指南]]
</WRAP>
</WRAP>