"The only people who have anything to fear from free software are those whose products are worth even less."
π― Enhanced Edition by ALEX502
Comprehensive bug fixes, security improvements, and performance optimizations
BlackBox is a powerful virtual engine that enables you to clone, run, and manage virtual applications on Android devices without requiring installation of APK files. This enhanced edition includes comprehensive bug fixes, security improvements, and performance optimizations.
- π± Virtual App Cloning: Run multiple instances of the same app simultaneously
- π Sandboxed Environment: Complete isolation with enhanced security
- π― No Root Required: Works on unrooted devices
- β‘ High Performance: Optimized for speed and stability
- π‘οΈ Xposed Support: Hidden Xposed framework with anti-detection
- π§ Advanced API: Comprehensive developer interface
- π Multi-Architecture: Supports ARM64, ARMv7, and x86
- π Fake Location: GPS spoofing capabilities
- π App Management: Complete control over virtual applications
- Primary Support: Android 5.0 (API 21) ~ Android 15.0 (API 35)
- Optimized For: Android 8.0+ for best performance
- Legacy Support: Android 4.x not supported
- RAM: Minimum 2GB, Recommended 4GB+
- Storage: 100MB+ free space
- Architecture: ARM64-v8a, ARMv7a, or x86
- Permissions: Storage access required
- For optimal compatibility, consider targeting SDK 28 or below
- Enhanced security handling for Android 15 and MIUI devices
- Special optimizations for tablet devices
- Comprehensive UID management for sandboxed environments
β οΈ Important: This software is designed for educational and research purposes. While extensively tested and improved, use responsibly and in accordance with applicable laws.
- ARM64-v8a: Primary architecture for modern 64-bit devices
- ARMv7a: Legacy 32-bit ARM devices
- x86: Intel-based Android devices (emulators, tablets)
Note: This project generates separate builds for different architectures. If you cannot find your target application, try using the build for your device's specific architecture.
- App Module: User interface and interaction handling (Kotlin)
- Bcore Module: Core virtual engine functionality (Java/Kotlin)
- Native Core: Low-level system integration
- JAR System: Enhanced JAR file management with integrity verification
- Compile SDK: Android API 35
- Target SDK: Android API 34
- Min SDK: Android API 24
- NDK: Version 29.0.13846066
- JVM Target: Java 17
- Build Tools: Gradle with Kotlin DSL
- π Stable Release: Production-ready versions verified by administrators
- π Canary Builds: Latest features with automatic CI/CD
- Canary Downloads
- Features cutting-edge improvements but may contain bugs
- Current Version: 2.0-r1beta
- Version Code: 2
- Release Type: Beta with comprehensive improvements
This enhanced edition includes numerous critical fixes and improvements:
- β APK Path Resolution: Fixed I/O errors with missing APK files through intelligent path discovery
- β Security Exceptions: Resolved UID mismatch crashes on Android 15 and MIUI devices
- β Compilation Errors: Fixed missing variable references and method signatures
- β Freezing Issues: Eliminated NullPointerException errors causing app freezes
- β Resource Loading: Enhanced app icon and label loading with fallback mechanisms
- β Context Creation: Improved package context creation with multiple fallback strategies
- β‘ JAR System: Complete overhaul with caching, integrity verification, and async operations
- β‘ Memory Management: Memory-aware buffer sizing and optimized resource usage
- β‘ Error Handling: Comprehensive error recovery with retry mechanisms
- β‘ UID Management: Enhanced UID resolution for sandboxed environments
- β‘ File Operations: Atomic operations with progress tracking
- π Enhanced Sandboxing: Better isolation with improved security boundaries
- π UID Security: Robust handling of UID mismatches in various environments
- π File Integrity: SHA-256 verification for JAR files and critical components
- π Fallback Safety: Safe fallback mechanisms preventing security breaches
- π± Android 15: Full support with security restriction handling
- π± MIUI Devices: Special optimizations for Xiaomi devices
- π± Tablet Support: Enhanced compatibility for tablet form factors
- π± Architecture: Improved multi-architecture support (ARM64, ARMv7, x86)
Phase | Android Support | Major Features | Critical Fixes |
---|---|---|---|
π Phase 1 Core Stability |
|
|
|
β‘ Phase 2 Performance |
|
|
|
π‘οΈ Phase 3 Security |
|
|
|
π― Phase 4 Modern Support |
|
|
|
Android Version | API Level | Support Status | Key Features | Special Notes |
---|---|---|---|---|
π€ Android 5.0-5.1 | 21-22 | β Supported | Basic virtualization, App cloning | Minimum supported version |
π€ Android 6.0 | 23 | β Supported | Runtime permissions, Enhanced security | Permission model updates |
π€ Android 7.0-7.1 | 24-25 | β Supported | Multi-window, File-based encryption | Multi-window compatibility |
π€ Android 8.0-8.1 | 26-27 | β Optimized | Background limits, Notification channels | Background execution optimized |
π€ Android 9.0 | 28 | β Recommended | Private API restrictions, Neural Networks | Best compatibility target |
π€ Android 10.0 | 29 | β Optimized | Scoped storage, Dark theme | Scoped storage handled |
π€ Android 11.0 | 30 | β Optimized | One-time permissions, Bubbles | Enhanced privacy support |
π€ Android 12.0 | 31 | β Optimized | Material You, Privacy dashboard | Material Design 3 support |
π€ Android 13.0 | 33 | β Enhanced | Themed icons, Per-app languages | Granular permissions |
π€ Android 14.0 | 34 | β Enhanced | Predictive back, Partial photo access | Target SDK version |
π€ Android 15.0 | 35 | β Fully Supported | Enhanced security, Edge-to-edge | Latest security fixes included |
- π§ Core Virtual Engine - Complete application virtualization
- π± Multi-App Cloning - Run multiple instances simultaneously
- π Enhanced Sandboxing - Isolated execution environments
- π‘οΈ Xposed Integration - Hidden framework with anti-detection
- π Multi-Architecture - ARM64, ARMv7, x86 support
- π Location Spoofing - GPS coordinate manipulation
- β‘ Performance Optimization - Memory and CPU optimizations
- π Security Hardening - UID management and permission handling
- π Advanced APIs - Comprehensive developer interfaces
- π§ APK Path Resolution - Intelligent fallback mechanisms
- π‘οΈ Security Exception Handling - Robust error recovery
- β‘ JAR System - Complete overhaul with integrity verification
- π Async Operations - Non-blocking initialization
- πΎ Memory Management - Adaptive buffer sizing
- π UID Security - Enhanced sandboxed environment support
- π± Modern Android Support - Android 15 compatibility
- π¨ UI Improvements - Better error handling and user feedback
Before integrating BlackBox into your project, ensure you have:
- Android Studio: Arctic Fox or newer
- JDK: Version 17 or higher
- Android SDK: API level 24+ with build tools
- NDK: Version 29.0.13846066 (automatically downloaded)
- Download the latest Bcore AAR from Telegram Channel
- Place the
.aar
file in yourapp/libs/
directory - Add to your
app/build.gradle
:
dependencies {
implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])
}
- Clone this repository
- Open in Android Studio
- Build the Bcore module
- Include the generated AAR in your project
- Docs.md - Comprehensive user guide covering all features, installation, app management, WebView support, Google services, background jobs, troubleshooting, and advanced features
- RELEASE_NOTES.md - Detailed release notes for version 2.4.0 with all new features, improvements, and bug fixes
- Installation Methods: Pre-built AAR or source code compilation
- API Reference: Complete developer interface documentation
- Troubleshooting: Common issues and solutions
- Performance Metrics: Benchmarks and compatibility statistics
- App Management: Install, remove, and manage virtual applications
- WebView & Browser Support: Complete WebView compatibility and browser apps
- Google Services Integration: GMS, account management, and authentication
- Background Job Management: WorkManager and JobScheduler support
- Advanced Features: UID spoofing, process management, and security
- Troubleshooting: Debug mode, log analysis, and problem resolution
- API Reference: Complete class and method documentation
- FAQ: Common questions and detailed answers
π‘ Pro Tip: Start with Docs.md for comprehensive usage instructions, then refer to RELEASE_NOTES.md for detailed feature information.
BlackBox provides comprehensive Xposed support with advanced stealth capabilities:
- β Full Xposed API Support: Compatible with most Xposed modules
- π΅οΈ Anti-Detection: Hidden from detection tools like Xposed Checker and XposedDetector
- π Sandboxed Execution: Xposed modules run in isolated environment
- β‘ High Performance: Optimized hook implementation with minimal overhead
// Check Xposed availability
try {
boolean xposedAvailable = BlackBoxCore.get().isXposedEnabled();
Log.d("BlackBox", "Xposed available: " + xposedAvailable);
} catch (Exception e) {
Log.e("BlackBox", "Failed to check Xposed status", e);
}
// Install Xposed module
try {
boolean success = BlackBoxCore.get().installXposedModule(
"/sdcard/module.apk", userId);
if (success) {
Log.d("BlackBox", "Xposed module installed successfully");
}
} catch (Exception e) {
Log.e("BlackBox", "Failed to install Xposed module", e);
}
- Android Studio: 2023.1.1 (Hedgehog) or newer
- JDK: OpenJDK 17 or Oracle JDK 17
- Android SDK: API 24-35 with build tools 34.0.0+
- NDK: Version 29.0.13846066 (automatically installed)
- Git: For version control
# Clone the repository
git clone https://github.com/your-repo/NewBlackbox.git
cd NewBlackbox
# Open in Android Studio or build via command line
./gradlew assembleDebug
# For release build
./gradlew assembleRelease
// Project-level build.gradle
compileSdkVersion 35
targetSdkVersion 34
minSdkVersion 24
// App-level configuration
android {
compileSdk 35
ndkVersion "29.0.13846066"
defaultConfig {
applicationId "top.niunaijun.blackboxa"
minSdk 24
targetSdk 34
versionCode 2
versionName "2.0-r1beta"
}
}
Symptoms: App crashes with SecurityException or NullPointerException Solutions:
- UID Mismatch Issues:
// Check logcat for: "Calling uid: X doesn't match source uid: Y" // Solution: Enhanced UID management is automatically handled
- Missing APK Files:
// Check logcat for: "Unable to open APK" or "I/O error" // Solution: APK path resolution with fallback mechanisms included
Symptoms: InstallPackageAsUser returns false Solutions:
- Check storage permissions
- Verify APK file integrity
- Ensure sufficient storage space
- Check target architecture compatibility
Symptoms: App freezes when loading virtual applications Solutions:
- Resource Loading Issues: Enhanced error handling implemented
- Memory Issues: Memory-aware buffer sizing included
- Context Creation Failures: Multiple fallback mechanisms added
Symptoms: Crashes on Android 15 devices Solutions:
- Security Restrictions: Enhanced security exception handling
- Permission Model: Updated permission handling for Android 15
- Edge-to-Edge UI: Modern UI compatibility improvements
Symptoms: Crashes or instability on Xiaomi devices Solutions:
- MIUI Security: Special optimizations for MIUI security policies
- Background Restrictions: Enhanced background execution handling
- Permission Management: MIUI-specific permission handling
- Check Android version compatibility (5.0-15.0)
- Verify device architecture (ARM64/ARMv7/x86)
- Ensure storage permissions granted
- Check available storage space (>100MB)
- Monitor logcat for specific error messages
- Test with different target architecture builds
// Enable debug logging
Log.d("BlackBox", "Debug message");
Log.e("BlackBox", "Error message", exception);
// Monitor key components
- APK path resolution
- UID management
- Security exceptions
- Context creation
- JAR file operations
- π± App Module: User interface and interaction handling (Kotlin)
- βοΈ Bcore Module: Core virtual engine functionality (Java/Kotlin)
- π§ Native Core: Low-level system integration
- π Utils: Utility classes and helper functions
- Code Quality: Follow existing code style and patterns
- Documentation: Document new features and APIs
- Testing: Test on multiple Android versions and devices
- Commit Messages: Use clear, descriptive commit messages (English/Chinese OK)
- Pull Requests: Provide detailed descriptions of changes
- π§ Core Engine: Virtual application management improvements
- π‘οΈ Security: Enhanced sandboxing and permission handling
- β‘ Performance: Memory and CPU optimization
- π± Compatibility: Support for newer Android versions
- π¨ UI/UX: Improved user interface and experience
- π Enhanced Service API Virtualization
- π§ Advanced Developer Interfaces
- Virtual location manipulation
- Process injection capabilities
- Custom environment variables
- π Performance Monitoring Dashboard
- π‘οΈ Advanced Security Features
- π― Plugin Architecture Support
The enhanced source code with all improvements and fixes is available for commercial licensing:
- Telegram: @ALEX5402 - Direct message for inquiries
- Email: Contact via Telegram for email details
- Response Time: Usually within 24 hours
- π¦ Complete Enhanced Source Code - All fixes and improvements
- π§ Build Scripts & Configuration - Ready-to-use project setup
- π Comprehensive Documentation - Implementation guides and API docs
- π οΈ Technical Support - Direct support from ALEX502
- π Future Updates - Access to ongoing improvements
- π’ Commercial Usage Rights - Full licensing for commercial projects
- App Development Companies - Virtual app solutions
- Security Research - Sandboxing and isolation studies
- Educational Institutions - Android virtualization research
- Enterprise Solutions - Custom virtual environment needs
This project represents significant development effort in creating a stable, secure virtual engine. Your support helps continue development and maintenance.
- BTC (Btc):
14z658gFXzNTbGEXySNJLGxwHfJmMViRaB
- USDT (TRC20):
TFNQw5HgWUS33Ke1eNmSFTwoQySGU7XNsK
- Buy ALEX502 a Coffee: Help fuel continued development
- Feature Sponsorship: Contact for custom feature development
- Priority Support: Commercial users receive priority assistance
- ALEX502 - Complete enhanced edition with comprehensive bug fixes, security improvements, and performance optimizations
- APK Path Resolution System - Intelligent fallback mechanisms for missing APK files
- Security Exception Handling - Robust UID management for Android 15 and MIUI devices
- Performance Optimization - Memory-aware buffer sizing and async operations
- JAR System Overhaul - Complete rewrite with integrity verification and caching
- Error Recovery Mechanisms - Comprehensive error handling throughout the application
- Compilation Fixes - Resolution of critical build and runtime errors
- Freezing Bug Elimination - Complete fix for NullPointerException issues
- Context Creation Enhancement - Multiple fallback strategies for package contexts
- VirtualApp - Original virtual application framework
- VirtualAPK - Plugin framework inspiration
- BlackReflection - Reflection utilities
- FreeReflection - Enhanced reflection support
- Dobby - Native hook framework for ARM/ARM64/x86/x64
- xDL - Android dynamic linker utilities
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.