SuperAPI AI 工具集

electrobun-debugging

编程与开发

查看项目

更新于 10-16 04:57

技能介绍

该技能面向 Electrobun 桌面应用的开发与排错,内容按用途可分为开发环境配置、主进程调试、webview 调试、RPC 排错、性能分析和常见问题处理。

用途:为 Electron 类桌面框架 Electrobun 的开发过程提供系统化调试指引,帮助定位主进程、webview 与两端通信中的问题。

主要能力:

  • 开发模式与日志:支持 bun run dev 热重载,可通过 DEBUG=* 或 DEBUG=electrobun:* 开启详细日志,并在 .env.development 中配置 NODE_ENV、ELECTRON_ENABLE_DEVTOOLS、ELECTRON_DISABLE_SECURITY_WARNINGS、DEV_SERVER_PORT 等。
  • 主进程调试:控制台与结构化日志、process.on("uncaughtException") 与 unhandledRejection 全局错误处理、win.on("error")、RPC 处理函数异常捕获,以及 Bun 调试器 bun --inspect run dev、bun --inspect-brk run dev 配合 chrome://inspect。
  • webview 调试:通过 win.openDevTools()、win.toggleDevTools() 等打开/切换 Chrome DevTools,控制台日志与分组输出,window 的 error 与 unhandledrejection 事件捕获并回传主进程记录。
  • RPC 通信排错:可用包装器为各 handler 输出调用参数、返回结果与耗时,也可在 webview DevTools 中直接调用 electroview.rpc 方法、测试错误路径并用 console.time 测量耗时。
  • 性能与内存:使用 perf_hooks 的 PerformanceObserver 做测量,webview 侧用 console.profile 或 DevTools Performance 面板;主进程用 process.memoryUsage() 记录内存,webview 用 performance.memory。
  • 常见问题:模块缺失、原生模块编译失败、Windows WebView2 缺失、窗口不显示、RPC 不工作、内存占用过高,以及 macOS/Windows/Linux 平台的权限、签名与依赖库问题。

使用方式:在 Electrobun 项目中按上述命令与调试接口逐步执行,先复现问题,再区分主进程或 webview,添加日志与断点后定位;该技能还给出网络请求拦截、source map 开启配置和一套系统化排查步骤。

适用场景:Electrobun 应用的开发期调试、通信异常排查、性能与内存分析及构建运行错误定位。

限制:资料未提供价格、收费与平台支持范围的完整说明;示例代码需按实际项目结构调整,部分调试能力依赖对应平台工具链(如 Xcode Command Line Tools、Visual Studio Build Tools、webkit2gtk-4.1 等)。