xuqmGroup/XuqmGroup-RNSDK
0
0
派生 0
代码 工单 合并请求 版本发布 百科 动态

docs: 配置文件规范更新为 .xuqmconfig 格式（Android/iOS 对齐表）

浏览代码 
Co-Authored-By: Claude <noreply@anthropic.com>
这个提交包含在：
XuqmGroup 2026-06-18 15:40:19 +08:00
父节点 a9f320db63
当前提交 71eeada147
共有 1 个文件被更改，包括 12 次插入 和 10 次删除
显示统计 下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

22
docs/配置文件规范.md
查看文件

@ -127,13 +127,15 @@ const alias = {
### Android（原生）
配置文件位置：`src/main/assets/xuqm/config.xuqm`
配置文件位置：`src/main/assets/config/*.xuqmconfig`（推荐）或 `assets/xuqm/*.xuqmconfig`
Android SDK 通过 ContentProvider 自动读取，无需额外配置。
从平台下载 `.xuqmconfig` 文件（例如 `识校宝.xuqmconfig`），放入上述任一目录。文件名不限，扩展名为 `.xuqmconfig` 即可。Android SDK 通过 ContentProvider 自动扫描并读取，无需额外配置。
### iOS（原生）
配置文件位置：`{app}/xuqm/config.xuqm`
配置文件位置：`{app}/xuqm/*.xuqmconfig`
从平台下载 `.xuqmconfig` 文件，放入 App Bundle 的 `xuqm/` 目录。文件名不限，扩展名为 `.xuqmconfig` 即可。SDK 启动时自动扫描并读取。
---
@ -192,10 +194,10 @@ XuqmSDK.init({ appKey: "yiwangxin", debug: __DEV__ });
## 与 Android SDK 的对齐
| 环节 | Android SDK | RNSDK |
| ------------ | -------------------------- | --------------------------------------------- |
| 配置文件位置 | `assets/xuqm/config.xuqm` | `src/assets/xuqm/config.xuqmconfig.ts` |
| 自动初始化 | ContentProvider.onCreate() | common 包 import 时 autoInit |
| 解密 | ConfigFileCrypto (Java) | configCrypto (JS + react-native-quick-crypto) |
| 失败处理 | runCatching + Log.w | try/catch + 静默跳过 |
| 服务端点覆盖 | configurePrivateServer() | initializeFromLicense(serverUrl) |
| 环节 | Android SDK | RNSDK |
| ------------ | ---------------------------------- | --------------------------------------------- |
| 配置文件位置 | `assets/config/*.xuqmconfig` | `src/assets/config/*.xuqmconfig` |
| 自动初始化 | ContentProvider.onCreate() | common 包 import 时 autoInit |
| 解密 | ConfigFileCrypto (Java) | configCrypto (JS + react-native-quick-crypto) |
| 失败处理 | runCatching + Log.w | try/catch + 静默跳过 |
| 服务端点覆盖 | configurePrivateServer() | initializeFromLicense(serverUrl) |