# 极光离线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，或告诉我您的选择！** 😊