选择平台与接入说明

本页只用来帮你找到正确的 SDK 接入页。每个平台只有一个主入口；安装方式、 可选 UI、Demo 和高级 API 都在该平台页内继续选择。

XHIM 的产品介绍、版本方案和商业信息请查看 XHIM 产品页。本站专注于 SDK 使用和 Demo 二次开发。

1. 选择你的平台

你正在开发	从这里开始	页内默认示例	可直接运行的 Demo
iPhone / iPad App	iOS	Swift Completion，再选 CocoaPods 或 Swift Package	xhim-ios-app
Android App	Android	Java、CompletableFuture、XML/ViewBinding	xhim-android-app
HarmonyOS App	HarmonyOS	ArkTS、Promise、ArkUI	xhim-harmony-app
macOS App	macOS	Swift Completion	xhim-macos-app
Windows App	Windows	C# Task 与 WPF	xhim-windows-app
浏览器网站	Web	TypeScript，可配合 React/Vue/Svelte	xhim-web-app
Electron 桌面应用	Electron	Main / Preload / Renderer	xhim-electron-app
Flutter App	Flutter	Dart，页内可继续选 UI Kit	xhim-flutter-app
React Native App	React Native	TypeScript，Android 宿主与 Native Module 使用 Java	xhim-react-native-app
Unity 游戏	Unity	C#	xhim-unity-app
uni-app	uni-app	页内选 H5、App 或小程序运行时	xhim-uni-app
微信或其他小程序	小程序	TypeScript，微信可直接使用内置 Adapter	xhim-mini-program-app

Web 和 Electron 怎么选

• 页面在 Chrome、Safari、Edge 等普通浏览器中运行：选 Web；
• 应用由 Electron 打包为 Windows/macOS/Linux 桌面程序：选 Electron；
• 两者的安装包不能混用。

Android 为什么默认是 Java

Android 主接入使用 Java + CompletableFuture + Listener，方便现有 Java/XML、 MVP 或 MVVM 项目直接接入。Kotlin Coroutine/Flow 入口仍然保留，但不作为 新项目文档的默认示例。

2. 每个平台都按这个顺序接入

1. 领取 Server URL、App ID 和测试账号
2. 安装当前平台的固定版本 SDK
3. 在账号层创建 Client
4. 注册连接和数据变化监听
5. 连接当前账号
6. 创建或查询会话，发送第一条消息
7. 用第二个账号验证接收、已读和断网恢复
8. 验证登出、换号和资源释放

各平台的方法名和异步写法不同，但业务顺序相同。完成首条消息之前， 只需准备账号、服务地址和当前平台的 SDK 包。

3. 接入前需要的信息

参数	由谁提供	说明
Server URL	XHIM 服务端负责人	例如 https://im-test.example.com
App ID	XHIM 服务端负责人	某些平台使用 Server 默认值，以当前页面为准
当前用户 ID	你的业务账号系统	必须与当前 App 登录用户一致
XHIM 访问凭证	你的业务后台	正式环境使用短期凭证，不在客户端写入管理密钥
对端用户 ID	测试账号	用于验证首条消息

Development 环境如果已启用测试登录，平台 QuickStart 会给出更短的连接示例。 正式环境一律使用业务后台凭证。

4. 下一步

• 还没有选定平台：从本页第 1 节选择主入口；
• 已经能发送消息：查看 API Reference；
• 准备改 UI、Repository 或自定义消息：查看 客户端二次开发；
• 连接失败或收不到消息：先查看当前平台页底部的“常见问题”。