lxy/flux-web

Fork 0

Files

绝尘 d703ac3574 .

2026-01-22 18:31:30 +08:00

4.4 KiB

Raw Blame History

极光离线SDK配置指南

🎯 目标

解决 ERR_CONNECTION_CLOSED 错误，使用离线SDK文件。

⚠️ 重要提示：极光一键登录SDK需要 crypto-js 作为依赖库！

📦 完整依赖（2个文件）

必需文件：

crypto-js.min.js - 加密库依赖（必需）
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自动切换机制：

// 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：

# 方案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（如果网络受限）

开启VPN
访问：https://js.jverification.com/jverification_web.js
保存网页内容为 jverification_web.js
保存到：src/assets/js/

✅ 验证配置

测试步骤：

下载并保存文件
刷新页面（Ctrl + Shift + R）
查看控制台

成功标志：

✅ [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）
或使用VPN下载（方法4）
保存到本地 src/assets/js/jverification_web.js

📱 测试一键登录

在真实手机上测试（推荐）：

手机连接电脑
- Android: 使用 Chrome DevTools 远程调试
- iPhone: 使用 Safari Web Inspector
或部署到服务器
- 使用真实域名访问
- 在手机浏览器打开
使用移动网络
- 关闭WiFi
- 使用4G/5G网络

⚠️ 重要说明

当前状态：

✅ 后端服务：已配置并运行（端口26117）
✅ 前端配置：AppKey已配置
✅ RSA密钥：已配置
✅ Picker组件：已修复
⏳ 离线SDK：待下载

即使没有SDK，功能仍然正常：

✅ 短信验证码登录
✅ 表单验证
✅ 自动登录
✅ 页面跳转

一键登录是锦上添花，不是必需功能！

🎯 推荐做法

开发阶段：

✅ 使用短信验证码登录（当前）
⏸️ 稍后配置一键登录

生产环境：

✅ 使用离线SDK文件
✅ 或使用备用CDN
✅ 确保移动网络可用

请选择一个方法配置SDK，或告诉我您的选择！ 😊

4.4 KiB Raw Blame History Unescape Escape