Per installare e sviluppare applicazioni, e quindi studiare il software sul dispositivo, sono necessari tre requisiti fondamentali: la modalità di debug (che è discrezione del dispositivo), ADB e strumenti di sviluppo (installati sul computer).

La possibilità di eseguire il debug su un dispositivo ti consente, in modo completo, tramite ADB, di controllare i dati e analizzare i processi, agire in caso di malfunzionamenti, sviluppare e installare app, eseguire il root e personalizzare il tuo dispositivo liberamente .... come dovrebbe essere per chiunque acquisti un prodotto!

Codici di debug su KaiOS

• Comporre il codice segreto *#*#33284#*#*per semplificare la memoria supponendo di scrivere *#*#debug#*#*con la tastiera. Un'icona di bug dovrebbe apparire nella barra delle applicazioni di sistema sopra.

Questo non funzionerà per tutti i dispositivi KaiOS, prova solo se è abilitato. Se non è abbastanza per eseguire il debug con ADB, prova ad aggiungere un altro codice, ad esempio su alcuni modelli Spreadtrum (come Positivo P70S) funziona *#*#0574#*#*. È necessario abilitare la voce da un menu.

Abilita il debugger da Impostazioni

• Apri l' app Impostazioni e segui questo flusso: Dispositivo > Sviluppatore > Debugger > ADB e DevTools

Dopodiché, dovresti vedere il tuo dispositivo nell'elenco DISPOSITIVI USB ... dovrebbe!

Il menu esiste, è il /elements/developer.htmlfile nascosto per impostazione predefinita nell'app Impostazioni (/ system/b2g/webapps/settings.gaiamobile.org/application.zip), a scelta del produttore del dispositivo. L'applicazione di un ripristino di fabbrica privilegiato abilita tutte le funzionalità di debug. Le app OmniSD e Wallace di Luxferre includono una funzione in cui è possibile eseguire questo tipo speciale di ripristino delle impostazioni di fabbrica premendo il tasto # . Nel /js/app.js di OmniSD possiamo leggere:

case '#': //run the privileged factory reset

if(navigator.mozPower && navigator.mozPower.factoryReset) {

if(confirm('Do you really want to perform privileged factory reset? All your data will be wiped!'))

navigator.mozPower.factoryReset('root')

}

else {

alert('Error: factory reset capabilities not available')

}

break;

Il problema sarebbe risolto installando una di queste app sul dispositivo interessato ... ma come?

Dispositivi che non consentono il root / remount adb

Se si dispone dell'accesso ADB ma senza debug, è possibile verificare il problema in questo modo:

adb shell getprop ro.secure

dovrebbe restituire 1 come output. Fondamentalmente devi reimballare (il che è complicato) o ottenere un boot.img diverso . Le cose che stanno bloccando sono nel default.propfile, che deve essere impostato su:

• ro.secure=0

• ro.debuggable=1

• persist.service.adb.enable=1

Sfortunatamente senza mount / remount / root è difficile farlo.

Il Web Integrated Development Environment (WebIDE) è un IDE basato su browser che consente lo sviluppo di software o lo sviluppo Web. È possibile accedervi da un browser Web, come Google Chrome o Mozilla Firefox, consentendo un ambiente di lavoro portatile. Per Mozilla era un componente essenziale per lo sviluppo di Firefox OS, ma ora è tornato utile per KaiOS.

WebIDE ti consente di collegare gli Strumenti per sviluppatori Firefox a numerosi altri browser. Con esso, devi prima impostare uno o più " runtime (un ambiente in cui eseguirai e eseguirai il debug dell'app e che potrebbe essere un dispositivo KaiOS o un simulatore del sistema operativo Firefox installato sul desktop stesso)".

Successivamente, crei un'app o ne apri una esistente. Se si desidera creare una nuova app, è possibile iniziare con un modello che include la struttura della directory e la piastra di caldaia minima necessaria per iniziare, oppure un modello più completo che mostra come utilizzare un'API privilegiata.

WebIDE mostra i file della tua app in un albero e puoi modificarli e salvarli utilizzando un editor di sorgenti integrato. Naturalmente, non è necessario utilizzare l'editor integrato: è possibile sviluppare l'app completamente al di fuori di WebIDE e utilizzarlo solo per il debug. Infine, puoi installare l'app in uno dei runtime ed eseguirla. È quindi possibile aprire la solita suite di strumenti per sviluppatori (Inspector, Console, JavaScript Debugger e così via) per esaminare e modificare l'app in esecuzione.

Scegliere una versioni di WebIDE compatibile con KaiOS

Software alternativi a WebIDE (solo riga di comando)

• Gdeploy è un piccolo gestore di applicazioni multipiattaforma che può essere utilizzato anche come modulo / libreria NodeJS. Maggiori dettagli sul repository ufficiale (gitlab.com);

• Xpcshell (make-kaios-install) è uno strumento per installare app in pacchetto utilizzando i protocolli di debug remoto di KaiOS (vedi sopra). Maggiori dettagli sul repository ufficiale (github.com).

Come abbiamo già detto, KaiOS si basa su Firefox OS e come tale supporta applicazioni in HTML, JavaScript e CSS, come le pagine Web attuali che siamo abituati a utilizzare quotidianamente. Per certi aspetti possiamo vedere KaiOS come un browser trasformato in un sistema operativo.

Il nome "Boot2Gecko" suggerisce che in realtà il motore è Gecko , utilizzato in tutte le versioni di Firefox precedenti alla 57. Quando apri l'app Impostazioni e cerchi nella scheda "ulteriori informazioni", puoi vedere che la versione della piattaforma è 48.0a2 . Ciò conferma l'ipotesi che in realtà si tratta di un browser, Firefox 48 , come suggerito anche da alcune pagine Web che esploriamo, identificandoci con il browser di Mozilla .

Detto questo, possiamo supporre che le applicazioni che stiamo utilizzando non siano altro che le schede della navigazione di un normale browser. Questo ci fa anche capire che qualsiasi sito web può diventare una webapp. Pertanto, la possibilità di spostare un sito Web offline sul dispositivo lo rende una webapp a tutti gli effetti.

La struttura di un'app KaiOS

• Il file HTML è il sistema nervoso centrale di un'applicazione. In esso sono collegati tutti gli elementi che fanno parte di quella pagina, oppure nel file principale tutti gli elementi che fanno muovere l'applicazione. La struttura dell'applicazione viene avviata tramite un parametro, che richiede un file HTML (generalmente denominato "index.html") contenuto nel percorso specificato (generalmente nella cartella principale) e in cui vengono indicizzate le funzioni e le chiamate ai singoli componenti dell'applicazione. Usando questa regola ora sai come avviare la struttura nem manifest ("launch_path": "/index.html").

• CSS elenca gli stili e il rendering dell'app e dei suoi vari elementi HTML che verranno visualizzati all'utente finale. Fondamentalmente è la GUI dell'applicazione e a volte non è necessaria per applicazioni più semplici e di base (può essere sostituita da immagini);

• JavaScript è praticamente il sistema muscolo-scheletrico dell'applicazione e viene utilizzato per far muovere tutti gli elementi secondo le istruzioni fornite al loro interno;

• Il Manifest è il cuore e il sistema linfatico dell'applicazione. Contiene le istruzioni per spostare l'intera struttura della "pagina web". Senza di essa, l'applicazione non ha "vita".

Quali sono le autorizzazioni nel "manifest"

Il campo delle autorizzazioni nel manifest dell'app controlla l'accesso dell'app a varie API sensibili sul dispositivo (a volte chiamate WebAPI ). Le autorizzazioni sono distinte in tre tipi:

1. Web apps : hanno solo un livello base di autorizzazioni e non hanno accesso ad API privilegiate o interne.

2. App privilegiate : hanno tutte le autorizzazioni delle app Web e molto altro. Le app ospitate non possono essere privilegiate: devono essere app in pacchetto .

3. App interne (certificate) : dispongono di tutte le autorizzazioni per le app Web privilegiate e altro ancora. Le app certificate / interne possono essere installate su un dispositivo solo da Mozilla/Kaiostech o da un fornitore di dispositivi, non da sviluppatori di terze parti (come potresti essere tu).

Differenza tra app "host" e "offline"

Come abbiamo visto, per avviare un'app offline dobbiamo impostare il persorso di un file HTML al parametro "launch_path" del file "manifest.webapp". Per avviare un'app ospitata (hosted) è sufficiente solo il file manifest.webapp, in cui è necessario sostituire la riga "launch_path" con "start_url", e inserite il collegamento del sito Web.

Dato che disponiamo di molti dispositivi basati su Qualcomm , per alcuni di essi può essere bizzarro indovinare come accedere alla modalità EDL o come farlo correttamente. Per esempio:

• Su Alcatel Cingular Flip devi prima tenere premuti entrambi i tasti del volume, quindi solo uno di essi;

• Su CAT B35 devi tenere premuto * e #;

• Su Nokia 8110 4G devi tenere premuto Su e Giù e durante questo devi inserire il cavo.

È importante sapere prima come accedere alla modalità EDL sul dispositivo KaiOS. Puoi provare una varietà di combinazioni come quelle appena descritte.

Ecco la guida di base su come utilizzare la modalità EDL dei dispositivi basati su Qualcomm (siamo interessati a quelli che eseguono KaiOS e che dispongono dei bootloader più elementari) senza alcuna dipendenza proprietaria come QFIL.

L' utilità edl.py utilizzata in questa guida è stata originariamente creata da B. Kerler e la sua "istantanea" (funzionante per i nostri dispositivi MSM8905) può essere recuperata dal suo repository. Maggiori dettagli qui: EDL.PY - QC Firehose / Sahara Client su GitHub.com

Prerequisiti

• Python 3.7 a 64 bit

• android-platform-tools ( ADB e Fastboot, vedi la guida sopra )

• File binari del caricatore di Firehose EDL per il tuo dispositivo, molti dei quali sono disponibili su EDL.BANANAHACKERS.NET e nella nostra Raccolta Firehose su Google Gruppi

Installazione

1. Clona il repository;

2. Installa le dipendenze: sudo -H pip3 install pyusb pyserial capstone keystone-engine

Inoltre, se utilizzi Linux e riscontri problemi con l'accesso al dispositivo:

• Aggiungi blacklist qcserial a /etc/modprobe.d/blacklist.conf

• Copia 51-edl.rules in /etc/udev/rules.d

• Copia 50-android.rules in /etc/udev/rules.d

Come funziona EDL.PY (guida applicata a CAT B35)

• Per verificare se il Firehose loader funziona basta usare edl.py con un singolo parametro -loader:

python3 edl.py -loader generic_CAT_B35.mbn

Dovresti vedere qualcosa del genere:

Se non visualizzi il messaggio "Successfully uploaded programmer (Programmatore caricato correttamente)", significa che il binario del caricatore non funziona come previsto (firma errata, formato errato ecc.) e hai bisogno di un firehose diverso. Si noti che è necessario fornire il caricatore in qualsiasi ulteriore comando, ma potrebbe anche funzionare senza di esso se il caricatore è già stato inviato e accettato correttamente.

• Per ottenere il layout della partizione usa l'opzione " -printgpt" in edl.py:

python3 edl.py -loader generic_CAT_B35.mbn -printgpt

Dovresti ottenere qualcosa del genere:

Puoi anche scaricare la tabella delle partizioni non elaborata in un file con l'opzione -gpt [filename], in questo modo:

python3 edl.py -loader generic_CAT_B35.mbn -gpt gpt.img

Lo stesso vale per PBL ( -pbl [filename]), tabella di memoria ( -memtbl [filename]) e contenuti QFPROM ( -qfp [filename]), nel caso in cui ne abbiate mai bisogno:

python3 edl.py -loader generic_CAT_B35.mbn -pbl pbl.img

python3 edl.py -loader generic_CAT_B35.mbn -memtbl memtbl.img

python3 edl.py -loader generic_CAT_B35.mbn -qfp qfprom.img

• Lettura della partizione. Ora che abbiamo l'elenco delle partizioni, possiamo eseguire il backup di qualsiasi partizione dal dispositivo con l'opzione -r [partname] [filename]. Per esempio:

python3 edl.py -loader generic_CAT_B35.mbn -r recovery recovery.img

Ciò salverà il contenuto della partizione di ripristino nel file recovery.img. L'utility edl.py consente anche la lettura grezza da settore a settore, ma è possibile vedere il comando "help" se necessario.

• Cancella / esegui il flash delle partizioni partizioni

Infine, questa è la funzionalità di cui abbiamo più bisogno (insieme alla lettura, ovviamente).

Per cancellare una partizione, fornire l'opzione -e [partname]:

python3 edl.py -loader generic_CAT_B35.mbn -e recovery

Per eseguire il flash di una nuova immagine di partizione, fornire l'opzione -w [partname] [filename]:

python3 edl.py -loader generic_CAT_B35.mbn -w recovery recovery.img

Questo scriverà il contenuto della partizione di ripristino dal file recovery.img. L'utility edl.py consente anche la scrittura grezza da settore a settore, ma sei invitato a usare il comando "help"aiutare se è necessario.

• Riavvia il dispositivo

Dopo aver completato tutte le operazioni necessarie, è conveniente riavviare il dispositivo in una modalità normale con l'opzione -reset:

python3 edl.py -loader generic_CAT_B35.mbn -reset