报告问题
报告问题功能把本轮 Jugg 日志和设备错误日志打包,上传到固定的问题报告服务。它适合在增量编译失败、部署失败、运行结果不符合预期时使用。无论是否配置了 Jugg 后台或 Custom Server,上传目标都不会改变。
从哪里打开
推荐使用以下任一入口:
- 在 Android Studio 中双击
Shift,搜索并选择Report Jugg Issue。 - 打开
Jugg Running Panel,点击Report Issue。
也可以从 Jugg Run Configuration 打开:
- 打开
Edit Configurations...。 - 选择当前 Jugg 配置。
- 点击
Report issues。
打开报告窗口后:
- 核对并选择诊断文件。Jugg 日志默认选中且不可取消;工程快照默认选中,但可以取消。
- 选择
Upload logs上传,或勾选Save locally without uploading后创建本地诊断包。 - 上传完成后复制 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.json、gradle_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 天后会在项目启动后的清理任务中删除。
本地日志位置
如果暂时无法上传,可以先查看最新日志:
build/jugg/log/compile_latest.log这个文件记录最近一次编译部署的主日志。排查部署、回退和运行时问题时,通常先看这里。