Il team di Rolldown ha appena unito una correzione che impedisce a Vite di andare in crash con un errore di “Illegal instruction” su dispositivi Android ARM64 in esecuzione sotto Termux. Dopo dieci mesi in cui gli sviluppatori hanno visto i propri build fallire prima ancora che il codice venisse eseguito, il problema è finalmente risolto e il prossimo rilascio di Rolldown su npm funzionerà immediatamente.

Perché il crash era importante

Termux consente agli utenti di eseguire un ambiente in stile Linux su smartphone Android, e una comunità in crescita lo utilizza come unica postazione di sviluppo. In Bangladesh, Nigeria e Indonesia, molti programmatori usano uno smartphone invece di un laptop per scrivere e impacchettare applicazioni web. Vite, un rapido strumento di build che alimenta innumerevoli siti moderni, è una parte fondamentale di questo flusso di lavoro. Quando Vite tentava di avviarsi, incontrava immediatamente un errore di “Illegal instruction”, interrompendo il processo prima ancora che il JavaScript venisse analizzato. L'errore non forniva alcuno stack trace o log perché si verificava durante il caricamento di una libreria nativa, lasciando gli sviluppatori in un vicolo cieco senza una chiara soluzione alternativa.

Il disallineamento tecnico

La causa principale risiedeva in un'assunzione di basso livello integrata nel binding nativo di Rolldown. Il codice si aspettava che il processore supportasse le istruzioni ARMv8.1, un set presente nei chip più recenti ma assente in molti SoC Android ampiamente utilizzati, come il Cortex-A53. Quando un dispositivo privo di tali istruzioni tentava di caricare la libreria, la CPU sollevava un'eccezione di "illegal instruction".

Ad aggravare la situazione, il codice problematico risiedeva in una dipendenza chiamata mimalloc, un allocatore di memoria che include un flag di sicurezza progettato per bloccare l'uso di istruzioni non supportate. Quel flag veniva attivato solo in ambienti "Linux standard". Android, pur utilizzando il kernel Linux, si identifica in modo diverso, quindi la protezione non si attivava mai e il crash passava inosservato.

Come è stata costruita la correzione

La modifica unita estende il controllo di sicurezza di mimalloc per riconoscere Android (e FreeBSD) come piattaforme che necessitano della stessa protezione. Patchando la libreria invece di costringere gli sviluppatori a ricostruire o sostituire i pacchetti, la correzione ripristina la compatibilità senza passaggi aggiuntivi per gli utenti finali.

Cosa ottengono gli sviluppatori

  • Nessun pacchetto Termux personalizzato necessario. L'installazione standard di Rolldown tramite npm ora scarica un binario che rispetta il nuovo controllo di sicurezza.
  • Test immediati possibili. Una build di anteprima allegata alla pull request aperta consente a chiunque disponga di un dispositivo Android ARM64 di verificare la correzione oggi stesso, mentre la prossima versione ufficiale di Rolldown viene rilasciata su npm.

Considerazioni rimanenti

La risoluzione dipende dalla pubblicazione del pacchetto aggiornato da parte dei manutentori di Rolldown; finché ciò non accadrà, gli utenti dovranno fare affidamento sulla build di anteprima.

Cosa monitorare in seguito

  • Tempistiche del rilascio npm. Tieni d'occhio il changelog di Rolldown; nel momento in cui la nuova versione raggiungerà il registro, un semplice npm install rolldown porterà la correzione in produzione.

La patch unita trasforma uno stallo durato mesi in un aggiornamento di routine, dimostrando come i dati di utilizzo del mondo reale e le segnalazioni persistenti della community possano trasformare un bug "non pianificato" in un problema risolto. Per chiunque sviluppi applicazioni web su uno smartphone, il prossimo rilascio di Rolldown permetterà finalmente a Vite di avviarsi senza mandare in crash il processore.