@xuqm/rn-common
XuqmGroup RN SDK 核心模块。负责 SDK 初始化、HTTP 请求、Token 管理、设备信息、XWebView Bridge、API hooks。
安装
yarn add @xuqm/rn-common @react-native-async-storage/async-storage
Peer dependencies：react >= 18，react-native >= 0.76，axios >= 1.0.0
初始化
方式 A — 配置文件自动初始化（推荐）
在宿主项目中配置 Babel alias @xuqm/autoinit-config → 加密配置文件：
// metro.config.js
config.resolver.extraNodeModules = {
'@xuqm/autoinit-config': './path/to/your.xuqmconfig',
};
SDK 在 import 时自动调用 initWithConfigFile()，App 无需任何 init 代码。
方式 B — 手动初始化
import { XuqmSDK } from '@xuqm/rn-common'
await XuqmSDK.initialize({ appKey: 'xxx' }) // 公有平台
await XuqmSDK.initialize({ appKey: 'xxx', platformUrl: 'https://xxx' }) // 私有化
await XuqmSDK.awaitInitialization() // 等待配置拉取
API
初始化
| API |
说明 |
XuqmSDK.initialize(opts) |
初始化，拉取平台配置 |
XuqmSDK.awaitInitialization() |
等待异步初始化完成 |
isInitialized() |
检查 SDK 是否就绪 |
getConfig() |
获取已解析的平台配置 |
用户信息
| API |
说明 |
XuqmSDK.setUserInfo(info) |
设置用户信息，触发所有子 SDK 登录 |
XuqmSDK.setUserInfo(null) |
登出，触发全局登出 |
getUserId() |
获取当前 userId |
getUserInfo() |
获取当前用户信息 |
setUserId(id) |
直接设置 userId（内部用） |
HTTP
| API |
说明 |
apiRequest(url, options?) |
带 Bearer token 的 HTTP 请求 |
configureHttp(opts) |
覆盖 HTTP 基础配置 |
_getToken() |
获取当前 token（内部用） |
_saveToken(token) |
保存 token（内部用） |
_clearToken() |
清除 token（内部用） |
设备
| API |
说明 |
getDeviceId() |
获取设备稳定 UUID |
getDeviceInfo() |
获取设备品牌/型号/系统信息 |
detectPushVendor() |
检测设备推送厂商 |
XWebView Bridge
| API |
说明 |
openXWebView(url, options?) |
打开 WebView |
setXWebViewController(controller) |
设置全局 WebView 控制器 |
getXWebViewConfig() |
获取当前 WebView 配置 |
XWebViewControl |
WebView 控制器类 |
API Hooks
| API |
说明 |
useApi(method, url, opts?) |
React hook：带 loading/error 的 API 调用 |
usePageApi(method, url, opts?) |
React hook：分页 API |
useRequest(opts?) |
React hook：通用请求 |
setGlobalApiErrorHandler(handler) |
设置全局 API 错误处理 |
UI
| API |
说明 |
showToast(msg) |
显示 toast |
showAlert(title, msg) |
显示 alert |
showConfirm(title, msg) |
显示确认对话框 |
ScaledImage |
等比缩放图片组件 |
常量
| 常量 |
说明 |
DEFAULT_TENANT_PLATFORM_URL |
默认公有平台地址 |
DEFAULT_IM_WS_URL |
默认 IM WebSocket 地址 |
4c3019edab
