Skip to content

系统集成

InstallerX 可以作为普通应用、锁定后的默认安装器,或高级用户使用的系统包管理器运行。可用能力取决于 ROM、Android 版本和授权器。

默认安装器

锁定为默认安装器后,InstallerX 可以接管大多数来自文件管理器、浏览器和其他应用的 APK 安装请求。当前版本中,默认安装器相关操作从首页的状态卡进入。

在首页点击默认安装器状态卡后,可以进入 默认安装器 页面。该页面包含:

  • 自动锁定安装器: 在开始安装时自动尝试将 InstallerX 设置为默认安装器。
  • 锁定为默认安装器: 手动执行锁定操作。
  • 清除锁定默认安装器: 清除默认安装器锁定。清除时建议使用与锁定时相同的授权器。
  • 已启用 LSPosed 模块: 如果已经通过第三方 LSPosed 模块强制接管默认安装器,可以开启此项停用应用内状态检测。
  • InxLocker 入口: 页面提供推荐锁定器模块的链接,便于在受限 ROM 上完成接管。

部分请求无法直接接管,例如发起方指定了具体组件、使用安装会话,或被 OEM 安装器强制接管。

LSPosed 与 InxLocker

部分 ROM 不允许第三方应用真正成为默认安装器。这种情况下,需要 LSPosed 模块拦截安装 intent 并转发给 InstallerX。

推荐使用 InxLocker。如果你已经通过 LSPosed 模块接管安装器,可以在 InstallerX 中开启对应开关,让首页激活状态按模块接管结果显示。

系统包管理器模式

高级用户可以让 InstallerX 以系统包管理器身份运行,用来替换系统原有的包安装器。这是高风险操作,适合已经理解系统分区、模块挂载和包名匹配规则的用户。

常见安装方式有三种:

  • 核心破解后覆盖安装 APK: 适合已经使用 Core Patch 或类似框架、并确认系统允许覆盖系统安装器的环境。如果原系统包管理器的 versionCode 高于 InstallerX 当前包,系统可能在重启后还原原应用;这种情况下需要同步处理版本号。
  • 制作成模块刷入: 更适合长期使用。稳定版发布时,Telegram 频道通常会同步提供可刷入模块包;也可以 fork 项目后使用 GitHub Actions 自行构建对应模块。
  • 打包进 super 或 ROM 内置: 适合 ROM 制作者或熟悉镜像打包流程的用户。将匹配包名的 InstallerX 直接放入系统镜像,并随 ROM 一起刷入或出厂内置。

选择模块或 APK 时,最重要的是包名必须匹配当前 ROM 的系统包管理器:

  • AOSP 版本: com.android.packageinstaller
  • Google 版本: com.google.android.packageinstaller

一般参考:

  • 国行小米 / HyperOS: 可在西米露的 系统框架 -> 其他 中开启 “使用原生安装器”,再刷入 AOSP 版本。
  • 国行 OPPO / OnePlus / ColorOS: 通常直接刷入 AOSP 版本。
  • 海外 ROM / Google 系设备: 通常使用 Google 版本。

DANGER

以上只是适用于多数情况的参考,不保证适用于所有 OEM。刷入、打包或内置前,请再次核查自己系统包管理器的包名、系统挂载路径和权限文件是否完全匹配,否则可能卡在第二屏或无法进入系统。

如果你使用 KernelSU,请优先刷入元模块,并关闭 KernelSU 的默认卸载模块功能,避免模块卸载逻辑和系统包管理器替换互相影响。

如果你已经通过模块完成过系统化安装,后续更新通常只需要安装模块内的 APK 即可获得应用更新,不需要每次都重新刷入模块并重启。

当 InstallerX 作为系统包管理器运行时,部分自定义元数据能力,例如自定义安装来源,可能不再可用。

OEM 注意事项

  • HyperOS / MIUI: 安装或更新系统应用时,可能要求声明一个有效系统安装者。InstallerX 可声明兼容包名,并在失败时提供智能建议。
  • ColorOS / OriginOS: 默认安装器锁定经常被限制。直接锁定失败时请配合 InxLocker。
  • 荣耀: 使用 Shizuku 安装时,如果安装卡住,请关闭开发者选项中的 ADB 安装监控。
  • OPPO / OnePlus: 支持时,InstallerX 可以在安装对话框中展示 OEM 附加信息。

后台与通知

通知安装依赖前台服务。若定制 ROM 后台管控严格,安装进度通知卡住时,请将 InstallerX 的后台电量策略设为无限制。

InstallerX 会在安装任务完成后短时间内清理后台服务,因此无限制后台主要是为了兼容严格 ROM。

实时活动与小米超级岛

在支持的 Android 16+ 系统上,InstallerX 可使用原生实时活动通知展示安装进度。已知支持环境包括 ColorOS 16+、OneUI 8.0+、AOSP 16 QPR1+、Pixel 16 QPR1+ 和 HyperOS 3.0.300+。

小米超级岛属于 设置 -> 安装器设置 -> 通知设置 中的通知样式。相关的绕过限制、XMSF 断网时长和外发光选项也在通知设置中,仅建议在明确知道设备影响时调整。

基于 GPL-3.0 协议发布