集成 iOS SDK - IM 即时通讯

更新时间： 2026/02/06 16:24:40

网易云信即时通讯（NetEase IM）SDK V10（以下简称 NIM SDK）融合了 V9 接口，本文介绍如何快速将 NIM SDK 集成到您的 iOS 项目中。

本文主要介绍底层 iOS SDK 的集成，若您需要集成对应的 UI 组件，请参考集成 iOS UIKit。

开发环境

开发环境要求需满足 iOS 9.0 及以上版本，可使用 iPhone/iPad 真机或模拟器。

单击展开查看如何新建项目，若需集成到已有项目，可忽略此步骤。

在 Podfile 文件中添加对应的资源。

CocoaPods 集成资源关键词说明：

关键词	所含资源
NIMSDK_LITE	IM 即时通讯，默认使用网易对象存储（NetEase Object Storage，NOS）文件存储能力。
NIMSDK_LITE/NOS	IM 即时通讯，引入网易对象存储（NetEase Object Storage，NOS）文件存储能力。
NIMSDK_LITE/FCS	IM 即时通讯，引入 S3 文件存储能力。
NIMSDK_LITE/FTS	本地检索库，若需要使用本地检索功能，需要提前引入。
NIMSDK_LITE/QChat	IM 即时通讯的圈组能力，若需要使用圈组功能，需要提前引入。

若需要使用 IM UIKit，请参考集成 IM UIKit。

现以只需要集成即时通讯功能（NOS）为例，您可在 Podfile 中写入：

CocoaPodspod 'NIMSDK_LITE'
//若需要使用本地检索功能，单独引入 FTS
//pod 'NIMSDK_LITE/FTS'

执行以下命令更新本地仓库，查看版本信息。最新版本信息请参考更新日志。

CocoaPodspod search NIMSDK_LITE   //本地仓库中查询资源的版本信息
pod repo update          //更新本地仓库

前往资源下载获取 SDK。

国内服务（NOS）

海外服务（FCS）

Framework	是否必选	说明
NIMSDK	是	IM 即时通讯基础功能。
NIMNOS	是	NOS 文件存储能力。
NIMAWSCore	是	S3 文件存储能力，NIMAWSCore 和 NIMAWSS3 必须同时引入。
NIMAWSS3	是	S3 文件存储能力，NIMAWSCore 和 NIMAWSS3 必须同时引入。
NIMSocketRocket	否	WebSocket 能力，用于提升联通性。
NIMQUIC	否	QUIC 能力，用于提升联通性。
NIMQChat	否	IM 即时通讯的圈组能力，可自主选择集成。
NIMDBEx	否	本地检索库，用于使用本地检索功能，可自主选择集成。

针对海外服务的文件存储 NIMFCS（历史的 S3 文件存储能力）由于体积过大，现以使用 NIMAWSCore&NIMAWSS3 替换。若您之前引入了 NIMFCS，请及时替换。
NIMNOS 和 NIMFCS 无法同时使用。

将解压得到的 framework 文件拷贝到工程项目文件夹下。
选择 TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content 菜单，添加对应的 framework 文件，并将 Embed 属性设置为 Embed & Sign，以使得 SDK 动态库和应用签名保持一致。至此，SDK 导入完成。

完成 SDK 集成后，您需要初始化 SDK。

此外，您可在 API 概览了解 API 的调用方式。

此文档是否对你有帮助？

有帮助

去反馈