Come Funziona WaEnhancer X e Perché Riscrivere gli Hook di WhatsApp in Java Puro

Usare il client WhatsApp ufficiale è un'esperienza particolare. Il messenger continua ad accumulare Meta AI intrusiva, perde impostazioni comode e limita la visualizzazione dei media. In precedenza, gli appassionati risolvevano questi problemi con modifiche di terze parti come WhatsApp Plus, ma Meta blocca rapidamente gli account che eseguono file APK modificati. Su Android, c'è un altro percorso: modificare il comportamento dell'app direttamente nella RAM utilizzando il framework LSPosed.

Su GitHub ho trovato il repository WaEnhancer X. È un fork del progetto WaEnhancer originale, che segue un percorso ingegneristico interessante. Quando gli autori del modulo originale hanno iniziato a riscrivere il codice in Kotlin spostando le impostazioni in schermate esterne, lo sviluppatore di WaEnhancer X ha fatto un passo indietro verso Java puro e l'integrazione nativa direttamente nell'interfaccia di WhatsApp.

Cosa C'è All'Interno: dal Blocco dell'AI al Lavoro Diretto con SQLite

Il compito principale del modulo è intercettare le chiamate ai metodi all'interno del client WhatsApp originale e modificarne la logica. Ecco diversi esempi di come questo viene fatto da un punto di vista tecnico:

• Distruggere l'interfaccia intrusiva. WhatsApp cerca costantemente di mostrare banner Meta AI attraverso flag del server. WaEnhancer X intercetta la creazione di questi elementi UI e li imposta forzatamente allo stato View.GONE prima del rendering sullo schermo.
• Query SQL dirette invece di attendere le animazioni dell'interfaccia. Quando elimini uno stato o un messaggio, il client standard esegue una serie di animazioni e dialoghi. Il modulo bypassa questo livello e accede al database SQLite locale message e all'archiviazione dei file tramite MediaProvider direttamente, eseguendo l'operazione istantaneamente.
• Eludere le restrizioni temporali. I file multimediali monouso (Visualizza Una Volta) bloccano screenshot e visualizzazione in replay. Un hook nel codice dell'app sostituisce i flag di accesso, rendendo la visualizzazione permanente e permettendo di salvare il file nella galleria.
• Integrazione con Tasker. Il modulo può ricevere Intent Android da strumenti di automazione di terze parti, abilitando l'automazione della modalità privacy basata sulla posizione o sulla pianificazione.

Trucchi Architetturali: Come Combinare GPL e Codice Proprietario

La parte più interessante del repository è nascosta nella struttura del modulo e nella licenza. Il progetto è rigorosamente diviso in tre componenti indipendenti:

+-------------------------------------------------------+
|                   Helper Plugin APK                   |
|           (Закрытый код / Дополнительные фичи)        |
+-------------------------------------------------------+
                           |
                           v  (Compile-Time Dependency)
+-------------------------------------------------------+
|                     :api Module                       |
|          Лицензия Apache-2.0 / Интерфейсы и DTO       |
+-------------------------------------------------------+
                           ^
                           |  (Shared API Dependency)
+-------------------------------------------------------+
|                     :app Module                       |
|           Лицензия GPL-3.0 / Основной фреймворк       |
+-------------------------------------------------------+

Perché è necessaria questa complessità? Per evitare di violare i termini della GNU GPL v3. Il modulo hook principale (:app) è distribuito sotto GPL-3.0. Se compilato insieme a componenti chiusi, risulterebbe in una violazione della licenza.

L'autore ha spostato tutte le interfacce di interazione in un modulo separato :api sotto la licenza permissiva Apache-2.0. In fase di esecuzione, l'host aperto rileva l'APK ausiliario tramite ContentProvider e lo carica dinamicamente tramite il proprio ClassLoader. Di conseguenza, il plugin chiuso viene eseguito all'interno del processo WhatsApp attraverso le interfacce :api, senza avere dipendenze binarie dirette con il codice host con licenza GPL.

Perché 100% Java Invece di Kotlin

Lo sviluppo Android moderno è quasi completamente passato a Kotlin, ma per i moduli Xposed, Java ha ancora i suoi vantaggi. Quando si lavora costantemente con la reflection di basso livello (FeatureLoader), Java puro offre diversi vantaggi:

1. Bytecode prevedibile. L'assenza di magia del compilatore Kotlin (funzioni inline, metodi sintetici e generazione di metadati) semplifica il debug degli hook.
2. Overhead zero. La Kotlin Standard Library non viene caricata nel processo WhatsApp, il che riduce il rischio di conflitti di versione se WhatsApp stesso utilizza versioni diverse delle librerie.
3. Stabilità tra gli aggiornamenti. L'approccio di intercettazione dei metodi si rompe meno spesso quando la struttura delle classi di WhatsApp cambia con una nuova release.

La schermata delle impostazioni del modulo non è stata costruita nemmeno con Jetpack Compose. Lo sviluppatore ha utilizzato PreferenceFragmentCompat standard, integrando il menu del modulo direttamente nelle impostazioni di WhatsApp. Sembra una sezione nativa dell'app, e per una navigazione comoda, è stata scritta una classe FeatureCatalog che indicizza i toggle e cerca la funzionalità desiderata utilizzando stringhe localizzate.

Come Provare il Modulo sul Tuo Dispositivo

Per eseguire WaEnhancer X è necessario uno smartphone preparato:

1. Il dispositivo deve avere accesso Root e LSPosed installato (versione Zygisk o Riru).
2. Scarica l'APK pronto dal repository GitHub e installalo.
3. Apri l'app LSPosed Manager e attiva il modulo WaEnhancer X.
4. Nell'elenco delle applicazioni (Scope), seleziona WhatsApp.
5. Arresta WhatsApp attraverso il menu di sistema ("Stop" / Force Stop) e avvia nuovamente il messenger.

Dopo di ciò, apparirà una nuova sezione con le opzioni del modulo nelle impostazioni di WhatsApp.

Perché Seguire il Progetto

WaEnhancer X è un chiaro esempio di come una corretta separazione dei moduli aiuti a bypassare le restrizioni di licenza nella creazione di componenti aggiuntivi per Android. Il progetto sarà utile per gli sviluppatori che studiano reflection, l'architettura degli hook LSPosed e l'iniezione di codice in applicazioni di terze parti.

La parte base del codice è aperta, priva di tracker esterni, e dimostra chiaramente come modificare il comportamento di un messenger chiuso senza creare build di terze parti discutibili.