更新记录
1.0.7(2026-11-21) 下载此版本
- 优化请求耗时显示:超过 1 分钟时秒数不补零、为 0 时省略(如
1m、1m5s、2m5s)
1.0.6(2026-11-21) 下载此版本
- Network 页请求详情(Request Body / Response)默认收起,点击请求条目才展开;已展开的条目在列表刷新后保持展开状态
- 面板顶部压缩:标题栏字号与内边距下调、Tab 栏按钮高度下调,腾出更多内容区空间
- 去掉请求详情块左侧的主题色竖条
- 请求耗时单位自适应:不足 1 秒显示
ms,1 秒以上显示s,超过 1 分钟显示xx分xx秒 - Storage 页「Clear All」增加二次确认弹层,确认后才清空本地缓存
- Console / Network 页工具栏「Clear」同样增加二次确认弹层
- 清空成功后给出轻提示(Toast):已清空控制台日志 / 已清空网络请求记录 / 已清空本地缓存
- Storage 页隐藏顶部工具栏(该页已有独立的 Clear All,避免功能重复并留空条)
1.0.4(2026-11-21) 下载此版本
- 修复蒸汽(Vapor)模式下应用启动时报错
TypeError: CreateListFromArrayLike called on non-object:console 采集包装函数改用剩余参数收集全部实参,修复此前只接收首个参数导致origin.apply(console, rest)收到非数组对象的问题
平台兼容性
uni-app x(4.85)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| × | × | 5.0 | 12 | × | × |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
App 调试控制台(app-console-panel)
基于 UTS + 原生 WebView 的 App 端在线调试控制台。运行时在设备上查看 Console 日志 / 网络请求 / 本地缓存(Storage)。
平台支持
| 平台 | 支持情况 |
|---|---|
| App-Android | ✅ Android 5.0+(插件 minSdkVersion 21;蒸汽模式项目需 6.0+) |
| App-iOS | ✅ iOS 12+ |
功能
Console 页
- 接管
console.log / info / warn / error,按级别分组并显示条数徽标 - 序列化带循环引用保护、5 层深度限制、单条 10KB 截断,避免超长对象卡住面板
Network 页
- 拦截
uni.request、uni.uploadFile、uni.downloadFile - 记录请求方法、请求头、请求体、状态码、响应、响应头与耗时,请求状态实时更新(pending / success / fail)
Storage 页
- 展示本地缓存(
uni.setStorageSync等)的全量键值,业务写入后自动刷新 - 支持在面板内删除单条缓存与清空全部
悬浮面板
- 面板与悬浮按钮承载在独立悬浮窗口(
TYPE_APPLICATION_PANEL),无需悬浮窗权限 - 悬浮按钮可拖拽,点击按钮开合面板,点击遮罩关闭面板
- 面板 JS 就绪后由原生层补发缓存的全量数据,避免首屏空白
- 切换页面(uni-app x 中一个页面即一个 Activity)后自动重建覆盖层
使用方式
在项目根目录 main.js 中引入并初始化:
import App from './App.uvue'
// #ifdef APP-ANDROID || APP-IOS
import {
initDebugPanel
} from '@/uni_modules/app-console-panel/addInterceptor'
// #endif
import {
createSSRApp
} from 'vue'
export function createApp() {
const app = createSSRApp(App)
// #ifdef APP-ANDROID || APP-IOS
initDebugPanel({
app,
// 面板高度占屏幕高度的百分比
heightPercent: 70,
// 悬浮按钮距底部距离(dp)
buttonBottom: 200,
// 悬浮按钮距右侧距离(dp)
buttonRight: 20,
// 悬浮按钮文字(最多取前 10 个字符)
buttonText: '调试',
// 主题色:同时作用于悬浮按钮与面板内强调色
themeColor: '#4FC08D',
// 是否显示悬浮按钮,默认 true;false 时隐藏,改由业务代码手动打开面板
buttonVisible: true
})
// #endif
return {
app
}
}
面板为原生实现,仅 App 端可用。项目若同时编译 Web / 小程序等端,请用条件编译
APP-ANDROID || APP-IOS分别把import与initDebugPanel调用包起来。
配置项
initDebugPanel(options) 的参数:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
app |
any |
- | Vue 应用实例,用于接管 console 输出 |
heightPercent |
number \| null |
70 |
面板高度占屏幕高度的百分比 |
buttonBottom |
number \| null |
200 |
悬浮按钮距底部距离(dp) |
buttonRight |
number \| null |
20 |
悬浮按钮距右侧距离(dp) |
buttonText |
string \| null |
'调试' |
悬浮按钮文字,最多取前 10 个字符 |
themeColor |
string \| null |
'#4FC08D' |
主题色,同时作用于悬浮按钮与面板内强调色(Tab 选中、筛选激活、详情色条、Storage key 等);非法颜色回退为默认色 |
buttonVisible |
boolean \| null |
true |
是否显示悬浮按钮。false 时不显示悬浮按钮,改由业务代码调用 showNativePanel() 手动打开 |
maxLogs |
number |
500 |
Console 日志最大条数,超出后丢弃最早一条 |
maxRequests |
number |
200 |
网络请求最大条数,超出后丢弃最早一条 |
导出接口
JS 层(addInterceptor)
| 接口 | 说明 |
|---|---|
initDebugPanel(options) |
一次性完成「拦截器安装 + 原生面板初始化」,最常用 |
createDebugPanel(options) |
仅安装拦截器,返回 { html, onEvalReady } 供原生层使用 |
getDebugPanelStore() |
获取当前存储实例(logs / requests),便于自行读取数据 |
原生层(utssdk,App 端)
initNativePanel、showNativePanel、hideNativePanel、isPanelVisible、evalPanelJS、setPanelSyncJS、isPanelSynced、setStorageActionHandler、destroyNativePanel、setFloatingButtonVisible。
隐藏悬浮按钮,手动打开面板
不想在界面上暴露悬浮按钮时,把 buttonVisible 设为 false,再由业务代码在需要时调用 showNativePanel():
// 初始化(main.js)
initDebugPanel({
app,
heightPercent: 70,
buttonBottom: 200,
buttonRight: 20,
buttonText: '调试',
themeColor: '#4FC08D',
// 不显示悬浮按钮
buttonVisible: false
})
// 业务代码:需要调试时手动打开面板
import { showNativePanel } from '@/uni_modules/app-console-panel/addInterceptor'
function openDebugPanel() {
showNativePanel()
}
也可以在运行时切换悬浮按钮的显示与否:
import {
setFloatingButtonVisible,
showNativePanel,
hideNativePanel,
isPanelVisible
} from '@/uni_modules/app-console-panel/addInterceptor'
setFloatingButtonVisible(false) // 隐藏悬浮按钮
setFloatingButtonVisible(true) // 重新显示悬浮按钮
showNativePanel() // 手动打开面板
hideNativePanel() // 关闭面板
isPanelVisible() // 面板当前是否可见
注意:这些接口依赖原生实现,仅在 App 平台可用,调用处需用条件编译(
APP-ANDROID || APP-IOS)包裹 import,或在自己的工具函数内部做条件编译(推荐)。
生产环境务必关闭
调试面板会接管 console 输出并暴露接口请求与本地缓存,生产发行包中必须关闭。推荐用 Vite 内置的 import.meta.env.PROD(发行构建为 true,运行调试为 false):
// #ifdef APP-ANDROID || APP-IOS
if (!import.meta.env.PROD) {
initDebugPanel({
app,
heightPercent: 70,
buttonBottom: 200,
buttonRight: 20,
buttonText: '调试',
themeColor: '#4FC08D',
buttonVisible: true
})
}
// #endif
如需更灵活(例如发行包里临时开启),可改用自定义环境变量:
.env.development:VITE_ENABLE_DEBUG_PANEL = true.env.production:VITE_ENABLE_DEBUG_PANEL = false
if (import.meta.env.VITE_ENABLE_DEBUG_PANEL === 'true') {
initDebugPanel({ app })
}
说明:以上方式只关闭运行时行为(不初始化面板、不劫持 console、不显示悬浮按钮)。插件的原生代码仍会随包进入安装包(体积很小且不产生任何行为)。若要让原生代码也不进生产包,需要在编译期移除对
@/uni_modules/app-console-panel的引用(如自定义条件编译),此时请同步删除上面代码中的 import。
注意事项
- 面板中的 删除 / 清空缓存 会真实操作本地存储,请在开发环境使用,不要在生产包中开启
- Android 端覆盖层依赖页面 Activity 的窗口 token,页面切换后由 Activity resume 事件重建;极端情况下(如页面切换动画中)可能出现短暂延迟
- iOS 端实现位于
utssdk/app-ios/index.uts,接口与 Android 端保持一致
目录结构
app-console-panel
├─ addInterceptor # JS 侧:拦截器与面板 HTML
│ ├─ index.ts # 对外入口
│ ├─ types.ts # 类型定义
│ ├─ panel-html.ts # 面板 HTML
│ └─ hooks/ # console / request / storage 拦截实现
├─ utssdk
│ ├─ interface.uts # 原生层接口声明
│ ├─ app-android/ # Android 实现(UTS + Kotlin 桥接)
│ └─ app-ios/ # iOS 实现
├─ package.json
├─ changelog.md
└─ readme.md
更新日志
详见 changelog.md。

收藏人数:
下载插件并导入HBuilder
下载示例项目ZIP
赞赏(0)
下载 381
赞赏 1
下载 12778503
赞赏 1960
赞赏
京公网安备:11010802035340号