更新记录

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。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。