[GUIDA]updater-script + creazione di un update.zip

[S_mario]

Qualsiasi vostro aiuto è sempre bene accetto

Questa guida vi aiutera a capire come creare uno zip flashabile da recovery e scrivere il vostro primo Updater-script.

Breve spiegazie:
L'updater.script (update.script nelle recovery amend) è quel file che contiente tutte le operazioni che il terminale deve eseguire durante il flash di un pacchetto.
Senza l'updater.script un qualsivoglia pacchetto non si flasherebbe, e senza una corretta sintassi accadrebbe lo stesso,
o peggio ancora potrebbe interrompersi l'operazione nella riga dove è situato l'errore e quindi ci potrebbero essere rischi di brick al cellulare.

FATE SEMPRE UN BACKUP DI SICUREZZA

---------------------------------
Casa ci serve:
- notepad++ ( per utenti windows )
- Gedit ( per utenti Linux )
- Tool SIGN pachetto (per windws)
- Molta Pazienza e attenzione
--------------------------------

- Creare le directory per lo zip:

/zip_template/META-INF/com/google/android/

- Zip_Template.zip
  -META/INF (cartella)
    -com (cartella)
      -google (cartella)
	-android (cartella)
	  - update-binary ( file senza estensione )
	  - updater-script ( file senza estensione )
  -system ( contiene tutto quello che deve essere flashato sul device )

Il pacchetto qui sotto è vuoto utilizzatelo per i primi passi
DOWNALOAD TEMPLATE.ZIP

---------------------------------
- Comandi per creare updater-script
1- Il file (se partite da un file di testo vuoto) va salvato con estensione .FILE
2- Ogni riga dell'updater.script va concluso con il ";"
3- Se il file interessato si chiama update.script qundi senza la r si tratta di una versione amend,
quindi fate attenzione a leggere correttamente il nome del file
------------------------------
- GetProp
Sintassi:

assert(getprop("ro.product.device") == "hammerhead" || getprop("ro.build.product") == "hammerhead" || abort("This package is for \"hammerhead\" devices; this is a \"" + getprop("ro.product.device") + "\"."););
assert(getprop("ro.bootloader") == "HHZ11k");

Le linee getprop vengono usate per una installazione sicura.

Esempio:
Questo aggiornamento-script è per il nexu 5, la stringa "GetProp fa una verifica con in build.prop se il nome del prodotto corrisponde "ro.product.device è hammeread e il getprop("ro.bootloader") è uguale a "HHZ11K" allora l'installazione può continuare. Se invece una di queste voci non corrisponde al vero lo script si interrompe dando errore.

----------------------------
Mostra Progresso installazione

show progress:

- show progress -->controlla la barra di completamento
del processo di installazione che vedete comparire in basso
sulla recovery.

sintassi:

show_progress(primo numero, secondo numero);

Il primo numero indica di quanto deve avanzare la barra,
il secondo in quanto tempo deve avvenire l'avanzamento
specificato dal primo numero.
Da sapere che la lunghezza totale della barra è 1,33.
Inoltre il tempo indicato dal secondo numero è espresso in secondi.

esempio:

showprogress(1.33, 60) ---> la barra di completamento si
riempirà al 100% in 60 secondi.

Attenzione!:

oltre 1,33 la barra aggiunge un pezzettino alla fine
risultando in un bruttissimo effetto grafico.
Quindi potete scegliere di spezzettare
il comando show progress nel proseguio
dello script ma attenzione a non superare come somma l' 1,33.

Ad esempio:

showprogress(0.5, 20)
...
....
....
...
....
showprogress(0.5, 15)
...
....
...showprogress(0.33, 20)

come vedete (0,5+0,5+0,33 = 1,33)

-------------------------------------------

-Sintassi: ui_print("");

Questo comando stampa a video nella recovery,
tutto quello che è all'interno della sintassi.
In questo caso, la recovery stamapa a video:
Zip_tamplate
By S_mario
Guida alla creazione di update.zip flashabile

ESEMPIO:

ui_print(" Zip_tamplate ");
ui_print("  By S_mario  ");
ui_print("");
ui_print(" Guida alla creazione di update.zip flashabile ");

In questo caso, la recovery stamapa a video:
Zip_tamplate
By S_mario
Guida alla creazione di update.zip flashabile

----------------------------------------------------------

[S_mario]

Per altri device: (in test)
Per vedere come sono nominate le partizioni di altri device,
bisogna utilizzare "ADB SHELL" da riga di comando, ogni dispositivo ha un nome diverso.

Per Linux ( che è il mio sistema operativo ) per windows credo che sia uguale:

sdk sempre installato, collegate il device in debug usb

adb shell
ls -al /dev/block/platform/da qui bisogna cercare in tutte le cartelle "by-name"/by-name

Questo è relativo al mio nexus 5, per gli atri device dovrebbe essere simile.

Spoiler:

shell@hammerhead:/dev/block/platform/msm_sdcc.1/by-name $ ls DDR aboot abootb boot cache crypto fsc fsg grow imgdata laf metadata misc modem modemst1 modemst2 pad persist recovery rpm rpmb sbl1 sbl1b sdi ssd system tz tzb userdata

- Montaggio Partizioni ( io mi riferisco al nexus 5):

-EMMC

mount("ext4", "EMMC", "/dev/block/platform/msm_sdcc.1/by-name/system", "/system");
mount("ext4", "EMMC", "/dev/block/platform/msm_sdcc.1/by-name/data", "/data");
mount("ext4", "EMMC", "/dev/block/platform/msm_sdcc.1/by-name/cache", "/cache");

ESEMPIO:

ui_print(" Monto partizione system ");
mount("ext4", "EMMC", "/dev/block/platform/msm_sdcc.1/by-name", "/system");

Questo comando monta la partizione system e stampa a video
"MONTO PARTIZIONE SYSTEM"

----------------------------

- Smontaggio Partizioni:

unmount("/system");
unmount("/data"); OR unmount("/userdata");
unmount("/cache");
unmount("/sdcard");

Esempio:

ui_print(" Smonto partizione system ");
unmount("/system");

Questo comando serve per smontare le partizioni
montate in precedenza.
Nel mio esempio precedente ho montato la partizione "system",
ovviamente ho dovuto smontarla con sinstassi "unmount("/system");"

----------------------------------------

- Formattare partizione
-

"esegue la formattazione del System"

format("ext4", "EMMC", "/dev/block/platform/msm_sdcc.1/by-name/system", "0", "/system");

-

"esegue la formattazione del data"

format("ext4", "EMMC", "/dev/block/platform/msm_sdcc.1/by-name/data", "/data");

-

"esegue la formattazione della Cache"

format("ext4", "EMMC", "/dev/block/platform/msm_sdcc.1/by-name/cache", "/cache");

[S_mario]

---------------------------


- Run Program

Il comando run program esegue semplicemte un programma

Sintassi :

run_program("/sbin/busybox", "mount", "/data");

esegue il comando "mount" del busybox installato nel dispositivo per montare la partizione "data"

Ci sono anche altri comandi che si posso dare con il "run_program".
------------

[S_mario]

- Symlink o SymboliLink

I link simbolico non è altro che delle scorciatoie, per esempio se è richiesto un file in due luoghi diversi, invece di copia incollando il file di in due luoghi diversi, il file viene copiato in una delle due sedi e in altro luogo un collegamento al file (link simbolico)viene creato. La fonte e il link simbolico possono avere nomi diversi (in realtà questo è l'uso primario di link simbolici). Per spiegare in un modo amichevole, prendere il link simbolico di cui sopra, crea un collegamento (link simbolico) per il comando "mksh" e lo inserisce nel percorso del sistema operativo. Il collegamento (link simbolico) dirige al file "/ system / bin / sh", quindi, quando il sistema operativo riceve una richiesta
per eseguire il comando "mksh", l'attuale
binario che viene eseguito sarà "/ system / bin / sh". Creazione di collegamenti simbolici risparmia un sacco di spazio,
perché invece di copiare l'intero file e l'immissione in luoghi Requiered siamo appena la creazione di collegamenti che dirige al file sorgente, che può essere posizionato in qualsiasi punto del file system (in genere collocata nel percorso del sistema operativo).

Sinatssi completa da non modificare mai ( ESTRATTO DALLO ZIP UPDATE ALLA 4.4.3 nexus 5):

symlink("../xbin/su", "/system/bin/su");
symlink("Roboto-Bold.ttf", "/system/fonts/DroidSans-Bold.ttf");
symlink("Roboto-Regular.ttf", "/system/fonts/DroidSans.ttf");
symlink("busybox", "/system/xbin/[", "/system/xbin/[[",
	"/system/xbin/adjtimex", "/system/xbin/arp", 
	"/system/xbin/ash",
        "/system/xbin/awk", 
	"/system/xbin/base64", "/system/xbin/basename",
	"/system/xbin/bbconfig", "/system/xbin/blkid", 
	"/system/xbin/blockdev", "/system/xbin/brctl",
	"/system/xbin/bunzip2", "/system/xbin/bzcat", 
	"/system/xbin/bzip2", "/system/xbin/cal",
	"/system/xbin/cat", "/system/xbin/catv", 
	"/system/xbin/chattr", "/system/xbin/chgrp", 
	"/system/xbin/chmod", "/system/xbin/chown", 
	"/system/xbin/chroot", "/system/xbin/clear", 
	"/system/xbin/cmp", "/system/xbin/comm", 
	"/system/xbin/cp", "/system/xbin/cpio", 
	"/system/xbin/crond", "/system/xbin/crontab", 
	"/system/xbin/cut", "/system/xbin/date", 
	"/system/xbin/dc", "/system/xbin/dd", 
	"/system/xbin/depmod", "/system/xbin/devmem", 
	"/system/xbin/df", "/system/xbin/diff", 
	"/system/xbin/dirname", "/system/xbin/dmesg", 
	"/system/xbin/dnsd", "/system/xbin/dos2unix", 
	"/system/xbin/du", "/system/xbin/echo", 
	"/system/xbin/ed", "/system/xbin/egrep", 
	"/system/xbin/env", "/system/xbin/expand", 
	"/system/xbin/expr", "/system/xbin/false", 
	"/system/xbin/fbsplash", "/system/xbin/fdisk", 
	"/system/xbin/fgrep", "/system/xbin/find", 
	"/system/xbin/flash_lock", "/system/xbin/flash_unlock", 
	"/system/xbin/flashcp", "/system/xbin/flock", 
	"/system/xbin/fold", "/system/xbin/free", 
	"/system/xbin/freeramdisk", "/system/xbin/fstrim", 
	"/system/xbin/fsync", "/system/xbin/ftpget", 
	"/system/xbin/ftpput", "/system/xbin/fuser", 
	"/system/xbin/getopt", "/system/xbin/grep", 
	"/system/xbin/groups", "/system/xbin/gunzip", 
	"/system/xbin/gzip", "/system/xbin/halt", 
	"/system/xbin/head", "/system/xbin/hexdump", 
	"/system/xbin/id", "/system/xbin/ifconfig", 
	"/system/xbin/inetd", "/system/xbin/insmod", 
	"/system/xbin/install", "/system/xbin/ionice", 
	"/system/xbin/iostat", "/system/xbin/ip", 
	"/system/xbin/kill", "/system/xbin/killall", 
	"/system/xbin/killall5", "/system/xbin/less", 
	"/system/xbin/ln", "/system/xbin/losetup", 
	"/system/xbin/ls", "/system/xbin/lsattr", 
	"/system/xbin/lsmod", "/system/xbin/lsusb", 
	"/system/xbin/lzcat", "/system/xbin/lzma", 
	"/system/xbin/lzop", "/system/xbin/lzopcat", 
	"/system/xbin/man", "/system/xbin/md5sum", 
	"/system/xbin/mesg", "/system/xbin/mkdir", 
	"/system/xbin/mke2fs", "/system/xbin/mkfifo", 
	"/system/xbin/mkfs.ext2", "/system/xbin/mkfs.vfat", 
	"/system/xbin/mknod", "/system/xbin/mkswap", 
	"/system/xbin/mktemp", "/system/xbin/modinfo", 
	"/system/xbin/modprobe", "/system/xbin/more", 
	"/system/xbin/mount", "/system/xbin/mountpoint", 
	"/system/xbin/mpstat", "/system/xbin/mv", 
	"/system/xbin/nanddump", "/system/xbin/nandwrite", 
	"/system/xbin/nbd-client", "/system/xbin/netstat", 
	"/system/xbin/nice", "/system/xbin/nohup", 
	"/system/xbin/nslookup", "/system/xbin/ntpd", 
	"/system/xbin/od", "/system/xbin/patch", 
	"/system/xbin/pgrep", "/system/xbin/pidof", 
	"/system/xbin/ping", "/system/xbin/pipe_progress", 
	"/system/xbin/pkill", "/system/xbin/pmap", 
	"/system/xbin/poweroff","/system/xbin/printenv", 
	"/system/xbin/printf", "/system/xbin/ps", 
	"/system/xbin/pstree", "/system/xbin/pwd", 
	"/system/xbin/pwdx", "/system/xbin/rdev", 
	"/system/xbin/readlink", "/system/xbin/realpath", 
	"/system/xbin/renice", "/system/xbin/reset", 
	"/system/xbin/resize", "/system/xbin/rev", 
	"/system/xbin/rm", "/system/xbin/rmdir", 
	"/system/xbin/rmmod", "/system/xbin/route", 
	"/system/xbin/run-parts", "/system/xbin/rx", 
	"/system/xbin/sed", "/system/xbin/seq", 
	"/system/xbin/setconsole", "/system/xbin/setserial", 
	"/system/xbin/setsid", "/system/xbin/sh", 
	"/system/xbin/sha1sum", "/system/xbin/sha256sum", 
	"/system/xbin/sha3sum", "/system/xbin/sha512sum", 
	"/system/xbin/sleep", "/system/xbin/sort", 
	"/system/xbin/split", "/system/xbin/stat", 
	"/system/xbin/strings", "/system/xbin/stty", "/system/xbin/sum", 
	"/system/xbin/swapoff", "/system/xbin/swapon", "/system/xbin/sync", 
	"/system/xbin/sysctl","/system/xbin/tac", 
	"/system/xbin/tail", "/system/xbin/tar", 
	"/system/xbin/taskset", "/system/xbin/tee", 
	"/system/xbin/telnet", "/system/xbin/telnetd", 
	"/system/xbin/test", "/system/xbin/tftp", 
	"/system/xbin/tftpd", "/system/xbin/time", 
	"/system/xbin/timeout", "/system/xbin/top", 
	"/system/xbin/touch", "/system/xbin/tr", 
	"/system/xbin/traceroute", "/system/xbin/true", 
	"/system/xbin/ttysize", "/system/xbin/tune2fs", 
	"/system/xbin/umount", "/system/xbin/uname", 
	"/system/xbin/uncompress", "/system/xbin/unexpand", 
	"/system/xbin/uniq", "/system/xbin/unix2dos", 
	"/system/xbin/unlzma", "/system/xbin/unlzop", 
	"/system/xbin/unxz", "/system/xbin/unzip", 
	"/system/xbin/uptime", "/system/xbin/usleep", 
	"/system/xbin/uudecode", "/system/xbin/uuencode", 
	"/system/xbin/vi", "/system/xbin/watch", 
	"/system/xbin/wc", "/system/xbin/wget", 
	"/system/xbin/which", "/system/xbin/whoami", 
	"/system/xbin/xargs", "/system/xbin/xz", 
	"/system/xbin/xzcat", "/system/xbin/yes", 
	"/system/xbin/zcat");
symlink("libGLESv2.so", "/system/lib/libGLESv3.so");
symlink("mksh", "/system/bin/sh");
symlink("toolbox", "/system/bin/cat", "/system/bin/chcon",
	"/system/bin/chmod", "/system/bin/chown", "/system/bin/clear", 
	"/system/bin/cmp", "/system/bin/cp", "/system/bin/date", 
	"/system/bin/dd", "/system/bin/df", "/system/bin/dmesg", 
	"/system/bin/du", "/system/bin/getenforce", "/system/bin/getevent", 
	"/system/bin/getprop", "/system/bin/getsebool", "/system/bin/grep", "/system/bin/hd", 
	"/system/bin/id", "/system/bin/ifconfig", "/system/bin/iftop", 
	"/system/bin/insmod", "/system/bin/ioctl", "/system/bin/ionice", 
	"/system/bin/kill", "/system/bin/ln", "/system/bin/load_policy", 
	"/system/bin/log", "/system/bin/ls", "/system/bin/lsmod", "/system/bin/lsof", 
	"/system/bin/md5", "/system/bin/mkdir", "/system/bin/mkswap", 
	"/system/bin/mount", "/system/bin/mv", "/system/bin/nandread", 
	"/system/bin/netstat", "/system/bin/newfs_msdos", "/system/bin/notify", 
	"/system/bin/printenv", "/system/bin/ps", "/system/bin/r", 
	"/system/bin/readlink", "/system/bin/renice", "/system/bin/restorecon", 
	"/system/bin/rm", "/system/bin/rmdir", "/system/bin/rmmod", 
	"/system/bin/route", "/system/bin/runcon", "/system/bin/schedtop", 
	"/system/bin/sendevent", "/system/bin/setconsole", 
	"/system/bin/setenforce", "/system/bin/setprop", 
	"/system/bin/setsebool", "/system/bin/sleep", "/system/bin/smd", 
	"/system/bin/start", "/system/bin/stop", "/system/bin/swapoff", 
	"/system/bin/swapon", "/system/bin/sync", "/system/bin/top", "
	"/system/bin/touch", "/system/bin/umount", "/system/bin/uptime", 
	"/system/bin/vmstat", "/system/bin/watchprops", "/system/bin/wipe");

[S_mario]

- Permessi


I tipi di permesso possono essere

1 - lettura (r)
2 - scrittura (w)
3 - esecuzione (x)

breve spiegazione:

abbiamo un file dove il proprietario può leggere e scrivere ( rw-) ,
il gruppo può solo leggere ( r–)
ed infine tutti quelli che non fanno parte del gruppo
possono solo leggere ( r– ).

rw-r-r

il sistama ottale è composto da tre cifre e definisce un un unica volta i vari tipi di permessi per proprietario, gruppo e utenti.
Questi tre numeri vengono calcolati sommando i seguenti valori ottali:

0 – Nessun permesso.
1 – Esecuzione. (x)
2 – Scrittura. (w)
4 – Lettura. (r)

Esempio:

set_perm(0, 0, 0644, "/system/etc/mixer_paths.xml");

con questo comando vado a settare i permessi al file "mixer_paths.xml"
con "RW-R-R"
ho impostato lettura e scrittura ( 4+2 = 6 ) per il proprietario e solo lettura ( 4 ) per gruppo e utenti

----------------------

Updater-Script completo

prendiamo in esempio di voler flhasare da recovery
uno zip contenente delle nuove suonerie.
Prima di tutto bisogna eliminare le vecchie suonerie stock e
succesimante installare le nuove, settare i giusti permessi
alle cartelle e file aggiunti.

Iniziamo...

1 -show_progress(1.000000, 0);
2 -ui_print(" ");
3 -ui_print(" iOS 7 Sounds ");
4 -ui_print(" ");
5 -ui_print(" ");
6 -mount("ext4", "EMMC", "/dev/block/mmcblk0p23", "/system");
7 -show_progress(0.25000);
8 -ui_print("delete sound of Google Stock");
9 -delete_recursive("/system/media/audio/ui");
10 -delete_recursive("/system/media/audio/notifications");
11 -delete_recursive("/system/media/audio/ringtones");
12 -ui_print("EXTRACT E INSTALL NEW SOUND");
13 -ui_print("Install Sound and fix permission");
14 -package_extract_dir("system/media/audio/ui", "/system/media/audio/ui");
15 -set_perm_recursive(0, 0, 0755, 0644, "/system/media/audio/ui");
16 -package_extract_dir("system/media/audio/ringtones", "/system/media/audio/ringtones");
17 -show_progress(0.50000);
18 -set_perm_recursive(0, 0, 0755, 0644, "/system/media/audio/ringtones");
19 -package_extract_dir("system/media/audio/notifications", "/system/media/audio/notifications");
20 -set_perm_recursive(0, 0, 0755, 0644, "/system/media/audio/notification");
21 -unmount("/system");
22 -show_progress(0.75000);
23 -ui_print("Good Sound iOS 7");
24 -ui_print("Reboot Your Nexus 5");
25 -ui_print(" ================= ");
26 -show_progress(1.000000);

esaminiamo cosa esegue questo zip..

1 - mostra il progresso della barra
2 - stampa a video il contenuto
3 - stampa a video il contenuto
4 - stampa a video il contenuto
5 - stampa a video il contenuto
6 - monta la partizione /system
7 - mostra il progresso al 25%
8 - stampa a video il contenuto
9 - elimina la cartella "UI"
10 - elimina la cartella "NOTIFICATION"
11 - elimina la cartella "RINGTONES"
12 - stampa a video il contenuto
13 - stampa a video il contenuto
14 - copia il contenuto dallo zip al device ( cartella "UI"
15 - setta i permessi alla cartella "UI"
16 - copia il contenuto dallo zip al device (cartlla "ringtones")
17 - mostra il progresso della barra al 50%
18 - setta i permessi alla cartella "ringtones"
19 - copia il contenuto dallo zip al device (cartlla "notifiche")
20 - setta i permessi alla cartella "notifiche"
21 - smonta la partizione "/SYSTEM"
22 - mostra il progresso della barra al 75%
23 - stampa a video il contenuto
24 - stampa a video il contenuto
25 - stampa a video il contenuto
26 - mostra il progresso della barra al 100%

[miseusegau]

Ottimo come sempre....Ps...hai un pm bro..

[leonardodettoileo]

Ottima guida Mario! Bravo!

[dadenet]

Troppo fica!
Ci voleva ottimo lavoro! ✌👏😀😉

[S_mario]

Troppo fica!
Ci voleva ottimo lavoro! ✌������

Bhe che dire Dade...mi hai messo la pulce nell'orecchio.
ora ti voglio vedere sbatterci il muso XD

Ottima guida Mario! Bravo!

leooo, grazie 1000, spamma a bestia che vale anche per il Gnexus

Ottimo come sempre....Ps...hai un pm bro..

Grazie Zio, visto e per dopo cena lo avrai

[S_mario]

Chiedo scusa se questo procedimento non è legale, nel caso lo fosse si può eliminare il post
FlashAppData.zip
Qui trovate il template per fare il backup delle app utenti ( quelle gratis che scaricate dal play store ) senza sbattervi utilizzando titanium.
A breve aggiungo anche i dati delle app.

Procedimento:
1- andare in radice root ed entrate nella cartella "data" poi nella cartella "app"
2- fate il copia di tutte le vostre app e salvarle nella SD .
3- da PC prendete le app e copiarle nello zip scaricato in questa directory:
/data/app ( se non trovate la cartella app dentro allo zip createla voi).

Per il flash :

Flashare prima la rom + gapps

Accendere il device configurare tutto tranne l'account google.
Riavviare in recovery ed effetture il flash dello zip.
Al riavvio del dispositivo configurare l'account google

UPDATER SCRIPT:

Spoiler:

[CODE]ui_print(""); ui_print("..................................."); ui_print(". ** Flash My app ** ."); ui_print(". --S_mario-- ."); ui_print("..................................."); ui_print(""); show_progress(0.250000, 3); ui_print("--> Installing My App"); run_program("/sbin/busybox", "mount", "/data"); show_progress(0.50000, 6); package_extract_dir("data/app", "/data/app"); unmount("/data"); ui_print(""); ui_print("...................................."); ui_print(" ---> Flash My App Is Complete