OEM 特定安装错误：HyperOS / Vivo 声明有效安装者、FRP、跨区安装

HyperOS / Vivo：安装系统 app 需要声明有效安装者

现象

HyperOS 或 Vivo / OriginOS 上安装或更新系统应用时，系统弹拦截：

"安装系统 app 需要声明有效安装者"

原因

HyperOS / Vivo 的系统安全策略要求：安装系统应用的那个应用本身也必须是系统应用。普通用户应用（哪怕有 Root / Shizuku）直接装系统应用会被拦。

解决

HyperOS

• InstallerX 在 HyperOS 上启动时会自动给默认配置添加安装者声明 = com.android.shell
• 如果自动声明不生效，手动去配置文件里改：

1. 配置文件 → 安装者声明
2. 填：com.android.shell（推荐）
3. 或试：com.android.fileexplorer（小米文件管理器）、com.android.vending（Google Play）

• 必须用 Shizuku 或 Root——Dhizuku 没有权限修改安装元数据

Vivo / OriginOS

• 默认 shell 声明可能不生效
• 需要填Vivo 应用商店的包名（每个设备可能不同）
• 建议先用包名探查工具找到 Vivo 应用商店的包名再填

智能建议

配置文件里开了智能建议后，安装失败时会弹"声明有效安装者"的建议按钮——点一下自动改成推荐的安装者包名重试。

系统禁止跨区安装

现象

安装某 APK 时系统报告"此应用不支持当前地区"。

原因

ROM 根据构建类型或地区标记阻止该包——比如国行系统装海外版应用、中国大陆 ROM 装 Google Play 特定区域包。

解决

• 无解：这是 ROM 层面的地区策略限制
• 尝试 InstallerX 覆盖安装标记（部分场景下有用）
• 检查应用是否真的被 ROM 策略禁止

FRP 限制：请登录设备原有的谷歌账号

现象

设备处于 FRP（Factory Reset Protection）限制状态，需要完成 Google 账号验证后才能继续。

原因

设备被重置过，但之前绑定的 Google 账号需要先验证。这不是 InstallerX 的问题。

解决

• 完成 FRP 验证流程（登录原 Google 账号）
• 如果原账号无法使用：
• 部分 ROM 提供绕过方式
• 或刷写解锁设备（高风险）

黑名单 / 配置阻止

现象

InstallerX 在到达系统之前就拦截了安装请求——这不是系统安装器的错误，是你自己配置的 InstallerX 安全策略。

原因

• 应用包名命中了黑名单
• SharedUID 命中了黑名单
• 签名不匹配 / 签名未知被拦（配置文件里开了对应策略）
• 配置文件的安装方式设为"忽略"（拦截命中该配置的所有请求）

解决

1. 对话框安装模式：点"智能建议" → 为当前会话临时放行
2. 永久放行：去设置 → 黑名单 → 移除对应条目
3. 智能放行只对当前有效：不会改动配置文件

模块 / 网络 / ZIP 错误