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