# H5 安装配置

**包名**：`@xuqm/h5-sdk` · **语言**：TypeScript / JavaScript · **格式**：ESM + UMD

`@xuqm/h5-sdk` 是从 Vue3 SDK 提取的纯 JavaScript/TypeScript 核心库，**不依赖任何前端框架**（Vue/React/Angular 均可使用），可在任何支持 ES6 的浏览器或 H5 环境中运行。

> **功能范围**：仅包含 **IM** 功能（消息收发、会话管理、好友、群组），**不包含 Push 和 Update**。

---

## 安装

```bash
npm install @xuqm/h5-sdk
```

或 CDN 引入：

```html
<script src="https://dev.xuqinmin.com/docs/h5-sdk/index.umd.js"></script>
<script>
  const { init, ImManager, login } = XuqmH5SDK
</script>
```

---

## 初始化

只需传入 `appKey`，服务器地址由 SDK 内置。

```typescript
import { init } from '@xuqm/h5-sdk'

init({
  appKey: 'your_app_key',   // 在租户平台创建应用后获得
})
```

---

## 登录

```typescript
import { login } from '@xuqm/h5-sdk'

await login('user_001', 'your_user_sig_jwt')
```

---

## 下一步

- [H5 IM 接入 →](./im)
