JumPHP runtime su Android: installare l'app

Su un telefono, una pagina web non può raggiungere la tua rete (Wi-Fi di casa, VPN, un server che accetta solo il tuo indirizzo). Il JumPHP runtime per Android è una piccola app che lo fa per le applicazioni JumPHP aperte nel browser, solo con il tuo permesso. Non è su Google Play: installi tu un file .apk. Questa pagina spiega ogni casella che Android ti chiede di spuntare.

Android dice che può essere dannoso? Non è un virus

Il browser, Android o Google Play Protect possono dire che il file «può danneggiare il dispositivo», «viene scaricato raramente» o «proviene da un'origine sconosciuta». È normale e previsto: significa solo che l'app non è distribuita da Google Play ed è firmata con una chiave propria. Cosa puoi verificare:

il codice sorgente è pubblico: git.jumphp.net/jumphp/jumPhp (cartella apps/runtime-android);
ascolta solo sul telefono stesso (127.0.0.1), risponde solo alle pagine di jumphp.net e si collega solo dove tocchi Sempre o Questa volta;
non legge mai file, contatti o messaggi e non registra mai ciò che passa (solo un registro: sito, applicazione, destinazione, ora, volume);
puoi revocare ogni permesso, o disinstallare l'app, in qualsiasi momento;
impronta (SHA-256) del certificato di firma: D5:4C:E2:69:90:7A:FE:E5:0C:1F:E6:73:70:98:38:DD:15:16:29:CC:B0:35:4C:ED:FB:0F:98:F6:E6:5D:15:AE.

Installazione passo per passo

Scarica jumphp-runtime-android.apk dalla pagina delle versioni (la più recente runtime-android-v…). Chrome può chiedere «Questo tipo di file può danneggiare il dispositivo»: tocca Conserva (o Scarica comunque).
Apri il file scaricato. Android dice «Per sicurezza, il telefono non può installare app sconosciute da questa origine»: tocca Impostazioni e attiva Consenti da questa origine (vale per il tuo browser, es. Chrome). Se non si apre nulla: Impostazioni → App → Accesso speciale → Installa app sconosciute → il tuo browser → Consenti. Torna indietro e tocca Installa.
Se Google Play Protect mostra «Bloccata», «App bloccata per proteggere il dispositivo» o «Analizzare l'app?»: tocca Maggiori dettagli → Installa comunque (o Installa senza analizzare). Su Xiaomi può comparire un'altra domanda di sicurezza: accetta.
Apri JumPHP runtime. Consenti le notifiche quando Android lo chiede (Android 13+): le domande («Consentire questa applicazione?») arrivano come notifiche.
Parte da sola (Stato: ATTIVO, una notifica resta visibile). Tocca Mantenerlo attivo e scegli Non ottimizzata / Senza restrizioni per la batteria, così Android non la ferma.
Su Xiaomi, Huawei, Oppo, Vivo, OnePlus, Samsung… tocca anche Avvia con il telefono (avvio automatico) e attivalo: altrimenti il telefono non riavvia l'app dopo un riavvio.
Tornato sulla pagina dell'applicazione, la spia diventa arancione: tocca Allow this app. Una notifica chiede «Consentire …?»: toccala e scegli Sempre. La spia diventa verde.

Serve la modalità sviluppatore?

No. Le opzioni sviluppatore e il debug USB non servono per installare un .apk dal browser. Serve solo il permesso «Installa app sconosciute» per il browser (passo 2). Puoi disattivarlo dopo.

Aggiornamenti

L'app cerca una versione più recente ogni 6 ore (e quando la apri). Compaiono una notifica e un pulsante Installa: Android verifica che il nuovo file sia firmato con la stessa chiave, confermi e basta.

Problemi

App non installata: sul telefono c'è una copia più vecchia firmata con un'altra chiave. Disinstallala e reinstalla.
Si ferma dopo un riavvio: attiva l'avvio automatico (passo 6) e l'impostazione batteria (passo 5).
La spia resta rossa: apri l'app (deve dire Stato: ATTIVO), poi ricarica la pagina; oppure tocca Start / install the app nella pagina.
La domanda non appare: consenti le notifiche dell'app (Impostazioni → App → JumPHP runtime → Notifiche).

Su iPhone non è possibile (nessun servizio in background con una porta locale): l'applicazione continua a collegarsi tramite il server jumphp.net.

Vedi anche: JumPHP runtime.