Optimize Android DEX/ART compilations dynamically based on your device hardware.
DexForge is a cross-platform Android root module designed to dynamically optimize the system's DEX/ART compilations. By profiling the device's RAM tier, SDK level, battery state, and available storage during execution, DexForge automatically assigns the most appropriate compilation filter—ranging from speed for flagship devices to speed-profile or quicken/verify for entry and mid-tier hardware based on a dynamic usage-aware priority gradient. This hardware-aware profiling ensures that app launch times are minimized and system fluidity is maximized without overloading lower-spec devices.
- Tailored Performance: Automatically selects the best compiler filter (
speed,speed-profile, orverify/quicken) based on your device's RAM capacity and app usage statistics. - Safety Guards: Actively checks battery level and storage space before running to prevent errors.
- Interactive Cache Reset: Lets you optionally purge compilation caches before optimization to start fresh.
- Download the latest
DexForge.zipfrom Releases. - Install the ZIP file via your root manager's Modules tab (Magisk, KernelSU, or APatch).
- Reboot your device to fully initialize the background services and core thread watchdog.
- Launch the compilation engine by pressing the Action button in your root manager's menu.
- Interactive Cache Prompt: During start-up, press Volume UP to perform a clean reforge (purges existing compiler caches first) or Volume DOWN (or wait 10 seconds) to compile existing states incrementally.
- Optimization results and execution events are logged at:
/data/adb/modules/DexForge/dexforge.log
- To simulate execution and verify compiler selection without performing physical writes, run the CLI utility in a root shell:
su /data/adb/modules/DexForge/action.sh --dry-run
- Flagship Tier (> 6144 MB RAM): Compiles all system and user packages using individual tracking loops (preventing CPU locks) targeting the
speedfilter. During full runs (CLEAR_CACHE=true), it applies a usage-aware gradient where unused packages are set tospeed-profile. During incremental runs, it skips usagestats parsing to maximize execution speed. - Mid Tier (3072 MB - 6144 MB RAM): Assigns a usage-aware filter gradient where top used apps get
speed, normal apps getspeed-profile, and unused apps getverify(orquickenon older Android versions) to prevent OOM failures and storage exhaustion. - Entry Tier (<= 3072 MB RAM): Limits compilation to
speed-profilefor top apps andverify/quickenfor the rest to conserve CPU and storage.
- Storage Failsafe: Verifies contiguous free space on the
/datapartition. If available storage is under 512MB, compilation terminates to prevent bootloops. - Battery Failsafe: Queries battery status via PMIC sysfs metrics with fallback to
dumpsys battery. Execution is blocked if the device is not charging and capacity is under 15%.
- Dynamic Core Affinity: Watchdog dynamically resolves the lower half of logical cores on boot completion (handling prime-first CPU topologies safely) and restricts background compiler threads (
dalvik.vm.dex2oat-cpu-setanddalvik.vm.dex2oat-threads) to LITTLE efficiency cores to prevent CPU thermal throttling and user interface lag.
| Requirement | Details |
|---|---|
| Android | 7.0+ (API 24+) |
| Storage | Minimum 512MB free space on /data partition |
| Battery | Minimum 15% charge capacity (waived if actively charging) |
| Root | Magisk v20.4+, KernelSU, or APatch |
DexForge/
├── META-INF/
│ └── com/
│ └── google/
│ └── android/
│ ├── update-binary
│ └── updater-script
├── action.sh # core compiler selection and execution engine
├── changelog.md # changelog tracking module version updates
├── customize.sh # install-time setup and configuration
├── module.prop # module metadata properties
├── service.sh # late boot completion optimizer & thread regulator
├── uninstall.sh # clean up persistent data on uninstall
└── update.json # update metadata configuration
flowchart TD
StartA([Start: Late-Boot Trigger]) --> PollBoot[Poll sys.boot_completed]
PollBoot --> BootCheck{Boot Completed or Timeout?}
BootCheck -- No --> Sleep[Sleep 2s & Retry]
Sleep --> PollBoot
BootCheck -- Yes --> SetFilters[Set bg-dexopt & shared filters]
SetFilters --> ResolveCPU[Resolve CPU Mask dynamically]
ResolveCPU --> SetAffinity[Set dex2oat-cpu-set & threads]
SetAffinity --> FinishA([Finish: Tuning Applied])
%% Custom Styles and Colors (Ultra-Muted Slate Theme)
classDef startEnd fill:#1b2c24,stroke:#34d399,stroke-width:1.5px,color:#e6f4ea;
classDef fail fill:#2c1b1b,stroke:#f87171,stroke-width:1.5px,color:#fce8e6;
classDef decision fill:#2d2216,stroke:#fbbf24,stroke-width:1.5px,color:#fef3c7;
classDef process fill:#1e293b,stroke:#475569,stroke-width:1px,color:#f1f5f9;
class StartA,FinishA startEnd;
class BootCheck decision;
class PollBoot,Sleep,SetFilters,ResolveCPU,SetAffinity process;
flowchart TD
Start([Start: Trigger Action]) --> EnvCheck[1. Profile RAM, SDK, Storage & Battery]
EnvCheck --> Verification{Validate Constraints?}
Verification -- Fail --> Abort[Abort: Log & Exit safely]
Verification -- Pass --> VolumePrompt{Volume UP pressed within 10s?}
VolumePrompt -- Yes --> CacheReset[Set CLEAR_CACHE = true]
VolumePrompt -- No / Timeout --> CompileOnly[Set CLEAR_CACHE = false]
CacheReset --> DeviceTier{Classify RAM Tier?}
CompileOnly --> DeviceTier
DeviceTier -- Flagship --> FlagshipBranch{CLEAR_CACHE = true?}
DeviceTier -- Mid / Entry --> Usagestats[Parse dumpsys usagestats]
FlagshipBranch -- Yes --> Usagestats
FlagshipBranch -- No --> FlatFilter[Disable Usage-Aware Mode]
Usagestats --> PackageLoop[Scan Packages & Compile One-by-One with Gradient]
FlatFilter --> PackageLoop
PackageLoop --> Output[Generate dexforge.log & Summary]
Output --> Finish([Finish: Reboot Recommended])
%% Custom Styles and Colors (Ultra-Muted Slate Theme)
classDef startEnd fill:#1b2c24,stroke:#34d399,stroke-width:1.5px,color:#e6f4ea;
classDef fail fill:#2c1b1b,stroke:#f87171,stroke-width:1.5px,color:#fce8e6;
classDef decision fill:#2d2216,stroke:#fbbf24,stroke-width:1.5px,color:#fef3c7;
classDef process fill:#1e293b,stroke:#475569,stroke-width:1px,color:#f1f5f9;
class Start,Finish startEnd;
class Abort fail;
class Verification,VolumePrompt,DeviceTier,FlagshipBranch decision;
class EnvCheck,CacheReset,CompileOnly,Usagestats,FlatFilter,PackageLoop,Output process;