universal-installer - A modern Android app for installing and managing A

项目说明

<di="center">
<img src="fastlane/metadata/android/en-US/images/icon.png" width="128" height="128" alt="Uni Installer Icon">
<h1>Uni Installer</h1>
<p>A modern, powerful Android package manager and sideloading tool for Phones, Android TV, and Wear OS.</p>

<p>
<a href="
<img src=" alt="Latest Release">
</a>
<a href="
<img src=" alt="Downloads">
</a>
<a href="LICENSE">
<img src=" alt="License">
</a>
</p>

<h4>Download</h4>
<p>
<a href="
<img src=" height="55" alt="Google Play">
</a>
<a href="
<img src=" height="55" alt="F-Droid">
</a>
<a href="
<img src=" height="55" alt="IzzyOnDroid">
</a>
<a href="
<img src=" height="55" alt="GitHub Release">
</a>
</p>

<a href=" ·
<a href=" ·
<a href="
</div>

---

Supported Platforms

| Platform | Module | Description |
| :--- | :--- | :--- |
| 📱 Phone & Tablet | :app | Material 3 UI, dynamic colors & spring animations |
| 📺 Android TV | :tv | D-pad na, 10-foot UI with QR code pairing & remote receive |
| ⌚ Wear OS | :wearos | Wear Compose UI for smartwatch package management & install |

---

Supported Formats

Single APK: .apk

Split APK Bundles: .apks, .xapk, .apkm, .apk+

Manual Splits: Merge multiple indi .apk files into a single installation session

Game Data: Automatic extraction & background placement of .obb expansion files

---

Key Features

⚡ Flexible Installation Backends:

- Standard system installer, Shizuku, and Root (libsu). On phones and tablets, Porter can serve the Shizuku engine too.
- Silent install and uninstall without prompts.
- Pri controls: allow downgrade, bypass minimum SDK restrictions, grant permissions, install for all users, and spoof installer package names (Google Play, F-Droid, Aurora Store, Amazon, etc.).

📦 Seamless OBB Support:

- Auto-extracts .obb files from XAPK/APKM archi to Android/obb/<package>/.
- Attach standalone OBB files to APK installs.
- Multi-tier write strategy: Direct I/O, Shizuku, or Storage Access Framework (SAF).

🛡️ Security:

- Automatic SHA-256 hash lookup before install.
- Engine detection breakdown (malicious, suspicious, clean).
- On-demand file upload scan for unindexed packages (up to 650 MB).

🌐 Local Sharing & Send to TV:

- Built-in HTTP server and web dashboard for transferring APKs from PC or mobile browser.
- Push packages directly to Android TV via QR code scanning.
- Optional PIN security for local network access.

🗂️ App Manager:

- Inspect installed user & system apps with rich details (SDK targets, size, permissions, signatures).
- Sort and filter by name, install date, size, or last used time.
- Batch uninstall with detailed status logs.

📥 Remote Downloader & Intake:

- Download APK packages directly from web URLs with download history.
- Deep-link and intent handling to open packages from browsers, messaging apps, and file managers.

---

Tech Stack

UI: Jetpack Compose, Wear Compose, Material 3

Installer Engine: Ackpine & Shizuku (or Porter through its Shizuku-API bridge)

Networking: Ktor

Storage & Async: Room, DataStore, WorkManager

Dependency Injection: Koin

---

Project Structure

---

Building from Source

Prerequisites

Android Studio Ladybug or newer

JDK 17+

Android SDK 36

Build Commands

> Note: The play flavor of :app requires app/src/play/google-services.json (see docs/FIREBASE.md). Without it, build the opensource flavor.

---

Contributing & License

Issues & Requests: GitHub Issues

License: GNU General Public License v3.0 (GPL-3.0)

Maintainer: Nguyen Quang Minh

项目信息

开发语言：Kotlin

Star 数：1520

技术要点

该项目属于病毒分析方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕A modern Android app for installing and managing APK packages with split APK support, silent install via Shizuku, and VirusTotal malware scanning.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。