SDKsHarmonyOS商业版
开始之前
准备 OpenIMServer、登录凭据、HarmonyOS 开发环境和 SDK HAR。
接入 OpenIM HarmonyOS SDK 前，需要准备可访问的 OpenIMServer、与用户 ID 匹配的登录 Token、商业版交付的 SDK HAR，以及能够构建 HarmonyOS 原生模块的开发环境。
准备服务地址
| 字段 | 说明 |
|---|---|
apiAddr | OpenIMServer HTTP API 地址，例如 https://api.example.com。 |
wsAddr | OpenIMServer WebSocket 地址，例如 wss://ws.example.com。 |
应从目标手机、平板和 2in1 设备验证 DNS、TLS 证书、防火墙、反向代理和 WebSocket 升级，不能只在开发电脑上验证地址。
准备用户与 Token
业务服务为当前账号取得对应的 userID 与 Token，再将两者交给 App 登录。服务端接入方式见准备使用 Platform API和获取用户 Token。
准备开发环境
- 能够构建目标 HarmonyOS 应用的 DevEco Studio。
- 与目标设备和 API 级别匹配的 HarmonyOS SDK，以及配套的 Hvigor、OHPM 工具。
- 商业版交付的 OpenIM SDK HAR。
- 面向
phone、tablet或2in1的应用模块。
不要同时加入另一版本的 OpenIM HAR 或手工复制其中的 SO 文件，否则可能出现重复原生模块、ABI 不一致或 ArkTS 声明与二进制不匹配。
准备权限和目录
SDK 需要 ohos.permission.INTERNET。应用前后台状态与网络变化由 SDK 包装层统一适配，业务页面无需重复注册监听或调用底层状态接口。
初始化前为 SDK 准备应用私有目录：
dataDir与dbPath用于本地数据库和同步数据。logFilePath用于 SDK 日志。- 三个路径都必须稳定、可写，不能使用临时缓存目录或共享外部目录。
发布前检查
- HAR 同时包含目标设备需要的 ABI。
- 真机可以访问 API、WebSocket 和消息媒体资源域名。
userID与 Token 相互匹配，并且可以完成登录。- 应用已经处理 Token 失效、账号切换和多端互斥登录，并验证 SDK 在前后台切换和网络恢复后可以正常同步数据。
- 退出登录与进程级 SDK 销毁是两个独立阶段，不会因页面或窗口关闭反复调用
unInitSDK()。
准备完成后继续阅读工程与设备接入。
这个页面有帮助吗？