InstallerX-Revived Documentation

More Expressive InstallerX !

5,814 stars Kotlin Kotlin 1 file · ~9,244 tokens #android#apk#apks#dhizuku#installer#md3#miuix#root
RAW Doc

File: docs/README.md

InstallerX Revived (Community Edition)

English | 简体中文 | Español | 日本語 | Deutsch




A modern and functional Android app installer. (You know some birds are not meant to be caged, their feathers are just too bright.)

Looking for a better app installer? Try InstallerX!

InstallerX Revived is a modern Android package installer and the community-maintained continuation of the original InstallerX project.

It is designed to replace limited stock or OEM package installers with a cleaner interface, broader package support, configurable installation profiles, and privileged workflows through Shizuku, Root, Dhizuku, or the system package manager mode.

Documentation

The full user guide, installation instructions, advanced options, system integration notes, and FAQ are maintained on the documentation site.

Highlights

  • Package formats: APK, APKS, APKM, XAPK, APK files inside ZIP archives, and batch APK installation.
  • Install flows: dialog installation, background notification installation, automatic installation, silent installation when privileges allow it, and Android 16+ Live Activity progress on supported systems.
  • Authorizers:
    • Root: can perform all privileged operations, but may be slower because of cold app_process startup.
    • Shizuku: obtains shell or root capabilities depending on how it is activated, and is usually faster than direct Root.
    • Dhizuku: can perform DevicePolicyManager-based operations such as default installer locking and app installation, but is limited for other privileged tasks.
    • None: is fully limited by the system, but can silently install when InstallerX is running as the system package installer.
  • Profiles: define how installation and uninstallation requests are handled, including install mode, authorizer override, installer/requester metadata, target user, DexOpt, auto-delete behavior, split selection, blacklist policy, and signature gates.
  • System integration: InstallerX can be locked as the default installer from the Home page status card, used with LSPosed modules such as InxLocker, or installed as a replacement system package manager by advanced users.
  • Modern UI: Material 3 Expressive and Miuix interface styles, dark mode, dynamic color, advanced palettes, system icon packs, colorful dialogs, standard notifications, Live Activity, and Xiaomi HyperOS-style island notifications on supported Xiaomi devices.
  • Safety controls: package-name and SharedUID blacklists, signature mismatch and unknown-signature policy gates, permission preview, install flags, and one-time smart suggestions for selected blocked cases.

Supported Android Versions

  • Full support: Android SDK 34 - 37.0
  • Limited support: Android SDK 26 - 33

Limited support means InstallerX may work, but some features can be unavailable or behave differently because of Android framework, OEM, or authorizer limitations.

Downloads

When reporting bugs, please reproduce them on the latest Alpha or CI build whenever possible, because issues in Stable may already be fixed.

InstallerX is now published as a single APK. Network access is controlled by an in-app setting. The release filename continues to include online only for compatibility with older in-app update clients; it no longer identifies a separate build variant.

Building

InstallerX Revived is an Android Gradle project.

Prerequisites

  • JDK 25 with JAVA_HOME configured correctly.
  • Android SDK / Android Studio with the required platform and build tools installed.
  • GitHub Packages credentials for the snapshot miuix dependency.

GitHub Packages Authentication

GitHub Packages requires authentication even for public packages. Add your GitHub username and a classic personal access token with the read:packages scope to your global Gradle properties file:

  • Linux / macOS: ~/.gradle/gradle.properties
  • Windows: %USERPROFILE%\.gradle\gradle.properties
properties
gpr.user=YOUR_GITHUB_USERNAME
gpr.key=YOUR_PERSONAL_ACCESS_TOKEN

Do not commit these credentials to this repository.

Build Commands

For a local debug build:

bash
./gradlew assembleUnstableDebug

For a PR-style test build with a separate application id:

bash
./gradlew assemblePreviewDebug -PAPP_ID="com.rosan.installer.x.revived.test"

Common Questions

Where should I report bugs or ask questions?

Use GitHub Issues for reproducible bugs and concrete feature requests. Good suggestions are welcome. Use GitHub Discussions or the Telegram channel for general questions and compatibility discussion.

Before opening an issue, please read CONTRIBUTING.md for the required logs and reproduction details.

I cannot lock InstallerX as the default installer

Some OEM systems strictly control the default package installer. Open the default installer page from the Home page status card and try locking from there. If the ROM still prevents it, use an LSPosed module such as InxLocker.

HyperOS says installing system apps requires a valid installer

This is an OEM security restriction. InstallerX can declare installer metadata through profiles, and on HyperOS it uses com.android.shell as the default compatibility installer package. Shizuku or Root is required for this workflow; Dhizuku is not enough.

Notification installation progress is stuck

Some ROMs restrict background services aggressively. Set InstallerX to unrestricted background/battery mode if notification installation stalls. InstallerX cleans up its foreground service shortly after the installation task finishes.

How do I replace the system package manager?

This is a high-risk advanced workflow. The short version is: use Core Patch to overwrite the APK, flash a matching module, or integrate the matching package into super / a ROM build. Before flashing or packaging, verify the package name, mount path, and permissions file for your ROM.

See the system integration guide for details: https://wxxsfxyzm.github.io/InstallerX-Revived-Website/guide/system-integration

Localization

Help translate InstallerX Revived on Weblate:

https://hosted.weblate.org/engage/installerx-revived/

License

Copyright (C) iamr0s and InstallerX Revived Contributors

InstallerX Revived is released under the GNU General Public License v3.

If you base your work on InstallerX Revived, you must comply with the open-source license terms of the specific source version you use.

Acknowledgements

This project uses code from, or is based on the implementation of, the following projects:

Star History

File: docs/README_CN.md

InstallerX Revived (Community Edition)

English | 简体中文 | Español | 日本語 | Deutsch




A modern and functional Android app installer. (You know some birds are not meant to be caged, their feathers are just too bright.)

一款应用安装程序，为什么不试试 InstallerX？

InstallerX Revived 是一款现代 Android 软件包安装器，也是原 InstallerX 项目的社区维护续作。

它旨在替代功能受限的原生或 OEM 安装器，提供更完整的包格式支持、更清晰的安装界面、可按来源定制的配置文件，以及基于 Shizuku、Root、Dhizuku 或系统包管理器模式的特权工作流。

文档

完整用户指南、安装说明、高级选项、系统集成和 FAQ 统一维护在文档站。

核心能力

  • 安装包格式： APK、APKS、APKM、XAPK、ZIP 压缩包内 APK，以及批量 APK 安装。
  • 安装流程： 对话框安装、通知栏后台安装、自动安装、具备权限时的静默安装，以及支持系统上的 Android 16+ 实时活动进度。
  • 授权方式：
    • Root： 能以最高权限执行所有特权操作，但冷启动 app_process 时性能通常略弱。
    • Shizuku： 根据激活方式获得 shell 或 root 权限，通常比直接 Root 响应更快。
    • Dhizuku： 受 DevicePolicyManager API 限制，可完成锁定安装器、安装应用等部分操作，但面对其他特权场景能力有限。
    • 无特权： 完全受系统限制，但 InstallerX 作为系统包管理器运行时可以获得静默安装能力。
  • 配置文件： 定义安装和卸载请求如何处理，包括安装模式、授权覆盖、安装者/请求方信息、目标用户、DexOpt、自动删除、分包选择、黑名单策略和签名门禁。
  • 系统集成： 可从首页状态卡进入默认安装器页面完成锁定，必要时配合 InxLocker 等 LSPosed 模块，也可由高级用户作为系统包管理器替换系统安装器。
  • 现代界面： Material 3 Expressive 与 Miuix 两套界面，深色模式、动态取色、高级调色板、系统图标包、多彩对话框、标准通知、实时活动，以及在支持的小米设备上以小米超级岛发送通知。
  • 安全控制： 包名和 SharedUID 黑名单、签名不匹配和未知签名策略门禁、权限预览、安装标志位，以及部分阻止场景的一次性智能建议。

支持版本

  • 完整支持： Android SDK 34 - 37.0
  • 有限支持： Android SDK 26 - 33

有限支持表示 InstallerX 可能可以运行，但部分功能会受到 Android 框架、OEM 系统或授权方式限制。

下载

反馈问题时请尽量使用最新 Alpha 或 CI 版本复现，因为 Stable 中的问题可能已经被修复。

InstallerX 现在只发布一个 APK，联网功能由应用内设置控制。发布文件名继续保留 online 仅用于兼容旧版应用内更新客户端，不再代表独立的构建变体。

构建项目

InstallerX Revived 是 Android Gradle 项目。

环境要求

  • JDK 25，并正确配置 JAVA_HOME。
  • Android SDK / Android Studio，并安装所需平台和构建工具。
  • 用于下载 snapshot miuix 依赖的 GitHub Packages 凭据。

GitHub Packages 认证

GitHub Packages 即使下载公开包也需要认证。请创建一个带有 read:packages 权限的 classic personal access token，并写入全局 Gradle 配置：

  • Linux / macOS: ~/.gradle/gradle.properties
  • Windows: %USERPROFILE%\.gradle\gradle.properties
properties
gpr.user=YOUR_GITHUB_USERNAME
gpr.key=YOUR_PERSONAL_ACCESS_TOKEN

不要把这些凭据提交到仓库中。

构建命令

本地 Debug 构建：

bash
./gradlew assembleUnstableDebug

使用单独应用 ID 的 PR 检查构建：

bash
./gradlew assemblePreviewDebug -PAPP_ID="com.rosan.installer.x.revived.test"

常见问题

应该在哪里反馈问题或提问？

可复现的 bug 和明确的 feature request 请提交到 GitHub Issues，如果有好的建议也欢迎提出。一般问题和兼容性讨论可以使用 GitHub Discussions 或 Telegram 频道。

提交 issue 前请先阅读 CONTRIBUTING.md，并按要求提供日志和复现信息。

无法锁定 InstallerX 为默认安装器？

部分 OEM 系统会严格限制默认安装器。请从首页状态卡进入默认安装器页面后尝试锁定。如果 ROM 仍然阻止锁定，请配合 InxLocker 等 LSPosed 模块使用。

HyperOS 提示安装系统应用需要有效安装者？

这是 OEM 安全限制。InstallerX 可以通过配置文件声明安装者信息，并在 HyperOS 上默认使用 com.android.shell 作为兼容安装者包名。该功能需要 Shizuku 或 Root，Dhizuku 不支持。

通知安装进度卡住？

部分 ROM 对后台服务限制很严格。如果通知安装卡住，请将 InstallerX 的后台电量策略设为无限制。InstallerX 会在安装任务结束后短时间内清理前台服务。

如何替换系统包管理器？

这是高风险高级操作。简要来说，可以在核心破解后覆盖安装 APK，也可以刷入匹配模块，或在打包 super / 制作 ROM 时内置匹配包。刷入或打包前必须确认包名、挂载路径和权限文件与当前 ROM 完全匹配。

详见系统集成文档：https://wxxsfxyzm.github.io/InstallerX-Revived-Website/zh/guide/system-integration

本地化

欢迎通过 Weblate 参与翻译。

开源协议

Copyright (C) iamr0s and InstallerX Revived Contributors

InstallerX Revived 基于 GNU General Public License v3 开源。

如果你基于 InstallerX Revived 进行开发，需要遵循你所使用的具体源码版本对应的开源协议。

致谢

本项目使用了以下项目的代码，或参考了它们的实现：

Star History

File: docs/README_DE.md

InstallerX Revived (Community Edition)

English | 简体中文 | Español | 日本語 | Deutsch




Ein moderner und funktionaler Android-App-Installer. (Manche Vögel sind nicht dafür gemacht, eingesperrt zu werden, ihre Federn sind einfach zu hell.)

Du suchst nach einem besseren App-Installer? Probiere InstallerX.

InstallerX Revived ist ein moderner Android-Paketinstaller und die von der Community gepflegte Fortsetzung des ursprünglichen InstallerX-Projekts.

Er soll eingeschränkte Stock- oder OEM-Installer durch eine klarere Oberfläche, breitere Paketunterstützung, konfigurierbare Installationsprofile und privilegierte Workflows über Shizuku, Root, Dhizuku oder den Systeminstaller-Modus ersetzen.

Dokumentation

Das vollständige Benutzerhandbuch, Installationsanweisungen, erweiterte Optionen, Hinweise zur Systemintegration und die FAQ werden auf der Dokumentationsseite gepflegt.

Hauptfunktionen

  • Paketformate: APK, APKS, APKM, XAPK, APKs in ZIP-Archiven und Batch-Installation von APKs.
  • Installationsabläufe: Dialoginstallation, Hintergrundinstallation per Benachrichtigung, automatische Installation, stille Installation bei ausreichenden Rechten und Android-16+-Live-Activity-Fortschritt auf unterstützten Systemen.
  • Autorisierungsarten:
    • Root: kann alle privilegierten Operationen ausführen, kann aber wegen des kalten Starts von app_process langsamer sein.
    • Shizuku: erhält je nach Aktivierungsart shell- oder rootähnliche Rechte und reagiert meist schneller als direkter Root-Zugriff.
    • Dhizuku: kann DevicePolicyManager-basierte Operationen wie das Fixieren des Standardinstallers und App-Installationen ausführen, ist aber bei anderen privilegierten Aufgaben eingeschränkt.
    • None: ist vollständig durch das System begrenzt, kann aber lautlos installieren, wenn InstallerX als Systeminstaller läuft.
  • Profile: legen fest, wie Installations- und Deinstallationsanfragen verarbeitet werden, einschließlich Installationsmodus, Autorisierer-Override, Installer-/Requester-Metadaten, Zielbenutzer, DexOpt, automatischem Löschen, Split-Auswahl, Sperrlisten und Signaturrichtlinien.
  • Systemintegration: InstallerX kann über die Statuskarte auf der Startseite als Standardinstaller fixiert, mit LSPosed-Modulen wie InxLocker verwendet oder von fortgeschrittenen Nutzern als Ersatz für den Systeminstaller installiert werden.
  • Moderne Oberfläche: Material 3 Expressive und Miuix, Dunkelmodus, dynamische Farben, erweiterte Paletten, System-Icon-Packs, farbige Dialoge, Standardbenachrichtigungen, Live Activity und Xiaomi-HyperOS-ähnliche Island-Benachrichtigungen auf unterstützten Xiaomi-Geräten.
  • Sicherheitskontrollen: Sperrlisten nach Paketname und SharedUID, Richtlinien für Signaturabweichungen und unbekannte Signaturen, Berechtigungsvorschau, Installationsflags und einmalige intelligente Vorschläge für ausgewählte Blockierungen.

Unterstützte Android-Versionen

  • Vollständige Unterstützung: Android SDK 34 - 37.0
  • Eingeschränkte Unterstützung: Android SDK 26 - 33

Eingeschränkte Unterstützung bedeutet, dass InstallerX funktionieren kann, einige Funktionen jedoch wegen Android-Framework-, OEM- oder Autorisierer-Einschränkungen fehlen oder anders arbeiten können.

Downloads

Wenn du Fehler meldest, reproduziere sie bitte nach Möglichkeit mit dem neuesten Alpha- oder CI-Build, da Probleme aus Stable möglicherweise bereits behoben wurden.

InstallerX wird jetzt als eine einzige APK veröffentlicht. Der Netzwerkzugriff wird über eine Einstellung in der App gesteuert. Der Dateiname der Veröffentlichung enthält nur zur Kompatibilität mit älteren In-App-Update-Clients weiterhin online; er kennzeichnet keine separate Build-Variante mehr.

Build

InstallerX Revived ist ein Android-Gradle-Projekt.

Voraussetzungen

  • JDK 25 mit korrekt gesetztem JAVA_HOME.
  • Android SDK / Android Studio mit den benötigten Plattformen und Build-Tools.
  • GitHub-Packages-Zugangsdaten für die Snapshot-Abhängigkeit miuix.

GitHub-Packages-Authentifizierung

GitHub Packages erfordert auch für öffentliche Pakete eine Authentifizierung. Füge deinen GitHub-Benutzernamen und ein klassisches personal access token mit dem Scope read:packages in deine globale Gradle-Properties-Datei ein:

  • Linux / macOS: ~/.gradle/gradle.properties
  • Windows: %USERPROFILE%\.gradle\gradle.properties
properties
gpr.user=YOUR_GITHUB_USERNAME
gpr.key=YOUR_PERSONAL_ACCESS_TOKEN

Committe diese Zugangsdaten nicht in dieses Repository.

Build-Befehle

Lokaler Debug-Build:

bash
./gradlew assembleUnstableDebug

PR-Testbuild mit separater App-ID:

bash
./gradlew assemblePreviewDebug -PAPP_ID="com.rosan.installer.x.revived.test"

Häufige Fragen

Wo melde ich Fehler oder stelle Fragen?

Nutze GitHub Issues für reproduzierbare Bugs und konkrete Feature Requests. Gute Vorschläge sind ebenfalls willkommen. Nutze GitHub Discussions oder den Telegram-Kanal für allgemeine Fragen und Kompatibilitätsdiskussionen.

Lies vor dem Öffnen eines Issues CONTRIBUTING.md, um die erforderlichen Logs und Reproduktionsdetails bereitzustellen.

InstallerX lässt sich nicht als Standardinstaller fixieren

Einige OEM-Systeme kontrollieren den Standard-Paketinstaller sehr streng. Öffne die Seite des Standardinstallers über die Statuskarte auf der Startseite und versuche es dort. Wenn die ROM es weiterhin verhindert, nutze ein LSPosed-Modul wie InxLocker.

HyperOS meldet, dass System-App-Installationen einen gültigen Installer benötigen

Das ist eine OEM-Sicherheitsbeschränkung. InstallerX kann Installer-Metadaten über Profile deklarieren und verwendet unter HyperOS com.android.shell als Standard-Kompatibilitätsinstallerpaket. Dieser Workflow erfordert Shizuku oder Root; Dhizuku reicht nicht aus.

Der Fortschritt der Benachrichtigungsinstallation bleibt hängen

Einige ROMs beschränken Hintergrunddienste sehr aggressiv. Setze InstallerX auf uneingeschränkte Hintergrund-/Akkunutzung, wenn die Benachrichtigungsinstallation hängen bleibt. InstallerX räumt seinen Vordergrunddienst kurz nach Abschluss der Installation auf.

Wie ersetze ich den Systeminstaller?

Das ist ein risikoreicher Workflow für fortgeschrittene Nutzer. Kurz gesagt: Verwende Core Patch, um das APK zu überschreiben, flashe ein passendes Modul oder integriere das passende Paket in super / einen ROM-Build. Prüfe vor dem Flashen oder Packen Paketnamen, Mount-Pfad und Berechtigungsdatei deiner ROM.

Siehe die Anleitung zur Systemintegration: https://wxxsfxyzm.github.io/InstallerX-Revived-Website/guide/system-integration

Lokalisierung

Hilf mit, InstallerX Revived auf Weblate zu übersetzen.

Lizenz

Copyright (C) iamr0s and InstallerX Revived Contributors

InstallerX Revived wird unter der GNU General Public License v3 veröffentlicht.

Wenn du deine Arbeit auf InstallerX Revived stützt, musst du die Open-Source-Lizenzbedingungen der konkret verwendeten Quellversion einhalten.

Danksagungen

Dieses Projekt verwendet Code aus folgenden Projekten oder basiert auf deren Implementierung:

Star History

File: docs/README_ES.md

InstallerX Revived (Community Edition)

English | 简体中文 | Español | 日本語 | Deutsch




Un instalador de aplicaciones Android moderno y funcional. (Sabes que algunos pájaros no están hechos para estar enjaulados, sus plumas son demasiado brillantes.)

¿Buscas un mejor instalador de aplicaciones? Prueba InstallerX.

InstallerX Revived es un instalador moderno de paquetes Android y la continuación mantenida por la comunidad del proyecto original InstallerX.

Está diseñado para reemplazar instaladores stock u OEM limitados con una interfaz más clara, soporte de paquetes más amplio, perfiles de instalación configurables y flujos privilegiados mediante Shizuku, Root, Dhizuku o el modo de instalador del sistema.

Documentación

La guía de usuario completa, instrucciones de instalación, opciones avanzadas, notas de integración del sistema y FAQ se mantienen en el sitio de documentación.

Capacidades principales

  • Formatos de paquete: APK, APKS, APKM, XAPK, APK dentro de ZIP e instalación por lotes.
  • Flujos de instalación: instalación por diálogo, instalación en segundo plano con notificación, instalación automática, instalación silenciosa cuando los privilegios lo permiten y progreso Live Activity en Android 16+ en sistemas compatibles.
  • Autorizadores:
    • Root: puede ejecutar todas las operaciones privilegiadas, pero puede ser más lento por el arranque en frío de app_process.
    • Shizuku: obtiene capacidades shell o root según su modo de activación, y normalmente responde más rápido que Root directo.
    • Dhizuku: puede realizar operaciones basadas en DevicePolicyManager, como bloquear el instalador predeterminado e instalar aplicaciones, pero está limitado en otras tareas privilegiadas.
    • None: queda completamente limitado por el sistema, pero puede instalar silenciosamente cuando InstallerX funciona como instalador del sistema.
  • Perfiles: definen cómo se procesan las solicitudes de instalación y desinstalación, incluido el modo de instalación, override del autorizador, metadatos de instalador/solicitante, usuario de destino, DexOpt, borrado automático, selección de splits, listas negras y reglas de firma.
  • Integración del sistema: InstallerX puede fijarse como instalador predeterminado desde la tarjeta de estado de la pantalla principal, usarse con módulos LSPosed como InxLocker, o instalarse como reemplazo del instalador del sistema para usuarios avanzados.
  • Interfaz moderna: Material 3 Expressive y Miuix, modo oscuro, color dinámico, paletas avanzadas, paquetes de iconos del sistema, diálogos con color, notificaciones estándar, Live Activity y notificaciones estilo isla de Xiaomi HyperOS en dispositivos Xiaomi compatibles.
  • Controles de seguridad: listas negras por nombre de paquete y SharedUID, reglas para firma no coincidente o desconocida, vista previa de permisos, flags de instalación y sugerencias inteligentes de un solo uso para algunos bloqueos.

Versiones de Android compatibles

  • Soporte completo: Android SDK 34 - 37.0
  • Soporte limitado: Android SDK 26 - 33

Soporte limitado significa que InstallerX puede funcionar, pero algunas funciones pueden no estar disponibles o comportarse de forma distinta por limitaciones de Android, OEM o el autorizador.

Descargas

Al reportar errores, intenta reproducirlos con la versión Alpha o CI más reciente siempre que sea posible, porque el problema puede estar ya corregido respecto a Stable.

InstallerX se publica ahora como un único APK. El acceso a la red se controla mediante un ajuste dentro de la aplicación. El nombre del archivo publicado conserva online únicamente por compatibilidad con clientes antiguos de actualización dentro de la aplicación; ya no identifica una variante de compilación independiente.

Compilación

InstallerX Revived es un proyecto Android Gradle.

Requisitos previos

  • JDK 25 con JAVA_HOME configurado correctamente.
  • Android SDK / Android Studio con la plataforma y herramientas de compilación necesarias.
  • Credenciales de GitHub Packages para la dependencia snapshot miuix.

Autenticación de GitHub Packages

GitHub Packages requiere autenticación incluso para paquetes públicos. Añade tu usuario de GitHub y un token personal clásico con el scope read:packages al archivo global de propiedades de Gradle:

  • Linux / macOS: ~/.gradle/gradle.properties
  • Windows: %USERPROFILE%\.gradle\gradle.properties
properties
gpr.user=YOUR_GITHUB_USERNAME
gpr.key=YOUR_PERSONAL_ACCESS_TOKEN

No confirmes estas credenciales en este repositorio.

Comandos de compilación

Para una compilación debug local:

bash
./gradlew assembleUnstableDebug

Para una compilación de prueba estilo PR con un identificador de aplicación separado:

bash
./gradlew assemblePreviewDebug -PAPP_ID="com.rosan.installer.x.revived.test"

Preguntas comunes

¿Dónde debo reportar errores o hacer preguntas?

Usa GitHub Issues para bugs reproducibles y feature requests concretas. Las buenas sugerencias también son bienvenidas. Usa GitHub Discussions o el canal de Telegram para preguntas generales y discusiones de compatibilidad.

Antes de abrir un issue, lee CONTRIBUTING.md para conocer los logs y detalles de reproducción requeridos.

No puedo fijar InstallerX como instalador predeterminado

Algunos sistemas OEM controlan estrictamente el instalador predeterminado. Abre la página del instalador predeterminado desde la tarjeta de estado de la pantalla principal e intenta fijarlo allí. Si la ROM todavía lo impide, usa un módulo LSPosed como InxLocker.

HyperOS dice que instalar aplicaciones del sistema requiere un instalador válido

Es una restricción de seguridad del OEM. InstallerX puede declarar metadatos de instalador mediante perfiles, y en HyperOS usa com.android.shell como paquete instalador de compatibilidad predeterminado. Este flujo requiere Shizuku o Root; Dhizuku no es suficiente.

El progreso de instalación por notificación se queda atascado

Algunas ROM restringen agresivamente los servicios en segundo plano. Configura InstallerX sin restricciones de batería/segundo plano si la instalación por notificación se atasca. InstallerX limpia su servicio en primer plano poco después de terminar la instalación.

¿Cómo reemplazo el instalador del sistema?

Es un flujo avanzado de alto riesgo. En resumen: usa Core Patch para sobrescribir el APK, flashea un módulo compatible o integra el paquete correspondiente en super / una compilación de ROM. Antes de flashear o empaquetar, verifica el nombre de paquete, la ruta de montaje y el archivo de permisos de tu ROM.

Consulta la guía de integración del sistema: https://wxxsfxyzm.github.io/InstallerX-Revived-Website/guide/system-integration

Localización

Ayuda a traducir InstallerX Revived en Weblate.

Licencia

Copyright (C) iamr0s and InstallerX Revived Contributors

InstallerX Revived se publica bajo la GNU General Public License v3.

Si basas tu trabajo en InstallerX Revived, debes cumplir los términos de la licencia de código abierto de la versión específica del código fuente que uses.

Agradecimientos

Este proyecto usa código de, o se basa en la implementación de, los siguientes proyectos:

Star History

File: docs/README_JA.md

InstallerX Revived (Community Edition)

English | 简体中文 | Español | 日本語 | Deutsch




モダンで機能的な Android アプリインストーラー。（鳥の中には、檻に入れるべきではないものもいます。その羽はあまりにも鮮やかだからです。）

より良いアプリインストーラーを探していますか？ InstallerX を試してみてください。

InstallerX Revived は、モダンな Android パッケージインストーラーであり、元の InstallerX プロジェクトをコミュニティで継続しているものです。

制限の多い標準または OEM インストーラーを置き換え、より分かりやすい UI、幅広いパッケージ形式、設定可能なインストールプロファイル、Shizuku / Root / Dhizuku / システムインストーラーモードによる特権ワークフローを提供します。

ドキュメント

完全なユーザーガイド、インストール手順、高度なオプション、システム統合の注意事項、FAQ は ドキュメントサイト で管理されています。

主な機能

  • パッケージ形式: APK、APKS、APKM、XAPK、ZIP 内 APK、一括 APK インストール。
  • インストール方式: ダイアログ、バックグラウンド通知、自動インストール、権限がある場合のサイレントインストール、対応システムでの Android 16+ Live Activity 進捗表示。
  • 認可方式:
    • Root: すべての特権操作を実行できますが、app_process のコールドスタートにより遅くなる場合があります。
    • Shizuku: 起動方式に応じて shell または root 相当の権限を取得し、通常は直接 Root より高速です。
    • Dhizuku: DevicePolicyManager ベースの操作、たとえばデフォルトインストーラーの固定やアプリのインストールを実行できますが、その他の特権操作には制限があります。
    • None: 完全にシステムの制限を受けますが、InstallerX がシステムインストーラーとして動作している場合はサイレントインストールできます。
  • プロファイル: インストール/アンインストール要求の処理方法を定義します。インストールモード、認可方式の上書き、インストーラー/要求元メタデータ、対象ユーザー、DexOpt、自動削除、split 選択、ブラックリスト、署名ポリシーを含みます。
  • システム統合: ホーム画面のステータスカードからデフォルトインストーラーとして固定でき、InxLocker などの LSPosed モジュールと併用できます。上級者はシステムインストーラーの置き換えとしても導入できます。
  • モダン UI: Material 3 Expressive と Miuix、ダークモード、動的カラー、高度なパレット、システムアイコンパック、カラフルなダイアログ、標準通知、Live Activity、対応 Xiaomi デバイスでの Xiaomi HyperOS 風アイランド通知。
  • 安全制御: パッケージ名/SharedUID ブラックリスト、署名不一致/不明署名ポリシー、権限プレビュー、インストールフラグ、一部のブロックに対する一回限りのスマート提案。

対応 Android バージョン

  • 完全サポート: Android SDK 34 - 37.0
  • 限定サポート: Android SDK 26 - 33

限定サポートでは InstallerX が動作する可能性はありますが、Android フレームワーク、OEM、認可方式の制限により一部機能が使えない、または異なる挙動になる場合があります。

ダウンロード

不具合を報告する場合は、Stable では既に修正済みの可能性があるため、可能な限り最新の Alpha または CI ビルドで再現してください。

InstallerX は現在、単一の APK として公開されています。ネットワークアクセスはアプリ内設定で制御されます。公開ファイル名の online は古いアプリ内更新クライアントとの互換性のためだけに残されており、独立したビルドバリアントを示すものではありません。

ビルド

InstallerX Revived は Android Gradle プロジェクトです。

前提条件

  • JDK 25 と正しく設定された JAVA_HOME。
  • 必要な platform と build tools を含む Android SDK / Android Studio。
  • snapshot miuix 依存関係用の GitHub Packages 認証情報。

GitHub Packages 認証

GitHub Packages は公開パッケージでも認証が必要です。read:packages scope を持つ classic personal access token と GitHub ユーザー名をグローバル Gradle properties に追加してください:

  • Linux / macOS: ~/.gradle/gradle.properties
  • Windows: %USERPROFILE%\.gradle\gradle.properties
properties
gpr.user=YOUR_GITHUB_USERNAME
gpr.key=YOUR_PERSONAL_ACCESS_TOKEN

これらの認証情報をこのリポジトリにコミットしないでください。

ビルドコマンド

ローカル debug ビルド:

bash
./gradlew assembleUnstableDebug

別のアプリ ID を使う PR 向けテストビルド:

bash
./gradlew assemblePreviewDebug -PAPP_ID="com.rosan.installer.x.revived.test"

よくある質問

不具合報告や質問はどこで行えばよいですか？

再現可能な不具合や具体的な feature request は GitHub Issues に投稿してください。良い提案も歓迎します。一般的な質問や互換性に関する相談は GitHub Discussions または Telegram チャンネル を利用してください。

Issue を作成する前に、必要なログと再現情報について CONTRIBUTING.md を読んでください。

InstallerX をデフォルトインストーラーとして固定できない

一部の OEM システムはデフォルトインストーラーを厳しく制御します。ホーム画面のステータスカードからデフォルトインストーラーページを開き、そこで固定を試してください。ROM がまだ阻止する場合は、InxLocker などの LSPosed モジュールを使用してください。

HyperOS でシステムアプリのインストールに有効なインストーラーが必要と表示される

これは OEM のセキュリティ制限です。InstallerX はプロファイルを通じてインストーラーメタデータを宣言でき、HyperOS では互換用のデフォルトインストーラーパッケージとして com.android.shell を使用します。このワークフローには Shizuku または Root が必要で、Dhizuku では不十分です。

通知インストールの進捗が止まる

一部の ROM はバックグラウンドサービスを厳しく制限します。通知インストールが止まる場合は、InstallerX のバックグラウンド/バッテリー制限を解除してください。InstallerX はインストール完了後すぐにフォアグラウンドサービスを整理します。

システムインストーラーを置き換えるには？

これは高リスクな上級者向けワークフローです。概要としては、Core Patch で APK を上書きする、対応モジュールをフラッシュする、または該当パッケージを super / ROM ビルドに組み込みます。フラッシュや組み込みの前に、ROM のパッケージ名、マウントパス、権限ファイルを確認してください。

詳細はシステム統合ガイドを参照してください: https://wxxsfxyzm.github.io/InstallerX-Revived-Website/guide/system-integration

ローカライズ

Weblate で InstallerX Revived の翻訳に協力できます。

ライセンス

Copyright (C) iamr0s and InstallerX Revived Contributors

InstallerX Revived は GNU General Public License v3 の下で公開されています。

InstallerX Revived を基に作業する場合、使用する特定のソースバージョンのオープンソースライセンス条件に従う必要があります。

謝辞

このプロジェクトは、以下のプロジェクトのコードを使用、または実装を参考にしています:

Star History

Explore Related Technologies & Topics

View All 9,111+ Repositories →

Discover similar high-velocity repositories, agent skills, and OpenAPI specifications across the ecosystem.

#android Browse android catalog → #apk Browse apk catalog → #apks Browse apks catalog → #dhizuku Browse dhizuku catalog → #installer Browse installer catalog → #md3 Browse md3 catalog → ⚡ MCP Servers Model Context Protocol → 🧠 Agent Skills Prompt & rule files → 🔌 OpenAPI Specs REST & Swagger schemas →