{"id":13696166,"url":"https://github.com/netease-kit/nim-uikit-ios","last_synced_at":"2026-03-12T05:02:18.186Z","repository":{"id":38816493,"uuid":"41851334","full_name":"netease-kit/nim-uikit-ios","owner":"netease-kit","description":"云信 IM UIKit 是基于 NIM SDK（网易云信 IM SDK）开发的一款即时通讯 UI 组件库，包括聊天、会话、圈组、搜索、群管理等组件。通过 IM UIKit，可快速集成包含 UI 界面的即时通讯应用。","archived":false,"fork":false,"pushed_at":"2025-05-06T05:55:15.000Z","size":232898,"stargazers_count":1517,"open_issues_count":0,"forks_count":416,"subscribers_count":47,"default_branch":"master","last_synced_at":"2025-05-06T06:46:09.201Z","etag":null,"topics":["im","ios","uikit"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"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":null,"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-03T09:17:46.000Z","updated_at":"2025-04-28T03:01:04.000Z","dependencies_parsed_at":"2023-07-13T10:23:21.791Z","dependency_job_id":"f1088907-c075-4e52-a14f-ac12d140f551","html_url":"https://github.com/netease-kit/nim-uikit-ios","commit_stats":{"total_commits":532,"total_committers":31,"mean_commits":"17.161290322580644","dds":0.5770676691729324,"last_synced_commit":"956ee53405287f0c21994ed6605f0366e305b493"},"previous_names":["netease-im/nim_ios_uikit","netease-kit/nim_ios_uikit"],"tags_count":137,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-ios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-ios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-ios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netease-kit%2Fnim-uikit-ios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netease-kit","download_url":"https://codeload.github.com/netease-kit/nim-uikit-ios/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254101557,"owners_count":22014908,"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":["im","ios","uikit"],"created_at":"2024-08-02T18:00:36.840Z","updated_at":"2025-12-12T06:02:07.499Z","avatar_url":"https://github.com/netease-kit.png","language":"Swift","funding_links":[],"categories":["UI Frameworks","Swift"],"sub_categories":[],"readme":"\u003cdiv align=\"vertical-center\"\u003e\r\n  \u003ca href=\"https://deepwiki.com/netease-kit/nim-uikit-ios/1-overview\"\u003e\r\n    \u003cimg src=\"https://devin.ai/assets/deepwiki-badge.png\" alt=\"Ask the Deepwiki\" height=\"20\"/\u003e\r\n  \u003c/a\u003e\r\n  \u003cp\u003e单击跳转查看 \u003ca href=\"https://deepwiki.com/netease-kit/nim-uikit-ios/1-overview\"\u003eDeepWiki\u003c/a\u003e 源码解读。\u003c/p\u003e\r\n\u003c/div\u003e\r\n\r\n-------------------------------\r\n\r\n网易云信即时通讯界面组件（简称 IM UIKit）是基于 [NIM SDK（网易云信 IM SDK）](https://doc.yunxin.163.com/messaging2/concept/DI0Nzc2NzA?platform=client) 开发的一款即时通讯 UI 组件库，包括聊天、会话、圈组、搜索、通讯录、群管理等组件。通过 IM UIKit，您可快速集成包含 UI 界面的即时通讯应用。\r\n\r\n## 适用客群\r\n\r\nIM UIKit 简化了基于 NIM SDK 的应用开发过程，适合需要快速集成和定制即时通讯功能的开发者和企业客户。它不仅能助您快速实现 UI 功能，也支持调用 NIM SDK 相应的接口实现即时通讯业务逻辑和数据处理。因此，您在使用 IM UIKit 时仅需关注自身业务或个性化扩展。\r\n\r\n\u003cimg alt=\"image.png\" src=\"https://yx-web-nosdn.netease.im/common/ca3caa267f692e518d391f07e805aac9/image.png\" style=\"width:65%;border: 0px solid #BFBFBF;\"\u003e\r\n\r\n## 主要功能\r\n\r\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)。\r\n\r\n\u003cimg alt=\"image.png\" src=\"https://yx-web-nosdn.netease.im/common/2deec52ef5a09b7f279844945613e8cc/image.png\" style=\"width:65%;border: 0px solid #BFBFBF;\"\u003e\r\n\r\n## 功能优势\r\n\r\n### 组件解耦\r\n\r\nIM UIKit 不同组件可相互独立运行使用。您可按需选择组件，将其快速集成到您的应用，实现相应的 UI 功能，减少无用依赖。\r\n\r\n### 简洁易用\r\n\r\nIM UIKit 的业务逻辑层与 UI 层相互独立。在 UI 层，您仅需关注视图展示和事件处理。IM UIKit 清晰的数据流转处理，让 UI 层代码更简洁易懂。\r\n\r\n### 自定义能力\r\n\r\nIM UIKit 支持在各 UI 组件的初始化过程中配置自定义 UI。同时提供 Controller 和 View 的能力封装，助您快速将 UI 功能添加到您的应用中。\r\n\r\n### 业务逻辑处理\r\n\r\nIM UIKit 业务逻辑层提供完善的业务逻辑处理能力。您无需关心 SDK 层不同接口间的复杂处理逻辑，业务逻辑层一个接口帮您搞定所有。\r\n\r\n## 工作原理\r\n\r\nIM UIKit 采用 （Model–View–ViewModel）MVVM 架构模型，实现 UI 展示与业务逻辑开发的相互独立。\r\n\r\n\u003cimg alt=\"IMuikitDataFlow_iOS.png\" src=\"https://yx-web-nosdn.netease.im/common/4526057a8ef3f59f6c65c56c42991de9/IMuikitDataFlow_iOS.png\" style=\"width:60%;border: 1px solid #BFBFBF;\"\u003e\r\n\r\n流程 | 说明\r\n---- | ----\r\n1 | IM UIKit 展示层的 UIViewController/View 向响应层的 ViewModel 发送请求。\r\n2 | ViewModel 将请求经由业务逻辑层转发至 NIM SDK（网易云信 IM SDK）。\r\n3 | NIM SDK 接收请求后触发回调，回调数据经由业务逻辑层和响应层发送至 UIViewController/View。\r\n4 | UIViewController/View 将回调数据发送至 UITableViewDelegate 和 UItableViewDataSource。后两者根据需在界面上展示的不同实体的 identifier，判定具体的 UI 样式。例如，SDK 返回的回调数据为消息数据时，UITableViewDelegate 和 UItableViewDataSource 可通过消息数据中包含的代表消息类型的 Identifier，将消息在 UI 上展示为对应类型的样式。\r\n\r\n## 组件架构\r\n\r\n\u003cimg alt=\"app_structure_iOS.png\" src=\"https://yx-web-nosdn.netease.im/common/455980c6d4cdf15bff3cd9e4666d84d4/app_structure_iOS.png\" style=\"width:60%;border: 1px solid #BFBFBF;\"\u003e\r\n\r\n上图中：\r\n\r\n- UIKit UI 层的 `NEContactUIKit`、`NEChatUIKit`、`NEConversationUIKit` 和 `NETeamUIKit`，对应上述工作原理图中的 UIViewController/View。\r\n- UIKit UI 层的 `NEChatKit`，对应上述工作原理图中的 Repository。\r\n- NECoreKit 层对应上述工作原理图中的 Provider。\r\n\r\n## 相关文档\r\n\r\n- IM UIKit 的功能清单，请参考 [IM UIKit 功能概览](https://doc.yunxin.163.com/messaging-uikit/concept/zMzMDQ2MTg)。\r\n- IM UIKit 的集成流程，请参考 [集成开发文档](https://doc.yunxin.163.com/messaging-uikit/guide/DU4NzAzNzQ?platform=android)。\r\n- IM UIKit 已支持音视频通话，具体实现流程请参考 [实现音视频通话功能](https://doc.yunxin.163.com/messaging-uikit/guide/zIzMTgxNDk?platform=iOS)。\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetease-kit%2Fnim-uikit-ios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetease-kit%2Fnim-uikit-ios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetease-kit%2Fnim-uikit-ios/lists"}