Gloom 中文文档 下载 App

Debug 包与其他 Gloom 版本冲突 — 包名后缀区分

为什么会有包名差异

Android 用包名(Package Name,又称 Application ID)作为每个应用的唯一标识。两个包名不同的应用可以在同一台手机上共存,互不影响。

Gloom 的不同构建版本用了不同的包名:

构建版本包名
MateriiApps 官方 release 构建com.materii.gloom(或类似纯净名)
MateriiApps 官方 debug 构建com.materii.gloom.debug(带 .debug 后缀)
其他 fork 版本com.xxx.gloom(不同前缀)
本项目分发的版本默认 debug 构建

场景一:已有 release 包,想装 debug 包

可以直接装,两者包名不同(com.materii.gloom vs com.materii.gloom.debug),互不覆盖。安装完成后桌面会有两个 Gloom 图标——一个是旧 release,一个是新 debug。

数据也不共享——每个包名有自己独立的应用数据目录,登录状态、缓存、Star 操作记录都是各自独立的。

场景二:手机上有另一个 fork 版本

同样,fork 版本的包名前缀不同(比如 com.appteka.gloom),和 MateriiApps 官方包共存。数据也独立。

场景三:想从 debug 升级到新版 debug

不能原地升级——Android 要求升级应用必须包名和签名都一致。如果新版 debug 包签名和旧版不同(取决于构建者用的 signing key),原地安装会报「应用未安装」。

处理方式:

  1. 先卸掉旧版 Gloom(桌面图标长按 → 卸载)
  2. 安装新版 Gloom
  3. 注意:卸掉旧版会清除旧版的登录状态和缓存数据

场景四:手机上已有同名不同签名的包

极少见,但可能发生——比如你之前装过一个签名不同的 debug 包,现在换了另一个来源的 debug 包,两者包名碰巧一样。这种情况 Android 会拦住安装,提示「应用未安装」。

处理方式:卸掉旧包再装新包。

推荐的共存策略

如果你确实需要同时用多个 Gloom 版本:

但大多数用户不需要共存——只装最新的 debug 包就行。MateriiApps 的 nightly debug 构建频率比 release 高很多,debug 包反而更"新"。

怎么看当前装的是哪个版本

在 Gloom 里找「关于」页面(通常在侧边菜单 → About),里面会显示版本号、构建时间、包名等信息。如果写着包名含 .debug,那就是 debug 构建。

也可以在 Android 设置 → 应用 → Gloom → 详情页里看到包名。