From 71eeada147245b5590e76070864149ee9196e744 Mon Sep 17 00:00:00 2001 From: XuqmGroup Date: Thu, 18 Jun 2026 15:40:19 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=85=8D=E7=BD=AE=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E8=A7=84=E8=8C=83=E6=9B=B4=E6=96=B0=E4=B8=BA=20.xuqmconfig=20?= =?UTF-8?q?=E6=A0=BC=E5=BC=8F=EF=BC=88Android/iOS=20=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E8=A1=A8=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- docs/配置文件规范.md | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/docs/配置文件规范.md b/docs/配置文件规范.md index afbd1fb..3b73b70 100644 --- a/docs/配置文件规范.md +++ b/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) |