网易云信在 Github 上提供开源的 IM Demo 源码。您可参考 Demo 源码，在您的本地项目中快速构建即时通讯应用。

本文介绍如何快速跑通 Demo 源码。

主要模块

前提条件

在开始运行示例项目之前，请确保您已：

• 在云信控制台完成以下操作。

  
  
  创建应用并获取 App Key 和 App Secret

  1. 在左侧导航栏中找到“应用”，并单击“创建”。
  
  2. 填写应用的基本信息后，单击“创建”。
  
  3. 创建应用后，可以在左侧导航栏中查看该应用，并单击 “App Key 管理”，并获取 App Key 和 App Secret。
  
  注册云信 IM 账号，获取 accid 和 token

  注册云信 IM 账号，获取 accid 和 token。accid 和 token 将用于登录云信服务端。

  1. 在左侧导航栏中单击指定应用名称，进入该应用的详情页面。
  2. 在“功能管理”中单击“账号管理”。
  
  3. 在测试页面，单击“新建账号”，并填写账号（即accid）、昵称（即 name）、密码（即 Token）后，单击“确定”。
  

• 准备如下开发环境:

  环境要求	说明
  JDK 版本	1.8.0 及以上版本
  Android API 版本	API 21、Android 5.0 及以上版本
  CPU架构	ARM 64、ARM V7
  IDE	Android Studio 4.0及以上
  其他	依赖 Androidx，不支持 support 库。请使用 Android 系统 5.0 或以上版本的移动设备。

跑通流程

1. 前往 GitHub 下载 Demo 源码。

   示例项目结构如下：

   目录	说明
   app	应用主入口，包含外部界面框架
   chatkit-ui	聊天功能界面相关代码
   contactkit-ui	通讯录功能界面相关代码
   conversationkit-ui	会话功能界面相关代码
   searchkit-ui	搜索功能界面相关代码
   teamkit-ui	群组功能界面相关代码

2. 将示例项目导入 Android Studio。

3. 在 Android Studio 里找到工程目录 app/src/main/AndroidManifest.xml 文件，将文件里如下代码中的your app key替换成您的 App Key。

   <meta-data
           android:name="com.netease.nim.appKey"
           android:value="your app key" />
   
   

4. 在 Android Studio 里找到工程目录 app/src/main/java/com.netease.yunxin.app.im.welcome.WelcomeActivity.java 文件，将文件里找到方法startLogin设置云信 IM 账号和 Token。

   private void startLogin() {
           //将您的云信IM账号(accid)和Token设置在这里即可
           String account = "";
           String token = "";
           .....
   }
   

5. 将源码运行在您的 Android 设备上，即可进入如下界面，开始体验 IM Demo。