Skip to content

Jugg 运行面板

Jugg 运行面板把一次运行的当前阶段、待处理文件、近期结果和常用恢复动作集中在一个项目级工具窗口中。它适合在 Run 输出过长、需要比较多次运行,或想快速判断当前工程是否具备增量基线时使用。

单次 Run 输出难以回答连续状态

Run tool window 更适合查看一轮任务的完整文本,但日常排查经常需要同时回答:

  • 当前卡在变化检测、编译、部署还是启动。
  • 哪些文件仍待处理。
  • 最近几次运行走的是增量、Gradle、Hot Reload、Hot Fix 还是安装。
  • 当前工程是否已经具备可用的增量基线。

运行面板使用结构化事件维护当前 IDE 会话的状态,因此切换 Run 标签页后仍能看到近期结果。

打开面板

有可运行 Jugg 配置的工程会在 Android Studio 右侧显示 `Jugg Running Pannel` 工具窗口。也可以从 `Tools > Open Jugg Control Panel` 打开。

Run Configuration 中需要进入设置的入口会直接切到面板的 Settings 页,不需要在两个窗口间重复查找。

Overview

Overview 聚合以下信息:

区域内容
Run status当前任务阶段、阶段进度和耗时
Changed files待处理文件、所属模块和文件类型;双击可打开文件
Quick actionsGradle 构建、清理 Jugg、重启 App、清数据重装、报告问题、检查更新、安装 CLI/Skill
This session当前会话成功编译、Hot Reload、Hot Fix、Install 次数
Recent runs最近运行的编译方式、部署方式、耗时、失败原因和相关文件

面板显示 `Hot reload baseline is ready` 时,说明当前工程具备可继续增量的基线;显示 `Full Gradle build required` 时,应先完成一次完整构建。

Logs

Logs 页展示 Jugg 的结构化核心事件,可以按来源、级别、当前任务和关键词过滤。

  • 来源包括 Deploy、Runtime、CLI / MCP。
  • 级别包括 Info、Warn、Error。
  • `Current task` 只保留当前任务事件。
  • `Follow` 自动跟随新事件。
  • 选中事件后可复制,适合附加到问题报告。

结构化日志用于快速定位阶段,不替代完整日志。需要查看 Gradle 输出、异常栈或底层部署细节时,继续打开 `build/jugg/log/compile_latest.log`。

Settings

Settings 页可以直接调整常用运行行为:

  • 无文件变化时是否确认 Gradle 回退。
  • 部署后是否始终重启 App。
  • 是否启用 Quick deploy。
  • 部署失败后是否自动回退 Gradle。
  • 是否把变化嵌入 APK。
  • 是否使用项目 Kotlin compiler。
  • 是否备份 classpath。

还可以安装 CLI 和 Agent Skills、检查更新,或执行 `Clear Jugg Build` 重新初始化工程。

WARNING

`Clear Jugg Build` 会删除项目级 Jugg 构建数据。它适合缓存明显损坏或基线无法恢复的场景,不是日常清理动作。

会话边界

近期运行、会话计数和结构化事件主要服务当前 Android Studio 会话。IDE 重启后不要把空的 Recent runs 误判为从未运行;持久化的编译上下文和部署历史仍由项目级缓存维护。

相关页面