-
-| 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
+## Build Instructions
### 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](https://t.me/blackbox_apks)
-2. Place the `.aar` file in your `app/libs/` directory
-3. Add to your `app/build.gradle`:
-```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](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](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](Docs.md) for comprehensive usage instructions, then refer to [RELEASE_NOTES.md](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](https://www.coolapk.com/apk/190247) and [XposedDetector](https://github.com/vvb2060/XposedDetector)
-- **๐ Sandboxed Execution**: Xposed modules run in isolated environment
-- **โก High Performance**: Optimized hook implementation with minimal overhead
-
-#### Usage Example
-```java
-// 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
+* Android Studio (Arctic Fox or newer)
+* JDK 17
+* Android SDK 34+
+* NDK (Version 29.0.13846066)
### Building from Source
+
```bash
# Clone the repository
git clone https://github.com/your-repo/NewBlackbox.git
cd NewBlackbox
-# Open in Android Studio or build via command line
+# Build Debug APK
./gradlew assembleDebug
-# For release build
+# Build Release APK
./gradlew assembleRelease
```
-### Build Configuration
-```gradle
-// Project-level build.gradle
-compileSdkVersion 35
-targetSdkVersion 34
-minSdkVersion 24
+## Integration
-// 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"
- }
+To use BlackBox Core in your own project, add the AAR dependency:
+
+```gradle
+dependencies {
+ implementation fileTree(dir: "libs", include: ["*.aar"])
}
```
-## ๐ง Troubleshooting Guide
+Refer to `Docs.md` for detailed API documentation.
-### Common Issues & Solutions
+## Troubleshooting
-#### ๐ App Crashes on Startup
-**Symptoms**: App crashes with SecurityException or NullPointerException
-**Solutions**:
-1. **UID Mismatch Issues**:
- ```java
- // Check logcat for: "Calling uid: X doesn't match source uid: Y"
- // Solution: Enhanced UID management is automatically handled
- ```
-2. **Missing APK Files**:
- ```java
- // Check logcat for: "Unable to open APK" or "I/O error"
- // Solution: APK path resolution with fallback mechanisms included
- ```
+* **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.
-#### ๐ 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
+## Credits
-#### ๐ 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
+* **Main Developer**: ALEX502
+* **Original Framework**: VirtualApp, VirtualAPK
+* **Native Hooks**: Dobby, xDL
+* **Reflection**: BlackReflection, FreeReflection
-#### ๐ 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
+## License
-#### ๐ 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
+Copyright 2022 BlackBox
-### ๐ 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
+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
-### ๐ Logging & Debugging
-```java
-// Enable debug logging
-Log.d("BlackBox", "Debug message");
-Log.e("BlackBox", "Error message", exception);
+ http://www.apache.org/licenses/LICENSE-2.0
-// 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](https://t.me/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
-- [VirtualApp](https://github.com/asLody/VirtualApp) - Original virtual application framework
-- [VirtualAPK](https://github.com/didi/VirtualAPK) - Plugin framework inspiration
-- [BlackReflection](https://github.com/CodingGay/BlackReflection) - Reflection utilities
-- [FreeReflection](https://github.com/tiann/FreeReflection) - Enhanced reflection support
-- [Dobby](https://github.com/jmpews/Dobby) - Native hook framework for ARM/ARM64/x86/x64
-- [xDL](https://github.com/hexhacking/xDL) - Android dynamic linker utilities
-
-### 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.
-> ```
+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.
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 96fd400..e71a85e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -2,172 +2,30 @@
## Version: Latest Build (2026-01-30)
-### Major Fixes
+### Major Changes
-#### 1. Fixed Instagram and App Crashes on Android 14+
-
-**Problem:** Apps like Instagram were crashing with `SecurityException` due to package/UID verification failures in `SensitiveContentProtectionManagerService`.
+#### 1. Removal of Xposed Framework Support
+**Summary:** The Xposed module loading and management features have been completely removed from BlackBox to streamline the core and remove legacy dependencies.
+**Details:**
+- Removed `BXposedManagerService` and related AIDL interfaces.
+- Removed "Install Xposed Module" UI and Settings entries.
+- Removed Xposed enablement flags in `BlackBoxCore` and `ClientConfiguration`.
+- Cleaned up `AppSystemEnv` and repositories to remove Xposed package checks.
+- Removed `FLAG_XPOSED` from `InstallOption` and `USER_XPOSED` from `BUserHandle`.
+#### 2. Anti-Detection Stability Fix
+**Problem:** The native file system hooks in `AntiDetection.cpp` were causing application crashes due to infinite recursion (Hook calls logging -> Logging calls `open` -> `open` hook calls Logging).
**Solution:**
-- Created `ISensitiveContentProtectionManagerProxy` to hook the Android 14+ sensitive content protection service
-- Intercepts `setSensitiveContentProtection()` calls and replaces guest package names with host package name
-- Properly implements `getWho()` using reflection to obtain the original service interface
-- Includes safety checks to only hook when service exists (Android 14+)
+- Removed all `LOGD` calls from critical native hooks (`my_fopen`, `my_open`, `my_stat`, etc.).
+- Fixed syntax errors in hook implementations.
+- Hooks now silently return `ENOENT` for blocked paths without triggering recursion.
-**Files Modified:**
-- `Bcore/src/main/java/top/niunaijun/blackbox/fake/service/ISensitiveContentProtectionManagerProxy.java` (NEW)
-- `Bcore/src/main/java/top/niunaijun/blackbox/fake/hook/HookManager.java`
+### Technical Details
-**Impact:** Instagram and other apps now work correctly on Android 14+ devices
+**Refactoring:**
+- Deleted `Bcore/src/main/java/top/niunaijun/blackbox/fake/frameworks/BXposedManager.java`
+- Deleted `app/src/main/java/top/niunaijun/blackboxa/view/xp` (Xposed UI)
+- Fixed compilation errors in `BlackBoxCore.java` and `AppSystemEnv.java` resulting from the removal.
----
-
-#### 2. Fixed ContentProvider Call Method Crashes
-
-**Problem:** Apps were crashing when ContentProviders' `call()` method had `AttributionSource` objects nested deep within `Bundle` arguments.
-
-**Solution:**
-- Created `AttributionSourceUtils` utility class with recursive Bundle traversal
-- Handles deeply nested `AttributionSource` objects in Bundles and Parcelables
-- Correctly fixes UID to use `getHostUid()` instead of `getBUid()`
-
-**Files Modified:**
-- `Bcore/src/main/java/top/niunaijun/blackbox/utils/AttributionSourceUtils.java` (NEW)
-- `Bcore/src/main/java/top/niunaijun/blackbox/fake/service/context/providers/ContentProviderStub.java`
-- `Bcore/src/main/java/top/niunaijun/blackbox/fake/service/context/providers/SystemProviderStub.java`
-
-**Impact:** Apps using ContentProvider for deep links, inter-app communication, and settings no longer crash
-
----
-
-#### 3. Fixed SettingsProvider "Invalid Method" Errors
-
-**Problem:** System SettingsProvider was receiving the package name instead of the actual method name (e.g., "GET_global"), causing "Invalid method" errors and crashes.
-
-**Solution:**
-- Updated `SystemProviderStub` and `ContentProviderStub` to NOT replace String arguments for `call()` methods
-- String arguments in `call()` are method names like "GET_global", "PUT_system", etc., not package names
-- Only replaces package names for query/insert/update/delete operations where appropriate
-
-**Files Modified:**
-- `Bcore/src/main/java/top/niunaijun/blackbox/fake/service/context/providers/SystemProviderStub.java`
-- `Bcore/src/main/java/top/niunaijun/blackbox/fake/service/context/providers/ContentProviderStub.java`
-
-**Impact:** Settings-related operations and system preferences now work correctly
-
----
-
-#### 4. Improved ContentProvider Error Handling
-
-**Problem:** ContentProvider `call()` methods were returning `null` on errors, causing `NullPointerException` crashes in apps expecting valid Bundle responses.
-
-**Solution:**
-- Updated `getSafeDefaultValue()` in `ContentProviderStub` to return empty `Bundle()` instead of `null` for `call()` method
-- Prevents NPE crashes in apps that don't null-check ContentProvider responses
-
-**Files Modified:**
-- `Bcore/src/main/java/top/niunaijun/blackbox/fake/service/context/providers/ContentProviderStub.java`
-
-**Impact:** Apps handle ContentProvider errors gracefully without crashes
-
----
-
-### Technical Improvements
-
-#### AttributionSource Handling
-- Implemented comprehensive recursive traversal of Bundle and Parcelable structures
-- Handles nested AttributionSource objects at any depth
-- Properly clones Bundles and Parcelables to avoid modifying shared state
-- Includes safety checks for null values and class loading errors
-
-#### Hook Architecture
-- Improved `BinderInvocationStub` usage patterns
-- Added proper `getWho()` implementations using reflection
-- Enhanced `isBadEnv()` checks to detect and recover from hook failures
-- Added service existence checks before attempting to hook Android version-specific services
-
----
-
-### Known Limitations
-
-#### Browser Compatibility
-**GeckoView/Chromium-based browsers (e.g., Nira Browser):**
-- These browsers use native rendering engines (libxul.so for Gecko, Chromium for Chrome-based)
-- Native crashes occur during engine initialization due to:
- - Multi-process architecture conflicts
- - Seccomp syscall filtering incompatibilities
- - Low-level shared memory/IPC issues
-
-**Recommendation:** Use WebView-based browsers instead:
-- Via Browser
-- Privacy Browser
-- JQuarks Browser
-- Simple Browser
-
-These use Android's built-in WebView and work correctly in virtualized environments.
-
----
-
-### Testing
-
-**Tested Apps:**
-- Instagram - Now works on Android 14+
-- Apps using SettingsProvider
-- Apps using ContentProvider for IPC
-- GeckoView/Chromium-based browsers (native engine limitation)
-
-**Test Environment:**
-- Android 14 (API 34)
-- Device: Various devices with Android 12+
-
----
-
-### Future Improvements
-
-1. **Native Engine Support:** Investigate native layer modifications to support browser engines
-2. **Additional Android 14 APIs:** Monitor for new system services requiring hooks
-3. **Performance:** Optimize recursive Bundle traversal for large data structures
-4. **Logging:** Add debug mode to trace ContentProvider and service hook operations
-
----
-
-### Contributors
-
-- Fixed by: AI Assistant (Antigravity)
-- Tested by: alex5402
-- Date: 2026-01-30
-
----
-
-### Upgrade Instructions
-
-1. Clean build:
- ```bash
- ./gradlew clean assembleDebug
- ```
-
-2. Install the updated APK on your device
-
-3. Test with previously crashing apps (e.g., Instagram on Android 14+)
-
----
-
-### Bug Reports
-
-If you encounter issues:
-1. Capture full logcat: `adb logcat > crash.log`
-2. Note the Android version and device model
-3. Identify which app is crashing
-4. Check for `SecurityException`, `NullPointerException`, or other errors
-
----
-
-## Summary
-
-This release primarily focuses on **Android 14 compatibility** and **ContentProvider crash fixes**. Apps that previously crashed due to package/UID verification, AttributionSource handling, or SettingsProvider issues should now work correctly.
-
-**Breaking Changes:** None
-
-**Minimum Android Version:** Unchanged (Android 5.0+)
-
-**Recommended Android Version:** Android 12+ for best compatibility
+**Known Limitations:**
+- **Native Signature Spoofing:** While `AntiDetection` hooks are stable, fully spoofing the APK signature at the native level (for apps that read the APK file directly) is not fully implemented. The current hooks hide blocked files but do not redirect file access to the original APK. Implementing this requires **PLT Hooking** (e.g., via xHook) and knowledge of the original APK path.
\ No newline at end of file
- 
- 
- 
- 
- 
-