Jack è la toolchain di build predefinita di Android per Android 6.0 - 8.1.
Jack è una toolchain di Android che ha compilato il codice sorgente Java in bytecode dex di Android. Non devi fare nulla di diverso per utilizzare Jack: usa i comandi makefile standard per compilare l'albero o il progetto. Android 8.1 è l'ultima release che utilizza Jack.
Informazioni su Jack
Jack funziona come mostrato nella Figura 1.
Figura 1. Panoramica di Jack.
Formato della libreria Jack
Jack ha il proprio formato di file .jack che contiene il codice dex precompilato per la libreria, consentendo una compilazione più rapida (pre-dex).
Figura 2. Contenuto del file della libreria Jack.
Jill
Come mostrato nella figura seguente, lo strumento Jill traduce le librerie .jar esistenti nel nuovo formato di libreria.
Figura 3. Flusso di lavoro per importare una libreria .jar esistente.
Server di compilazione Jack
La prima volta che viene utilizzato Jack, viene avviato un server di compilazione Jack locale sul computer. Questo server:
- Offre un'accelerazione intrinseca perché evita di avviare una nuova JVM JRE host, caricare il codice Jack, inizializzare Jack e riscaldare il JIT a ogni compilazione. Fornisce inoltre tempi di compilazione molto buoni durante le compilazioni di piccole dimensioni (ad esempio, in modalità incrementale).
- È una soluzione a breve termine per controllare il numero di compilazioni Jack parallele. Il server evita di sovraccaricare il computer (problema di memoria o disco) perché limita il numero di compilazioni parallele.
Il server Jack si spegne dopo un periodo di inattività senza alcuna compilazione.
Utilizza due porte TCP sull'interfaccia localhost e non è disponibile esternamente. Tutti i parametri (numero di compilazioni parallele, timeout, numero di porte e così via) possono essere modificati modificando il file $HOME/.jack.
File $HOME/.jack
Il file $HOME/.jack contiene le seguenti impostazioni per le variabili del server Jack in una sintassi bash completa:
SERVER=trueabilita la funzionalità del server di Jack.SERVER_PORT_SERVICE=8072imposta il numero di porta TCP del server per scopi di compilazione.SERVER_PORT_ADMIN=8073imposta il numero di porta TCP del server per scopi di amministrazione.SERVER_COUNT=1non viene utilizzato.SERVER_NB_COMPILE=4imposta il numero massimo di compilazioni parallele consentite.SERVER_TIMEOUT=60imposta il numero di secondi di inattività che il server deve attendere senza alcuna compilazione prima di spegnersi.SERVER_LOG=${SERVER_LOG:=$SERVER_DIR/jack-$SERVER_PORT_SERVICE.log}imposta il file in cui vengono scritti i log del server. Per impostazione predefinita, questa variabile può essere sottoposta a overload da una variabile di ambiente.JACK_VM_COMMAND=${JACK_VM_COMMAND:=java}imposta il comando predefinito utilizzato per avviare una JVM sull'host. Per impostazione predefinita, questa variabile può essere sottoposta a overload da una variabile di ambiente.
Risolvere i problemi di compilazione di Jack
| Problema | Azione |
|---|---|
| Il computer smette di rispondere durante la compilazione o si verificano errori di compilazione di Jack a causa di Out of memory error | Riduci il numero di compilazioni Jack simultanee modificando $HOME/.jack e modificando SERVER_NB_COMPILE con un valore inferiore. |
| Le compilazioni non riescono a causa di Cannot launch background server | La causa più probabile è che le porte TCP siano già utilizzate sul computer. Modifica le porte modificando $HOME/.jack (variabili SERVER_PORT_SERVICE e SERVER_PORT_ADMIN). Per sbloccare la situazione, disattiva il
server di compilazione Jack modificando $HOME/.jack e modificando
SERVER in false. Purtroppo, questa operazione rallenta notevolmente
la compilazione e potrebbe costringerti ad avviare make -j con il controllo del carico (opzione -l di make). |
| La compilazione si blocca senza alcun avanzamento | Per sbloccare la situazione, arresta il server di sfondo Jack utilizzando jack-admin kill-server, quindi rimuovi le directory temporanee contenute in jack-$USER della directory temporanea (/tmp o $TMPDIR). |
Trovare il log di Jack
Se hai eseguito un comando make con una destinazione di distribuzione, il log di Jack si trova in $ANDROID_BUILD_TOP/out/dist/logs/jack-server.log.
In caso contrario, puoi trovare il log eseguendo jack-admin server-log.
In caso di errori di Jack riproducibili, puoi ottenere un log più dettagliato impostando la seguente variabile:
export ANDROID_JACK_EXTRA_ARGS="--verbose debug --sanity-checks on -D sched.runner=single-threaded"
Utilizza i comandi makefile standard per compilare l'albero (o il progetto) e collegare l'output standard e l'errore. Per rimuovere i log di build dettagliati, esegui:
unset ANDROID_JACK_EXTRA_ARGS
Limitazioni di Jack
Per impostazione predefinita, il server Jack può essere utilizzato da un solo utente su un computer. Per supportare altri utenti, seleziona numeri di porta diversi per ogni utente e modifica SERVER_NB_COMPILE di conseguenza. Puoi anche disattivare il server Jack impostando SERVER=false in $HOME/.jack.
La compilazione CTS è lenta a causa dell'integrazione corrente di vm-tests-tf.
Gli strumenti di manipolazione del bytecode (come JaCoCo) non sono supportati.
Utilizzare Jack
Jack supporta il linguaggio di programmazione Java 1.7 e integra le funzionalità aggiuntive descritte di seguito.
Pre-dex
Quando viene generato un file della libreria Jack, il file .dex della libreria viene generato e archiviato all'interno del file della libreria .jack come pre-dex.
Durante la compilazione, Jack riutilizza il pre-dex di ogni libreria. Tutte le librerie sono pre-dexed.
Figura 4. Librerie Jack con pre-dex.
Jack non riutilizza il pre-dex della libreria se nella compilazione vengono utilizzati la riduzione, l'offuscamento o la ripacchettizzazione.
Compilazione incrementale
La compilazione incrementale significa che vengono ricompilati solo i componenti modificati dall'ultima compilazione (e le relative dipendenze). La compilazione incrementale può essere notevolmente più veloce di una compilazione completa quando le modifiche sono limitate a un insieme di componenti.
La compilazione incrementale è disattivata per impostazione predefinita (e viene disattivata automaticamente quando è abilitata la riduzione, l'offuscamento, la ripacchettizzazione o il multi-dex legacy). Per abilitare le build incrementali, aggiungi la seguente riga al file Android.mk del progetto che vuoi compilare in modo incrementale:
LOCAL_JACK_ENABLED := incremental
Riduzione e offuscamento
Jack utilizza i file di configurazione di ProGuard per abilitare la riduzione e l'offuscamento.
Le opzioni comuni includono:
@-include-basedirectory-injars-outjars(è supportato solo 1 jar di output)-libraryjars-keep-keepclassmembers-keepclasseswithmembers-keepnames-keepclassmembernames-keepclasseswithmembernames-printseeds
Le opzioni di riduzione includono:
-dontshrink
Le opzioni di offuscamento includono:
-dontobfuscate-printmapping-applymapping-obfuscationdictionary-classobfuscationdictionary-packageobfuscationdictionary-useuniqueclassmembernames-dontusemixedcaseclassnames-keeppackagenames-flattenpackagehierarchy-repackageclasses-keepattributes-adaptclassstrings
Le opzioni ignorate includono:
-dontoptimize(Jack non ottimizza)-dontpreverify(Jack non esegue la pre-verifica)-skipnonpubliclibraryclasses-dontskipnonpubliclibraryclasses-dontskipnonpubliclibraryclassmembers-keepdirectories-target-forceprocessing-printusage-whyareyoukeeping-optimizations-optimizationpasses-assumenosideeffects-allowaccessmodification-mergeinterfacesaggressively-overloadaggressively-microedition-verbose-dontnote-dontwarn-ignorewarnings-printconfiguration-dump
Ripacchettizzazione
Jack utilizza i file di configurazione jarjar per eseguire la ripacchettizzazione. Sebbene Jack sia compatibile con i tipi di regole "rule", non è compatibile con i tipi di regole "zap" o "keep".
Supporto multidex
Jack offre supporto multidex integrato e legacy. Poiché i file dex sono limitati a 65.000 metodi, le app con più di 65.000 metodi devono essere suddivise in più file dex. Per maggiori dettagli, consulta Abilitare multidex per le app con più di 64.000 metodi