How alex5402/newblackbox works
BlackBox is an Android userspace virtualization engine for installing and running isolated app instances without installing their APKs on the host. The principal workflow is to register an app package, resolve virtual package metadata, allocate a sandbox process, and launch the app through Android compatibility and proxy mechanisms. The repository also includes a management app, fake-location and Google Mobile Services screens, device-spoofing hooks, and a reflection layer. Edges are limited to README claims and relationships visible in the supplied excerpts or SOURCE INDEX; many implementation details were not sampled.
Main entry points: BlackBoxCore.java Core facade · BProcessManagerService.java Process management · FakeManagerActivity.kt Fake location UI · BPackageManagerService.java Package management
Components 20
Host management app
- App management UI
app/src/main/java/top/niunaijun/blackboxa/view/apps/AppsFragment.kt - App manager
app/src/main/java/top/niunaijun/blackboxa/app/AppManager.kt - Fake location UI
app/src/main/java/top/niunaijun/blackboxa/view/fake/FakeManagerActivity.kt - Location repository
app/src/main/java/top/niunaijun/blackboxa/data/FakeLocationRepository.kt - GMS manager UI
app/src/main/java/top/niunaijun/blackboxa/view/gms/GmsManagerActivity.kt - GMS repository
app/src/main/java/top/niunaijun/blackboxa/data/GmsRepository.kt
Virtual app runtime
- Core facade
Bcore/src/main/java/top/niunaijun/blackbox/BlackBoxCore.java - Package management
Bcore/src/main/java/top/niunaijun/blackbox/core/system/pm/BPackageManagerService.java - Process management
Bcore/src/main/java/top/niunaijun/blackbox/core/system/BProcessManagerService.java - Process record
Bcore/src/main/java/top/niunaijun/blackbox/core/system/ProcessRecord.java - Sandbox environment
Bcore/src/main/java/top/niunaijun/blackbox/core/env/BEnvironment.java - Activity management
Bcore/src/main/java/top/niunaijun/blackbox/core/system/am/BActivityManagerService.java - Virtual storage
Bcore/src/main/java/top/niunaijun/blackbox/core/system/os/BStorageManagerService.java
Android compatibility
- Framework shims
Bcore/src/main/java/black/android - Native hooks
Bcore/src/main/cpp/Hook - Reflection access
black-reflection/src/main/java/top/niunaijun/blackreflection
Virtual features
- Fake location service
Bcore/src/main/java/top/niunaijun/blackbox/core/system/location - Device spoofing
Bcore/src/main/cpp/Utils/VirtualSpoof.cpp - GMS support
Bcore/src/main/java/top/niunaijun/blackbox/core/GmsCore.java
Other components
- Device user
Connections 20
- Device user → App management UI: manages apps
README.md - App management UI → App manager: requests app actions
- Device user → Fake location UI: sets location
README.md - Fake location UI → Location repository: updates location
- Fake location UI → Fake location service: configures location
app/src/main/java/top/niunaijun/blackboxa/view/fake/FakeManagerActivity.kt - Device user → GMS manager UI: manages GMS
- GMS manager UI → GMS repository: loads GMS data
app/src/main/java/top/niunaijun/blackboxa/view/gms/GmsManagerActivity.kt - App manager → Core facade: uses engine
app/src/main/java/top/niunaijun/blackboxa/app/AppManager.kt - Core facade → Package management: queries packages
Bcore/src/main/java/top/niunaijun/blackbox/core/system/pm/BPackageManagerService.java - Package management → Process management: starts or kills
Bcore/src/main/java/top/niunaijun/blackbox/core/system/pm/BPackageManagerService.java - Process management → Package management: resolves app info
Bcore/src/main/java/top/niunaijun/blackbox/core/system/BProcessManagerService.java - Process management → Process record: tracks process
Bcore/src/main/java/top/niunaijun/blackbox/core/system/BProcessManagerService.java - Process management → Sandbox environment: initializes sandbox
Bcore/src/main/java/top/niunaijun/blackbox/core/system/BProcessManagerService.java - Core facade → Activity management: coordinates activities
Bcore/src/main/java/top/niunaijun/blackbox/BlackBoxCore.java - Core facade → Virtual storage: exposes storage
Bcore/src/main/java/top/niunaijun/blackbox/core/system/os/BStorageManagerService.java - Framework shims → Reflection access: uses reflected APIs
Bcore/src/main/java/black/android/os/storage/StorageManager.java - Native hooks → Framework shims: intercepts runtime
- Core facade → Device spoofing: spoofs device data
README.md - Core facade → Fake location service: supports fake GPS
README.md - Core facade → GMS support: supports GMS
Bcore/src/main/java/top/niunaijun/blackbox/BlackBoxCore.java