{"id":19481493,"url":"https://github.com/netease-kit/nim-uikit-android","last_synced_at":"2026-05-07T04:03:02.116Z","repository":{"id":37643576,"uuid":"41782426","full_name":"netease-kit/nim-uikit-android","owner":"netease-kit","description":"云信 IM UIKit 是基于 NIM SDK（网易云信 IM SDK）开发的一款即时通讯 UI 组件库，包括聊天、会话、圈组、搜索、群管理等组件。通过 IM UIKit，可快速集成包含 UI 界面的即时通讯应用。","archived":false,"fork":false,"pushed_at":"2025-05-06T06:02:30.000Z","size":79778,"stargazers_count":721,"open_issues_count":0,"forks_count":137,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-05-06T07:25:47.461Z","etag":null,"topics":["android","im","uikit"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netease-kit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-09-02T05:46:42.000Z","updated_at":"2025-05-06T06:01:23.000Z","dependencies_parsed_at":"2023-09-22T23:14:17.586Z","dependency_job_id":"ccbbcdd0-07a2-49c9-b3c0-cd1e8acf7c95","html_url":"https://github.com/netease-kit/nim-uikit-android","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netease-kit","download_url":"https://codeload.github.com/netease-kit/nim-uikit-android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254270643,"owners_count":22042859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","im","uikit"],"created_at":"2024-11-10T20:05:04.999Z","updated_at":"2026-05-07T04:03:02.111Z","avatar_url":"https://github.com/netease-kit.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"vertical-center\"\u003e\n  \u003ca href=\"https://deepwiki.com/netease-kit/nim-uikit-android/1-overview\"\u003e\n    \u003cimg src=\"https://devin.ai/assets/deepwiki-badge.png\" alt=\"Ask the Deepwiki\" height=\"20\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n  \u003cspan\u003e单击跳转查看 \u003ca href=\"https://deepwiki.com/netease-kit/nim-uikit-android/1-overview\"\u003eDeepWiki\u003c/a\u003e 源码解读。\u003c/span\u003e\n\u003c/div\u003e\n\n\n-------------------------------\n\n网易云信即时通讯界面组件（简称 IM UIKit）是基于 [NIM SDK（网易云信 IM SDK）](https://doc.yunxin.163.com/messaging2/concept/DI0Nzc2NzA?platform=client) 开发的一款即时通讯 UI 组件库，包括聊天、会话、圈组、搜索、通讯录、群管理等组件。通过 IM UIKit，您可快速集成包含 UI 界面的即时通讯应用。\n\n## 适用客群\n\nIM UIKit 简化了基于 NIM SDK 的应用开发过程，适合需要快速集成和定制即时通讯功能的开发者和企业客户。它不仅能助您快速实现 UI 功能，也支持调用 NIM SDK 相应的接口实现即时通讯业务逻辑和数据处理。因此，您在使用 IM UIKit 时仅需关注自身业务或个性化扩展。\n\n\u003cimg alt=\"image.png\" src=\"https://yx-web-nosdn.netease.im/common/ca3caa267f692e518d391f07e805aac9/image.png\" style=\"width:65%;border: 0px solid #BFBFBF;\"\u003e\n\n## 主要功能\n\nIM UIKit 主要分为会话、群组、联系人等几个 UI 子组件，每个 UI 组件负责展示不同的内容。更多详情，请参考 [功能概览](https://doc.yunxin.163.com/messaging-uikit/concept/zMzMDQ2MTg?platform=client) 和 [UI 组件介绍](https://doc.yunxin.163.com/messaging-uikit/concept/TI3NTgyNDA?platform=client)。\n\n\u003cimg alt=\"image.png\" src=\"https://yx-web-nosdn.netease.im/common/2deec52ef5a09b7f279844945613e8cc/image.png\" style=\"width:65%;border: 0px solid #BFBFBF;\"\u003e\n\n## 功能优势\n\n### 组件解耦\n\nIM UIKit 不同组件可相互独立运行使用。您可按需选择组件，将其快速集成到您的应用，实现相应的 UI 功能，减少无用依赖。\n\n### 简洁易用\n\nIM UIKit 的业务逻辑层与 UI 层相互独立。在 UI 层，您仅需关注视图展示和事件处理。IM UIKit 清晰的数据流转处理，让 UI 层代码更简洁易懂。\n\n### 自定义能力\n\nIM UIKit 支持在各 UI 组件的初始化过程中配置自定义 UI。同时提供 Fragment（安卓）、Controller（iOS）、Widget（Flutter）和 View 的能力封装，助您快速将 UI 功能添加到您的应用中。\n\n### 业务逻辑处理\n\nIM UIKit 业务逻辑层提供完善的业务逻辑处理能力。您无需关心 SDK 层不同接口间的复杂处理逻辑，业务逻辑层一个接口帮您搞定所有。\n\n## 工作原理\n\nIM UIKit 采用 （Model–View–ViewModel）MVVM 架构模型，实现 UI 展示与业务逻辑开发的相互独立。\n\n\u003cimg alt=\"IMuikitDataFlow_Android.png\" src=\"https://yx-web-nosdn.netease.im/common/f1663a580335822a9770e486c3ea3e12/IMuikitDataFlow_Android.png\" style=\"width:60%;border: 1px solid #BFBFBF;\"\u003e\n\n流程 | 说明\n---- | ----\n1 | IM UIKit 展示层的 Activity/Fragment/View 向响应层的 ViewModel 发送请求。\n2 | ViewModel 将请求经由业务逻辑层转发至 NIM SDK（网易云信 IM SDK）。\n3 | NIM SDK 接收请求后触发回调，回调数据经由业务逻辑层和响应层发送至 Activity/Fragment/View。\n4 | Activity/Fragment/View 将回调数据发送至 RecyclerViewAdapter。后者根据界面需要展示的不同实体的 type，判定具体的 UI 样式。例如，SDK 返回的回调数据为消息数据时，RecyclerViewAdapter 可判定消息数据中包含的消息类型（即 type），将消息在 UI 上展示为对应类型的样式。\n\n## 组件架构\n\n\u003cimg alt=\"app_structure_android.png\" src=\"https://yx-web-nosdn.netease.im/common/21f411d4284f050973bb2549c43e4f62/app_structure_android.png\" style=\"width:60%;border: 1px solid #BFBFBF;\"\u003e\n\n上图中：\n\n- UIKit 层的 `ContactKit-ui`、`ChatKit-ui`、`ConversationKit-ui` 和 `TeamKit-ui`，对应上述工作原理图中的 Activity/Fragment/View。\n- UIKit 层的 `ChatKit`，对应上述工作原理图中的 Repository。\n- CoreKit 层对应上述工作原理图中的 Provider。\n\n## 相关文档\n\n- IM UIKit 的功能清单，请参考 [IM UIKit 功能概览](https://doc.yunxin.163.com/messaging-uikit/concept/zMzMDQ2MTg)。\n- 若需要直接体验 IM Demo，请参考 [体验 Demo](https://doc.yunxin.163.com/messaging-uikit/guide/Dg4MTg2MTM?platform=android)。\n- 若需要跑通 IM Demo，请参考 [跑通 IM Demo 源码](https://doc.yunxin.163.com/messaging-uikit/guide/zk0MjE5Mjk?platform=android)。\n- IM UIKit 的集成流程，请参考 [集成开发文档](https://doc.yunxin.163.com/messaging-uikit/guide/DU4NzAzNzQ?platform=android)。\n- IM UIKit 已支持音视频通话，具体实现流程请参考 [实现音视频通话功能](https://doc.yunxin.163.com/messaging-uikit/guide/jgxOTUyMjQ?platform=android)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetease-kit%2Fnim-uikit-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetease-kit%2Fnim-uikit-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetease-kit%2Fnim-uikit-android/lists"}