主题
晞晗IM iOS SDK
这是面向 iPhone 和 iPad App 开发者的独立产品入口。iOS SDK 的安装、权限、 生命周期、示例和验收都在本目录说明；不需要先阅读 macOS 或服务端部署文档。
交付内容
| 内容 | iOS 用途 |
|---|---|
XHIM | 无界面的 Swift Facade、账号生命周期、消息、关系链、群组、媒体和离线读取 |
XHIMSwiftUI | 可选会话列表、聊天页、输入栏、附件选择和消息 Renderer |
XHIMCore.xcframework | 不公开源码的 C++ 内核，必须包含 iOS Device 与 Simulator slice |
PrivacyInfo.xcprivacy | SDK Privacy Manifest |
Examples/XHIMDemo | 可直接运行的 iOS 示例 App |
SDK 内部复用 platforms/apple 中的 Swift 实现和 XCFramework 发行工具，但它们 不是购买方的接入入口。iOS App 只消费签名二进制包和公开 Swift API。
从哪里开始
- Swift Package：按从零接入操作；
- CocoaPods：按CocoaPods 从零接入操作；
- 回调原型、参数和错误：iOS 回调式 API；
- 全部业务模块：SDK API Reference。
iOS 运行要求
- iOS 15 或更高版本；
- Swift 5.9 或更高版本；
- Production 使用 HTTPS/WSS；
- 使用拍照、相册、麦克风时，由宿主 App 添加对应
Info.plist用途说明； - APNs entitlement、证书和描述文件只属于宿主 App，接入 SDK 本身不要求交给 XHIM。
iOS 生命周期
账号级容器持有一个 XHIMClient。登录后创建，切换账号时先 logout，App 确定不再使用时 shutdown。View、Cell 和 ViewModel 不创建 Core，也不直接读 SDK SQLite。前后台切换由 SDK 维持持久 Outbox；网络恢复时可调用 notifyNetworkAvailable() 加速重连。
可销售状态的验收边界
源码中存在 iOS Facade 不等于客户制品已经发布。每个可售版本仍必须同时通过：
- iPhone arm64 和 Simulator arm64/x86_64 slice 检查；
- 空白 SwiftPM 与 CocoaPods 工程编译、链接和启动；
- 真机登录、收发、离线、附件、前后台、切网和升级矩阵；
- XCFramework 签名、Hash、SBOM、NOTICE 与 Release Manifest 校验。