SDKsiOS
开始之前
准备 OpenIMServer、用户登录信息和 iOS 工程环境,再开始认证或发送消息。
在 iOS 应用中接入 OpenIM SDK 前,需要先准备可访问的 OpenIMServer、用户登录信息和可安装 Objective-C SDK 的工程。
准备 OpenIMServer
如果还没有可用的 OpenIMServer,先按 Docker 部署指南完成部署,并确认真机和模拟器都能访问以下地址:
| 字段 | 说明 |
|---|---|
apiAddr | OpenIMServer 的 HTTP API 地址,用于登录、同步和资源请求。 |
wsAddr | OpenIMServer 的 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;继续接入
这个页面有帮助吗?