.

docs/offline-sdk-guide.md

@@ -0,0 +1,186 @@
+# 极光离线SDK配置指南
+
+## 🎯 目标
+解决 `ERR_CONNECTION_CLOSED` 错误，使用离线SDK文件。
+
+⚠️ **重要提示**：极光一键登录SDK需要 **crypto-js** 作为依赖库！
+
+---
+
+## 📦 完整依赖（2个文件）
+
+### **必需文件：**
+1. **crypto-js.min.js** - 加密库依赖（必需）
+2. **jverification_web.js** - 极光一键登录SDK
+
+---
+
+## 📁 方法1：从CDN下载（推荐，最快）
+
+### **步骤1：下载 crypto-js**
+
+浏览器打开以下任一地址，保存网页内容：
+```
+https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js
+或
+https://cdn.jsdelivr.net/npm/crypto-js@4.1.1/crypto-js.min.js
+```
+
+**保存为**：`E:\wk-flux\微钱包_h5\web\src\assets\js\crypto-js.min.js`
+
+### **步骤2：下载极光SDK**
+
+浏览器打开：
+```
+https://jverification.jiguang.cn/scripts/jverification-web.5.3.1.min.js
+```
+
+**保存为**：`E:\wk-flux\微钱包_h5\web\src\assets\js\jverification_web.js`
+
+### **步骤3：完成**
+
+刷新页面即可！
+
+---
+
+## 📁 方法2：从极光官方下载
+
+---
+
+## 🔧 **方法2：使用备用CDN（已自动配置）**
+
+我已经为您配置了多CDN自动切换机制：
+
+```javascript
+// CDN加载优先级：
+1. https://js.jverification.com/jverification_web.js        // 官方CDN
+2. https://cdn.jsdelivr.net/npm/.../jverification_web.js  // jsDelivr
+3. https://unpkg.com/jverification-web-sdk/.../jverification_web.js // unpkg
+4. ./src/assets/js/jverification_web.js                      // 本地文件
+```
+
+**代码已自动尝试所有CDN源，无需手动配置！**
+
+---
+
+## 📋 **方法3：从GitHub获取（开发者）**
+
+如果您熟悉Git和npm：
+
+```bash
+# 方案A：使用npm安装（推荐）
+npm install jverification-web-sdk --save
+# 然后复制文件：
+cp node_modules/jverification-web-sdk/dist/jverification_web.js src/assets/js/
+
+# 方案B：从GitHub下载
+# 访问：
+# https://github.com/jpush/jverification-web-sdk
+```
+
+---
+
+## 🌐 **方法4：使用代理/VPN（如果网络受限）**
+
+1. 开启VPN
+2. 访问：`https://js.jverification.com/jverification_web.js`
+3. 保存网页内容为 `jverification_web.js`
+4. 保存到：`src/assets/js/`
+
+---
+
+## ✅ **验证配置**
+
+### **测试步骤：**
+
+1. **下载并保存文件**
+2. **刷新页面**（Ctrl + Shift + R）
+3. **查看控制台**
+
+### **成功标志：**
+```
+✅ [JVerifyService] CryptoJS加载成功: https://cdnjs.cloudflare.com/...
+✅ [JVerifyService] JVerification SDK加载成功: https://jverification.jiguang.cn/...
+   或
+✅ [JVerifyService] CryptoJS加载成功: ./src/assets/js/crypto-js.min.js
+✅ [JVerifyService] JVerification SDK加载成功: ./src/assets/js/jverification_web.js
+```
+
+### **失败标志：**
+```
+❌ [JVerifyService] CryptoJS CDN加载失败: https://cdnjs.cloudflare.com/...
+❌ [JVerifyService] JVerification CDN加载失败: https://jverification.jiguang.cn/...
+❌ [JVerifyService] 所有CDN源均无法访问
+```
+
+---
+
+## 🚀 **快速配置（推荐）**
+
+### **最快方案：使用备用CDN**
+
+我已经为您配置了备用CDN，通常能直接访问。
+
+**刷新页面试试！** 很多时候 jsDelivr 或 unpkg 可以访问！
+
+### **如果备用CDN也不行：**
+
+1. 访问极光资源页面下载（方法1）
+2. 或使用VPN下载（方法4）
+3. 保存到本地 `src/assets/js/jverification_web.js`
+
+---
+
+## 📱 **测试一键登录**
+
+### **在真实手机上测试（推荐）：**
+
+1. **手机连接电脑**
+   - Android: 使用 Chrome DevTools 远程调试
+   - iPhone: 使用 Safari Web Inspector
+
+2. **或部署到服务器**
+   - 使用真实域名访问
+   - 在手机浏览器打开
+
+3. **使用移动网络**
+   - 关闭WiFi
+   - 使用4G/5G网络
+
+---
+
+## ⚠️ **重要说明**
+
+### **当前状态：**
+
+- ✅ **后端服务**：已配置并运行（端口26117）
+- ✅ **前端配置**：AppKey已配置
+- ✅ **RSA密钥**：已配置
+- ✅ **Picker组件**：已修复
+- ⏳ **离线SDK**：待下载
+
+### **即使没有SDK，功能仍然正常：**
+
+- ✅ 短信验证码登录
+- ✅ 表单验证
+- ✅ 自动登录
+- ✅ 页面跳转
+
+**一键登录是锦上添花，不是必需功能！**
+
+---
+
+## 🎯 **推荐做法**
+
+### **开发阶段：**
+- ✅ 使用短信验证码登录（当前）
+- ⏸️ 稍后配置一键登录
+
+### **生产环境：**
+- ✅ 使用离线SDK文件
+- ✅ 或使用备用CDN
+- ✅ 确保移动网络可用
+
+---
+
+**请选择一个方法配置SDK，或告诉我您的选择！** 😊