Skip to content

报告问题

报告问题功能把本轮 Jugg 日志和设备错误日志打包,上传到固定的问题报告服务。它适合在增量编译失败、部署失败、运行结果不符合预期时使用。无论是否配置了 Jugg 后台或 Custom Server,上传目标都不会改变。

从哪里打开

推荐使用以下任一入口:

  • 在 Android Studio 中双击 Shift,搜索并选择 Report Jugg Issue
  • 打开 Jugg Running Panel,点击 Report Issue

也可以从 Jugg Run Configuration 打开:

  1. 打开 Edit Configurations...
  2. 选择当前 Jugg 配置。
  3. 点击 Report issues

打开报告窗口后:

  1. 核对并选择诊断文件。Jugg 日志默认选中且不可取消;工程快照默认选中,但可以取消。
  2. 选择 Upload logs 上传,或勾选 Save locally without uploading 后创建本地诊断包。
  3. 上传完成后复制 Report ID;失败时可以点击 Retry Upload,或把保留的 zip 交给维护人员。

确认窗口会展示固定上传地址 https://jugg.sickworm.com/report_issue。插件只向该 HTTPS 地址提交诊断包,不读取 Custom Server,失败后也不会切换服务器。选择本地保存后,系统文件管理器会选中新生成的 zip。

上传成功后,结果窗口会显示 8 位小写十六进制 Report ID。把它和复现步骤一起发给维护者。

会上传什么

上传内容主要用于定位本轮 Jugg 行为:

  • Jugg 编译和部署日志。
  • 结构化的环境和工程摘要。
  • 默认勾选、可取消的 IDE、Gradle 和 included build 工程快照。
  • 可取消的目标设备错误 logcat。
  • 可选的 hook 调试日志。
  • 描述实际 zip entry 的 manifest.json

工程快照包含现存的 project_infos.jsongradle_project_infos.json,以及当前 included build 对应的 include_build_*_gradle_project_infos.json,脱敏后保存到诊断包的 diagnostics/project-info/applicationId 和字段是否存在等诊断信息会保留;签名凭据、keystore、keyAlias、Manifest placeholders、APT/KAPT 参数和常见敏感字段的值会被替换。无法解析的快照、过期的 included build 快照、其他 project_infos.db 文件、源码和二进制依赖不会进入诊断包。hook 调试日志保存在 diagnostics/cli/hook-debug.log

NOTE

上传失败不会改变本地编译部署结果。临时 zip 保留在 build/jugg/tmp/diagnostics,可以重试上传;达到 7 天后会在项目启动后的清理任务中删除。

本地日志位置

如果暂时无法上传,可以先查看最新日志:

bash
build/jugg/log/compile_latest.log

这个文件记录最近一次编译部署的主日志。排查部署、回退和运行时问题时,通常先看这里。

相关页面