Skip to content

Jugg 后台 ​

Jugg 可以连接一个 HTTP 后台,用于集中管理插件升级、热更新、项目默认配置、使用情况事件和远端机器申请。后台不是运行 Jugg 的必需条件;如果不配置后台,增量编译、部署、CLI、MCP 等本地能力仍可使用。有可用后台时,手工报告和失败日志自动上传都发送到该后台;无可用后台时自动上传跳过。

GitHub Releases 和 JetBrains Marketplace 的公开构建不包含预置服务器列表。首次安装公开包且没有后台配置时,插件不会自动连接后台。团队内部使用 buildPluginInternal 将服务列表打入插件;运行支持配置继承的内部包后,IDE 会记住该列表,之后升级公开包仍沿用内网默认配置,继续自动选服和连接后台。配置保存在 IDE 全局设置中,清理项目构建目录或打开其他项目不会移除它;用户明确设置的 Custom Server 优先,清空 Custom Server 恢复默认时重新使用记住的列表。

配置继承要求至少运行一次支持此行为的内部包。已经换成公开包、且没有保留服务器列表的旧安装,不能仅凭历史地址自动恢复。可用后台会继续按既有设置接收事件和原文诊断日志;没有可用后台时,用户仍可主动向公共服务提交脱敏诊断包。

这组页面面向需要自建后台的团队。重点说明插件当前支持哪些后台能力、哪些接口可以最小实现、哪些能力属于可选增强。

能力总览 ​

能力用途自建时是否必须
更新检查告诉插件是否有新的完整插件包,并可展示通知建议实现
项目配置下发按项目下发服务器列表、编译规则、模块配置和自定义编译器按需实现
事件上报记录编译、部署、检查更新等行为结果可选
热更新下载插件 jar 级别更新,必要时提示重启或重装可选
自定义编译器分发将团队自定义编译器 jar 下发给指定项目按需实现
远端机器申请在 IDE 内引导用户申请远端编译机器并回填配置可选,通常依赖团队内部平台

插件侧调用模型 ​

text
Android Studio 启动或用户手动检查更新
  -> Jugg 请求后台检查版本和项目配置
  -> 后台返回通知、升级入口和 customConfigJson
  -> 插件应用项目默认配置

日常编译、部署
  -> 插件按需上报事件

热更新检查
  -> 后台返回目标版本、更新说明和 jar 文件列表
  -> 插件下载缺失文件并校验 md5
  -> 根据结果提示继续使用、重启 IDE 或重新安装

推荐阅读顺序 ​

  1. 自建接入清单:先实现最小可用后台。
  2. 项目配置下发:按项目维护 Jugg 默认配置。
  3. 插件分发与热更新:提供完整插件包下载或热更新。
  4. 诊断上报:收集使用情况事件。
  5. 远端机器申请:接入团队内部云开发机申请流程。

相关页面 ​