集成 iOS SDK - IM 即时通讯

更新时间： 2025/07/15 17:03:29

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

开发环境

开发环境要求需满足 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。

Framework	说明
NIMSDK	IM 即时通讯基础功能。
NIMNOS	NOS 文件存储能力，需要与 NIMSDK 一起使用（不能与 NIMFCS&NIMFtsDB 一起使用）。
NIMFCS	S3 文件存储能力，需要与 NIMSDK 一起使用（不能与 NIMNOS&NIMFtsDB 一起使用）。
NIMFtsDB	本地检索库，用于使用本地检索功能，可自主选择集成。若选择集成，需要与 NIMSDK 一起使用。
NIMQChat	IM 即时通讯的圈组能力，可自主选择集成。若选择集成，需要与 NIMSDK 一起使用。
NIMSocketRocket	WebSocket 能力，用于提升联通性，可自主选择集成。若选择集成，需要与 NIMSDK 一起使用。
NIMQUIC	QUIC 能力，用于提升联通性，可自主选择集成。若选择集成，需要与 NIMSDK 一起使用。

NIMSDK 需要与 NIMNOS 或者 NIMFCS 搭配使用，无法单独使用。
- 若开发者服务的对象在国内，则使用 NIMSDK 和 NIMNOS Frameworks。
- 若开发者服务的对象在海外，需要 S3 文件存储能力，那么使用 NIMSDK 和 NIMFCS Frameworks。
NIMNOS 和 NIMFCS 无法同时使用。

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

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

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

此文档是否对你有帮助？

有帮助

去反馈