mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-08-02 23:49:34 +08:00
68 lines
1.7 KiB
Markdown
68 lines
1.7 KiB
Markdown
# 版本兼容性说明
|
||
|
||
## 支持的 OpenWrt 版本
|
||
|
||
本主题已针对以下 OpenWrt 版本进行优化和测试：
|
||
|
||
- ✅ **OpenWrt 21.x** - 完全支持
|
||
- ✅ **OpenWrt 23.x** - 完全支持
|
||
- ✅ **OpenWrt 24.x** - 完全支持
|
||
|
||
## 主要兼容性改进
|
||
|
||
### 1. LuCI API 兼容
|
||
- 兼容新旧版本的 `L.env.dispatchpath` 和 `L.env.requestpath`
|
||
- 支持不同版本的 ubus 调用方式
|
||
- 自动检测并适配 LuCI 版本
|
||
|
||
### 2. JavaScript 依赖
|
||
- jQuery 可选：在没有 jQuery 的环境下使用原生 JavaScript
|
||
- 动画效果降级：无 jQuery 时使用 CSS 过渡
|
||
- 兼容层自动检测运行环境
|
||
|
||
### 3. 资源加载
|
||
- 版本化资源 URL，避免缓存问题
|
||
- 兼容不同版本的资源路径结构
|
||
|
||
## 已知问题
|
||
|
||
### OpenWrt 23/24 特定问题
|
||
1. 某些第三方插件可能需要单独适配
|
||
2. 如果遇到菜单显示问题，请清除浏览器缓存
|
||
|
||
## 测试建议
|
||
|
||
编译安装后，请测试以下功能：
|
||
- [ ] 登录界面显示正常
|
||
- [ ] 主菜单展开/收起
|
||
- [ ] 移动端响应式布局
|
||
- [ ] 深色模式切换
|
||
- [ ] 各插件页面样式
|
||
|
||
## 反馈问题
|
||
|
||
如果在特定版本遇到问题，请提供：
|
||
1. OpenWrt 版本号
|
||
2. LuCI 版本号
|
||
3. 浏览器类型和版本
|
||
4. 具体问题截图
|
||
|
||
## 技术细节
|
||
|
||
### 兼容层实现
|
||
主题包含 `compat.js` 兼容层，自动检测 LuCI 版本并提供统一接口。
|
||
|
||
### 版本检测
|
||
```javascript
|
||
// 检测是否为新版本 LuCI (23+)
|
||
if (L.env.luci_version) {
|
||
var majorVersion = parseInt(L.env.luci_version.split('.')[0]);
|
||
var isNewVersion = majorVersion >= 23;
|
||
}
|
||
```
|
||
|
||
### jQuery 降级
|
||
当 jQuery 不可用时，自动使用原生 DOM API：
|
||
- `$(el).slideUp()` → `el.style.display = 'none'`
|
||
- `$(el).css()` → `el.style.property = value`
|