update v1.1

Author: dyokism

README.id.md

@@ -2,48 +2,41 @@
 
 # DexForge
 
-Modul Magisk/KernelSU yang dirancang untuk menganalisis HP secara otomatis dan membangun ulang (*rebuild*) cache ART/Dalvik menggunakan filter kompilasi yang paling optimal.
+Modul Magisk/KernelSU profesional yang dirancang untuk menganalisis sumber daya perangkat secara dinamis dan mengoptimalkan cache ART/Dalvik menggunakan strategi kompilasi cerdas berbasis tingkatan perangkat (*tier-based*).
 
 ### Cara Kerja
-Android menggunakan ART (Android Runtime) untuk mengompilasi aplikasi. Seiring waktu, atau setelah update sistem, cache ini bisa jadi kurang optimal, bikin HP kerasa lemot atau boros baterai.
-1. DexForge membaca kapasitas RAM, sisa storage, dan versi Android HP.
-2. Modul ini mengklasifikasikan HP ke dalam tier (Flagship, Mid, atau Entry).
-3. Berdasarkan tier dan sisa ruang, modul memilih filter compiler `dex2oat` terbaik (misalnya, `speed-profile`, `speed`, `verify`, atau `quicken`).
-4. Melakukan kompilasi ulang pada aplikasi yang terinstal untuk mengembalikan performa maksimal.
+Android mengompilasi aplikasi menggunakan Android Runtime (ART). Seiring waktu, atau setelah pembaruan sistem, kode terkompilasi dapat kehilangan tingkat optimasinya, mengakibatkan kelambatan peluncuran aplikasi (*sluggishness*) dan pemborosan baterai.
+1. **Profiling Sumber Daya**: DexForge membaca RAM, sisa ruang penyimpanan, dan versi SDK Android HP.
+2. **Klasifikasi Perangkat**: Mengelompokkan perangkat ke dalam kategori Flagship, Mid, atau Entry.
+3. **Pencegahan Layar Tidur**: Melakukan override dinamis pada setelan timeout layar (`screen_off_timeout` + `svc power stayon`) agar layar tetap menyala penuh selama kompilasi tanpa bergantung pada status pengisian daya baterai (charger), lalu memulihkan setelan asli secara otomatis saat selesai atau batal.
+4. **Rute Optimasi Cerdas**:
+   - **Flagship**: Menggunakan kompilasi massal (`-a`) untuk mengompilasi seluruh aplikasi termasuk sistem bawaan (Settings, SystemUI) demi pengalaman penggunaan yang super lancar.
+   - **Mid & Entry**: Menggunakan kompilasi bertahap khusus aplikasi pihak ketiga (`-3`) untuk menghemat penyimpanan, menjaga suhu perangkat, dan menghemat baterai.
+5. **SELinux Safe Pipe**: Mengambil data standar output dan error melalui pipa shell internal terlebih dahulu untuk memintas pembatasan penulisan langsung ke `/data/adb/` oleh kebijakan SELinux Android.
 
 ### Standar Keamanan & Kualitas
-**Kenapa nggak dipaksa ke 'speed' semua?** Mengompilasi semua aplikasi pakai filter `speed` bakal ngabisin storage yang gede banget dan prosesnya lama. DexForge pakai sistem profiling pintar buat terapin filter agresif cuma di HP high-end yang storage-nya lega, dan pakai filter yang lebih aman buat HP kelas menengah atau entry-level. Modul ini juga punya fitur keamanan buat otomatis batalin proses kalau sisa storage di bawah 512MB.
-
-### Fitur Utama
-- **Smart Profiling**: Otomatis deteksi kemampuan HP (RAM & Storage).
-- **Filter Dinamis**: Menerapkan filter kompilasi yang paling pas sesuai spesifikasi HP.
-- **Safety Guards**: Mencegah bootloop atau sistem crash dengan mengecek batas storage dan versi Android.
-- **Support Action Button**: Nggak perlu repot buka terminal; tinggal klik tombol dari aplikasi Magisk/KernelSU.
+- **Proteksi Penyimpanan Rendah**: Proses otomatis dibatalkan jika sisa penyimpanan di bawah 512MB demi mencegah bootloop.
+- **Ambang Batas Baterai**: Proses diblokir jika daya baterai di bawah 15% dan tidak terhubung ke pengisi daya.
+- **Pembersihan Cache Interaktif**: Opsi interaktif via tombol volume fisik untuk membersihkan cache sebelum optimasi dimulai, lengkap dengan detail konsekuensi waktu kompilasi yang lebih lama.
+- **Pemasangan Hening (Magisk Silent Install)**: Pemasangan instan tanpa gangguan interaksi tombol volume saat flashing, seluruh interaksi dipindahkan ke tombol Action.
 
 ### Persyaratan
 - Magisk v20.4+ atau KernelSU / APatch
 - Android 7.0+ (SDK 24+)
 
 ### Instalasi
-1. Download file `.zip` DexForge terbaru.
-2. Buka aplikasi Magisk / KernelSU / APatch.
-3. Masuk ke menu Modules.
-4. Klik **Install from storage** lalu pilih file zip yang udah di-download.
-5. Reboot HP.
+1. Unduh berkas rilis `DexForge-v1.1.zip` terbaru.
+2. Buka aplikasi Magisk, KernelSU, atau APatch.
+3. Masuk ke bagian Modul.
+4. Pilih **Instal dari penyimpanan** lalu tentukan berkas zip yang telah diunduh.
+5. Reboot perangkat Anda.
 
 ### Cara Pakai
-
-**01 Buka aplikasi root manager**
-Buka Magisk, KernelSU, atau APatch di HP.
-
-**02 Masuk ke Modules**
-Buka tab modul tempat install DexForge.
-
-**03 Tekan Action Button**
-Cari modul DexForge, terus klik tombol **Action** (atau ikon play). Skripnya bakal otomatis jalan, baca spek HP, dan mulai proses *recompile*.
-
-**04 Tunggu dan Reboot**
-Biarin prosesnya jalan sampai selesai. Kalo udah muncul ringkasannya, sangat disarankan buat reboot HP biar efeknya maksimal.
+1. Buka aplikasi root manager Anda.
+2. Navigasikan ke bagian modul.
+3. Tekan tombol **Action** (atau tombol "Jalankan") pada modul DexForge.
+4. Gunakan tombol volume fisik untuk memilih opsi pembersihan cache dalam waktu 10 detik.
+5. Tunggu proses hingga selesai (layar akan tetap menyala secara otomatis). Reboot perangkat sangat disarankan setelah kompilasi selesai.
 
 ### Disclaimer
-Ini adalah alat eksperimental. Walaupun udah dikasih sistem pengaman, memodifikasi cache sistem kadang bisa bikin aplikasi error. Gunakan dengan bijak dan pastikan punya backup data penting.
+Ini adalah alat optimasi tingkat lanjut. Meskipun sistem keamanan ketat telah diterapkan, memodifikasi cache sistem melibatkan operasi tingkat rendah. Gunakan secara bijak.

README.md

@@ -2,48 +2,41 @@
 
 # DexForge
 
-A Magisk/KernelSU module designed to automatically analyze your device and rebuild the ART/Dalvik cache using the most optimal compiler filter.
+A professional Magisk/KernelSU module designed to analyze your device resources dynamically and optimize the ART/Dalvik cache with high-efficiency tier-based compilation strategies.
 
 ### How It Works
-Android uses the ART (Android Runtime) to compile apps. Over time, or after a system update, this cache can become unoptimized, leading to sluggish performance or battery drain. 
-1. DexForge profiles your device's RAM, available storage, and Android version.
-2. It classifies your device into a tier (Flagship, Mid, or Entry).
-3. Based on the tier and available space, it selects the best `dex2oat` compiler filter (e.g., `speed-profile`, `speed`, `verify`, or `quicken`).
-4. It safely recompiles your installed packages to restore optimal performance.
+Android compiles apps using the Android Runtime (ART). Over time, or after software updates, compiled code can lose optimization, resulting in micro-stutters, slower app launches, and increased battery drain.
+1. **Resource Profiling**: DexForge checks available RAM, free storage space, and Android SDK version.
+2. **Tier-Based Classification**: It classifies the device as Flagship, Mid, or Entry.
+3. **Screen Sleep Prevention**: It dynamically overrides screen sleep timeouts (`screen_off_timeout` + `svc power stayon`) so the display stays awake during compilation regardless of the charger state, then restores original settings automatically upon completion or abort.
+4. **Smart Optimization Routing**:
+   - **Flagship**: Uses bulk compilation (`-a`) to compile all apps, including critical system applications (like Settings, SystemUI) for an ultra-smooth experience.
+   - **Mid & Entry**: Uses focused package-by-package compilation (`-3`) targeting user-installed apps to preserve storage, thermals, and battery health.
+5. **SELinux Safe Pipe**: Captures standard error and standard output to shell variables first, completely bypassing Android's SELinux write restrictions to `/data/adb/`.
 
 ### Safety & Quality Standards
-**Why not force 'everything' to 'speed'?** Compiling everything with the `speed` filter consumes massive amounts of storage and takes a very long time. DexForge uses smart profiling to only apply aggressive filters on high-end devices with plenty of storage, while using safer, balanced filters for mid-range and entry-level devices. It also includes built-in safeguards to abort if your free storage is under 512MB.
-
-### Core Features
-- **Smart Profiling**: Automatically detects device capabilities (RAM & Storage).
-- **Dynamic Filters**: Applies the optimal compilation filter based on the device tier.
-- **Safety Guards**: Prevents bootloops or system crashes by checking storage limits and SDK versions.
-- **Action Button Ready**: No need to use the terminal; execute the optimization directly from the Magisk/KernelSU app interface.
+- **Low Storage Protection**: Compilation aborts instantly if free storage is below 512MB to prevent bootloops.
+- **Battery Threshold**: Compilation is blocked if the battery level is below 15% and not connected to a charger.
+- **Robust Cache Reset**: Interactive volume key option to reset target packages' cache before recompiling, detailing compile-time implications.
+- **Magisk Silent Install**: Seamless automated installations with an on-demand volume key interface at runtime via the Action Button.
 
 ### Requirements
 - Magisk v20.4+ or KernelSU / APatch
 - Android 7.0+ (SDK 24+)
 
 ### Installation
-1. Download the latest DexForge `.zip` release.
-2. Open the Magisk / KernelSU / APatch app.
+1. Download the latest `DexForge-v1.1.zip` release.
+2. Open the Magisk, KernelSU, or APatch manager app.
 3. Go to the Modules section.
 4. Tap **Install from storage** and select the downloaded zip file.
 5. Reboot your device.
 
 ### How to Use
-
-**01 Open your root manager**
-Open the Magisk, KernelSU, or APatch application on your device.
-
-**02 Go to Modules**
-Navigate to the modules tab where DexForge is installed.
-
-**03 Tap the Action Button**
-Find DexForge and tap the **Action** (or 'Run') button. The script will automatically profile your device and begin the recompilation process.
-
-**04 Wait and Reboot**
-Let the process finish. Once it shows the summary, it is highly recommended to reboot your device for the changes to take full effect.
+1. Open your root manager application.
+2. Navigate to the modules section.
+3. Tap the **Action** (or "Run") button next to DexForge.
+4. Use volume keys to select your cache clearing choice within 10 seconds.
+5. Wait for the process to complete (the screen will stay awake automatically). A reboot is highly recommended once compilation is complete.
 
 ### Disclaimer
-This is an experimental tool. While safeguards are in place, modifying system caches can sometimes cause unexpected app behavior. Use responsibly and keep a backup of your important data.
+This is an advanced optimization tool. While robust safeguards are implemented, modifying runtime caches involves system-level operations. Use responsibly.