Skip to content

a softwere to clone apps on android also support running apps without installing

License

Notifications You must be signed in to change notification settings

ALEX5402/NewBlackbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Virtual Engine Β· BlackBox (Enhanced Edition)

BlackBox Banner

Enhanced by ALEX502 Java Kotlin Android 5.0+ Architecture License

"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


πŸ“– Overview

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.

🌟 Key Features

  • πŸ“± 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

🎯 Compatibility & Requirements

Supported Android Versions

  • 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

Device Requirements

  • RAM: Minimum 2GB, Recommended 4GB+
  • Storage: 100MB+ free space
  • Architecture: ARM64-v8a, ARMv7a, or x86
  • Permissions: Storage access required

Compatibility Notes

  • 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.

πŸ—οΈ Technical Specifications

Architecture Support

  • 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.

Core Components

  • 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

Dependencies & Libraries

  • 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

πŸ“¦ Release Information

Download Options

  • πŸ”– Stable Release: Production-ready versions verified by administrators
  • πŸš€ Canary Builds: Latest features with automatic CI/CD

Version Information

  • Current Version: 2.0-r1beta
  • Version Code: 2
  • Release Type: Beta with comprehensive improvements

πŸ“ Changelog & Improvements

This enhanced edition includes numerous critical fixes and improvements:

πŸ”§ Major Bug Fixes

  • βœ… 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

πŸš€ Performance Enhancements

  • ⚑ 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

πŸ›‘οΈ Security Improvements

  • πŸ”’ 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

🎯 Compatibility Enhancements

  • πŸ“± 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)

πŸ“… Development Timeline & Feature Calendar

πŸ—“οΈ 2024 Enhancement Roadmap by ALEX502

Phase Android Support Major Features Critical Fixes
πŸš€ Phase 1
Core Stability
  • βœ… Android 5.0-7.0
  • βœ… Android 8.0-10.0
  • βœ… Android 11.0-12.0
  • πŸ”§ Basic Virtual Engine
  • πŸ“± App Cloning Support
  • 🎯 Multi-User System
  • πŸ”’ Basic Sandboxing
  • πŸ› Compilation Error Fixes
  • πŸ› Basic Stability Issues
  • πŸ› Memory Leak Prevention
⚑ Phase 2
Performance
  • βœ… Android 13.0
  • βœ… MIUI Optimization
  • βœ… Tablet Support
  • ⚑ JAR System Overhaul
  • πŸ”„ Async Operations
  • πŸ’Ύ Memory Management
  • πŸ“Š Performance Monitoring
  • πŸ”§ APK Path Resolution
  • πŸ”§ Resource Loading Fixes
  • πŸ”§ Context Creation Issues
  • πŸ”§ Freezing Bug Elimination
πŸ›‘οΈ Phase 3
Security
  • βœ… Android 14.0
  • βœ… Enhanced Permissions
  • βœ… Scoped Storage
  • πŸ›‘οΈ Enhanced Sandboxing
  • πŸ” UID Security Management
  • πŸ•΅οΈ Xposed Anti-Detection
  • πŸ”’ File Integrity Verification
  • πŸ” Security Exception Handling
  • πŸ” UID Mismatch Resolution
  • πŸ” Permission Crashes
  • πŸ” Sandboxed Environment Issues
🎯 Phase 4
Modern Support
  • βœ… Android 15.0
  • βœ… Latest Security Model
  • βœ… Edge-to-Edge UI
  • βœ… 64-bit Mandatory
  • 🌐 Multi-Architecture Support
  • 🎨 Modern UI Compatibility
  • πŸ” Advanced Location Spoofing
  • πŸ“‘ Enhanced API Support
  • πŸ†• Android 15 Compatibility
  • πŸ†• New Permission Model
  • πŸ†• Predictive Back Gesture
  • πŸ†• Enhanced Security Policies

πŸ“Š Android Version Compatibility Matrix

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

🎯 Feature Implementation Status

βœ… Completed Features

  • πŸ”§ 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

🚧 Enhanced in This Edition

  • πŸ”§ 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

πŸš€ Quick Start Guide

Prerequisites

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)

πŸ“± Installation Methods

Method 1: Using Pre-built AAR (Recommended)

  1. Download the latest Bcore AAR from Telegram Channel
  2. Place the .aar file in your app/libs/ directory
  3. Add to your app/build.gradle:
dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])
}

Method 2: Building from Source

  1. Clone this repository
  2. Open in Android Studio
  3. Build the Bcore module
  4. Include the generated AAR in your project

βš™οΈ Documentation & Resources

πŸ“š Complete User Guide

  • Docs.md - Comprehensive user guide covering all features, installation, app management, WebView support, Google services, background jobs, troubleshooting, and advanced features

πŸ“‹ Release Information

  • RELEASE_NOTES.md - Detailed release notes for version 2.4.0 with all new features, improvements, and bug fixes

πŸ”§ Quick Start & Integration

  • 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

πŸ“– Documentation Sections

  • 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.

πŸ›‘οΈ Xposed Framework Integration

BlackBox provides comprehensive Xposed support with advanced stealth capabilities:

Features

  • βœ… 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

Usage Example

// 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);
}

πŸ› οΈ Build Instructions

Prerequisites

  • 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

Building from Source

# 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

Build Configuration

// 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"
    }
}

πŸ”§ Troubleshooting Guide

Common Issues & Solutions

πŸ› App Crashes on Startup

Symptoms: App crashes with SecurityException or NullPointerException Solutions:

  1. UID Mismatch Issues:
    // Check logcat for: "Calling uid: X doesn't match source uid: Y"
    // Solution: Enhanced UID management is automatically handled
  2. Missing APK Files:
    // Check logcat for: "Unable to open APK" or "I/O error"
    // Solution: APK path resolution with fallback mechanisms included

πŸ› Virtual Apps Won't Install

Symptoms: InstallPackageAsUser returns false Solutions:

  1. Check storage permissions
  2. Verify APK file integrity
  3. Ensure sufficient storage space
  4. Check target architecture compatibility

πŸ› Freezing During App Loading

Symptoms: App freezes when loading virtual applications Solutions:

  1. Resource Loading Issues: Enhanced error handling implemented
  2. Memory Issues: Memory-aware buffer sizing included
  3. Context Creation Failures: Multiple fallback mechanisms added

πŸ› Android 15 Compatibility Issues

Symptoms: Crashes on Android 15 devices Solutions:

  1. Security Restrictions: Enhanced security exception handling
  2. Permission Model: Updated permission handling for Android 15
  3. Edge-to-Edge UI: Modern UI compatibility improvements

πŸ› MIUI Device Issues

Symptoms: Crashes or instability on Xiaomi devices Solutions:

  1. MIUI Security: Special optimizations for MIUI security policies
  2. Background Restrictions: Enhanced background execution handling
  3. Permission Management: MIUI-specific permission handling

πŸ“‹ Debug Checklist

  • 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

πŸ” Logging & Debugging

// 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

🀝 Contributing to the Project

Project Architecture

  • πŸ“± 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

Contribution Guidelines

  1. Code Quality: Follow existing code style and patterns
  2. Documentation: Document new features and APIs
  3. Testing: Test on multiple Android versions and devices
  4. Commit Messages: Use clear, descriptive commit messages (English/Chinese OK)
  5. Pull Requests: Provide detailed descriptions of changes

Development Focus Areas

  • πŸ”§ 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

πŸš€ Future Roadmap

Planned Enhancements

  • 🌐 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

πŸ’° Commercial Availability & Support

πŸ“ž Contact ALEX502 for Commercial Use

The enhanced source code with all improvements and fixes is available for commercial licensing:

πŸ“± Contact Methods

  • Telegram: @ALEX5402 - Direct message for inquiries
  • Email: Contact via Telegram for email details
  • Response Time: Usually within 24 hours

πŸ’Ό What's Included in Commercial License

  • πŸ“¦ 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

🎯 Perfect For

  • App Development Companies - Virtual app solutions
  • Security Research - Sandboxing and isolation studies
  • Educational Institutions - Android virtualization research
  • Enterprise Solutions - Custom virtual environment needs

πŸ’– Sponsorship & Support

This project represents significant development effort in creating a stable, secure virtual engine. Your support helps continue development and maintenance.

πŸͺ™ Cryptocurrency Donations

  • BTC (Btc): 14z658gFXzNTbGEXySNJLGxwHfJmMViRaB
  • USDT (TRC20): TFNQw5HgWUS33Ke1eNmSFTwoQySGU7XNsK

β˜• Support Development

  • Buy ALEX502 a Coffee: Help fuel continued development
  • Feature Sponsorship: Contact for custom feature development
  • Priority Support: Commercial users receive priority assistance

πŸ™ Credits & Acknowledgments

πŸ‘¨β€πŸ’» Enhanced Edition Developer

  • ALEX502 - Complete enhanced edition with comprehensive bug fixes, security improvements, and performance optimizations

πŸ”§ Fixes & Improvements by ALEX502

  • 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

πŸ“š Original Framework Credits

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.

About

a softwere to clone apps on android also support running apps without installing

Resources

License

Stars

Watchers

Forks