MCPcopy Index your code
hub / github.com/ALEX5402/NewBlackbox

github.com/ALEX5402/NewBlackbox @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
5,780 symbols 15,475 edges 620 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

BlackBox - Virtual Engine

BlackBox Banner

BlackBox is a virtual engine that allows you to clone and run virtual applications on Android devices without installing APKs. This project works on Android 5.0 to 14.0+ and supports multiple architectures (ARM64, ARMv7, x86).

Overview

This enhanced edition includes bug fixes, stability improvements, and Android 14+ compatibility tailored for modern devices.

Key Features

  • Virtual App Cloning: Run multiple instances of applications.
  • Sandboxed Environment: Isolated process execution.
  • No Root Required: Runs entirely in userspace.
  • Multi-Architecture: Support for 32-bit and 64-bit apps.
  • Device Spoofing: Modify device information for virtual apps.
  • Fake Location: Spoof GPS coordinates.

Requirements

  • Android Version: Android 5.0 (API 21) or higher.
  • RAM: 2GB minimum recommended.
  • Architecture: ARMv7a, ARM64-v8a, x86.

Build Instructions

Prerequisites

  • Android Studio (Arctic Fox or newer)
  • JDK 17
  • Android SDK 34+
  • NDK (Version 29.0.13846066)

Building from Source

# Clone the repository
git clone https://github.com/your-repo/NewBlackbox.git
cd NewBlackbox

# Build Debug APK
./gradlew assembleDebug

# Build Release APK
./gradlew assembleRelease

Integration

To use BlackBox Core in your own project, add the AAR dependency:

dependencies {
    implementation fileTree(dir: "libs", include: ["*.aar"])
}

Refer to Docs.md for detailed API documentation.

Troubleshooting

  • App Crashes: Check logcat for UID mismatches or permission errors.
  • Installation Failures: Verify potential architecture mismatches or storage permissions.
  • Android 15: Ensure you are using the latest build which handles stricter security policies.

Credits

  • Main Developer: ALEX502
  • Original Framework: VirtualApp, VirtualAPK
  • Native Hooks: Dobby, xDL
  • Reflection: BlackReflection, FreeReflection

License

Copyright 2022 BlackBox

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Extension points exported contracts — how you extend this code

RecoveryStrategy (Interface)
(no doc) [10 implementers]
Bcore/src/main/java/top/niunaijun/blackbox/utils/DexFileRecovery.java
RockerListener (Interface)
(no doc)
app/src/main/java/top/niunaijun/blackboxa/widget/RockerView.java
RecoveryStrategy (Interface)
(no doc) [10 implementers]
Bcore/src/main/java/top/niunaijun/blackbox/utils/CrashMonitor.java
BaseActivityLifecycleCallback (Interface)
(no doc)
app/src/main/java/top/niunaijun/blackboxa/app/rocker/BaseActivityLifecycleCallback.kt
ISystemService (Interface)
(no doc) [20 implementers]
Bcore/src/main/java/top/niunaijun/blackbox/core/system/ISystemService.java
Executor (Interface)
(no doc) [10 implementers]
Bcore/src/main/java/top/niunaijun/blackbox/core/system/pm/installer/Executor.java
IInjectHook (Interface)
(no doc) [7 implementers]
Bcore/src/main/java/top/niunaijun/blackbox/fake/hook/IInjectHook.java

Core symbols most depended-on inside this repo

d
called by 823
Bcore/src/main/java/top/niunaijun/blackbox/utils/Slog.java
w
called by 746
Bcore/src/main/java/top/niunaijun/blackbox/utils/Slog.java
get
called by 655
Bcore/src/main/java/black/android/util/Singleton.java
invoke
called by 420
Bcore/src/main/java/top/niunaijun/blackbox/fake/service/libcore/OsStub.java
e
called by 394
Bcore/src/main/java/top/niunaijun/blackbox/utils/Slog.java
contains
called by 356
Bcore/src/main/java/top/niunaijun/blackbox/utils/ArrayUtils.java
getService
called by 251
Bcore/src/main/java/black/android/media/AudioManager.java
equals
called by 220
Bcore/src/main/java/top/niunaijun/blackbox/utils/TrieTree.java

Shape

Method 4,078
Class 1,236
Interface 337
Function 125
Enum 4

Languages

Java92%
Kotlin5%
C++2%
C1%

Modules by API surface

Bcore/src/main/java/top/niunaijun/blackbox/BlackBoxCore.java124 symbols
Bcore/src/main/java/top/niunaijun/blackbox/fake/service/IConnectivityManagerProxy.java118 symbols
Bcore/src/main/java/top/niunaijun/blackbox/core/system/accounts/BAccountManagerService.java103 symbols
Bcore/src/main/java/top/niunaijun/blackbox/fake/service/IActivityManagerProxy.java89 symbols
Bcore/src/main/java/android/content/pm/PackageParser.java81 symbols
Bcore/src/main/java/top/niunaijun/blackbox/fake/service/IAccountManagerProxy.java75 symbols
Bcore/src/main/java/top/niunaijun/blackbox/fake/service/IPackageManagerProxy.java66 symbols
Bcore/src/main/java/top/niunaijun/blackbox/app/BActivityThread.java63 symbols
Bcore/src/main/java/black/android/app/ActivityThread.java63 symbols
Bcore/src/main/java/top/niunaijun/blackbox/fake/delegate/BaseInstrumentationDelegate.java60 symbols
Bcore/src/main/java/top/niunaijun/blackbox/proxy/ProxyService.java59 symbols
Bcore/src/main/java/black/com/android/internal/R.java59 symbols

For agents

$ claude mcp add NewBlackbox \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact