浏览 SDKs · iOS
平台
SDKsiOS

开始之前

准备 OpenIMServer、用户登录信息和 iOS 工程环境,再开始认证或发送消息。

复制

在 iOS 应用中接入 OpenIM SDK 前,需要先准备可访问的 OpenIMServer、用户登录信息和可安装 Objective-C SDK 的工程。

准备 OpenIMServer

如果还没有可用的 OpenIMServer,先按 Docker 部署指南完成部署,并确认真机和模拟器都能访问以下地址:

字段说明
apiAddrOpenIMServer 的 HTTP API 地址,用于登录、同步和资源请求。
wsAddrOpenIMServer 的 WebSocket 地址,用于长连接和实时事件。

正式环境应使用有效的 HTTPS/WSS 证书。不要只验证服务在开发机本地可访问;还要检查移动网络、企业代理和应用的 App Transport Security 配置。

准备用户和 Token

userID 标识 OpenIMSDK 用户,Token 用于认证当前用户。业务后端负责创建或绑定用户,并向 iOS 应用提供相互匹配的 userID 和 Token。

后端可参考准备使用 Platform API签发会话 Token。业务账号与 OpenIMSDK userID 应保持稳定映射,Token 必须与该 userID 对应。

准备 iOS 工程

SDK 通过 CocoaPods 集成。公开 OpenIMSDK.podspec 声明最低部署版本为 iOS 11.0,因此应用 target 的 deployment target 不能低于 iOS 11.0。工程还需能够访问 OpenIMServer,并为相册、相机、麦克风或文件访问等实际使用的系统能力配置对应权限说明。

pod 'OpenIMSDK'

安装依赖后使用 .xcworkspace 打开工程,并在 Objective-C 文件中导入:

@import OpenIMSDK;

继续接入

准备完成后,先阅读按运行环境接入初始化 SDK,再完成认证与管理登录会话