Prima del rilascio di Android 7.0, Android utilizzava GNU Make esclusivamente per descrivere ed eseguire le proprie regole di build. Il sistema di compilazione Make è ampiamente supportato e utilizzato, ma sulla scala di Android è diventato lento, soggetto a errori, inscalabile e difficile da testare. Il sistema di build Soong offre la flessibilità necessaria per le build Android.
Per questo motivo, gli sviluppatori di piattaforme dovrebbero effettuare il passaggio da Make and Adotti Soong il prima possibile. Invia domande al gruppo Google android-building per ricevere assistenza.
Cos'è Quickg?
Il sistema di build Chooseg è stato introdotto in Android 7.0 (Nougat) per sostituire Make. Sfrutta lo strumento Kati GNU Make clone e il componente di sistema di build Ninja per velocizzare le build di Android.
Consulta la descrizione Android Make Build System nell'Android Open Source Project (AOSP) per istruzioni generali e Build System changes for Android.mk Writers per scoprire le modifiche necessarie per l'adattamento da Make a soong.
Consulta le voci relative alla build nel glossario per le definizioni dei termini chiave e i file di riferimento dei brani Soong per i dettagli completi.
Confronto tra Make e soong
Ecco un confronto tra la configurazione di Make e la configurazione di Prestog in un file di configurazione (Blueprint o .bp)
Fai un esempio
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := libxmlrpc++
LOCAL_MODULE_HOST_OS := linux
LOCAL_RTTI_FLAG := -frtti
LOCAL_CPPFLAGS := -Wall -Werror -fexceptions
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/src
LOCAL_SRC_FILES := $(call \
all-cpp-files-under,src)
include $(BUILD_SHARED_LIBRARY)
Esempio di Presto
cc_library_shared {
name: "libxmlrpc++",
rtti: true,
cppflags: [
"-Wall",
"-Werror",
"-fexceptions",
],
export_include_dirs: ["src"],
srcs: ["src/**/*.cpp"],
target: {
darwin: {
enabled: false,
},
},
}
Per esempi di configurazione di soong specifici per il test, vedi Configurazione semplice della build.
Per una spiegazione dei campi in un file Android.bp, consulta la pagina relativa al formato file Android.bp.
Moduli speciali
Alcuni gruppi di moduli speciali hanno caratteristiche uniche.
Moduli predefiniti
Un modulo predefinito può essere utilizzato per ripetere le stesse proprietà in più moduli. Ecco alcuni esempi:
cc_defaults {
name: "gzip_defaults",
shared_libs: ["libz"],
stl: "none",
}
cc_binary {
name: "gzip",
defaults: ["gzip_defaults"],
srcs: ["src/test/minigzip.c"],
}
Moduli predefiniti
Alcuni tipi di moduli predefiniti consentono a un modulo di avere lo stesso nome delle sue controparti basate sull'origine. Ad esempio, può essere presente un elemento cc_prebuilt_binary
denominato foo quando esiste già un elemento cc_binary con lo stesso nome. Questo offre agli sviluppatori la flessibilità di scegliere quale versione includere nel prodotto finale. Se una configurazione di compilazione contiene entrambe le versioni, il valore del flag prefer
nella definizione del modulo predefinito indica quale versione ha la priorità.
Tieni presente che alcuni moduli predefiniti hanno nomi che non iniziano con prebuilt,
ad esempio android_app_import.
Moduli dello spazio dei nomi
Finché Android non esegue completamente la conversione da Make a soong, la configurazione del prodotto
deve specificare un valore PRODUCT_SOONG_NAMESPACES. Il suo valore
deve essere un elenco di spazi dei nomi separati da spazi che soong esporta in Make
per essere creati dal comando m. Una volta completata la conversione di Android in Presto,
i dettagli dell'abilitazione degli spazi dei nomi potrebbero cambiare.
prestog offre ai moduli in directory diverse la possibilità di specificare lo stesso nome, purché ogni modulo venga dichiarato all'interno di uno spazio dei nomi separato. Uno spazio dei nomi può essere dichiarato in questo modo:
soong_namespace {
imports: ["path/to/otherNamespace1", "path/to/otherNamespace2"],
}
Tieni presente che uno spazio dei nomi non ha una proprietà name; il relativo percorso viene assegnato automaticamente come nome.
A ogni modulo Takeg viene assegnato uno spazio dei nomi in base alla sua posizione nell'albero.
Ogni modulo soong è considerato nello spazio dei nomi definito da soong_namespace trovato in un file Android.bp nella directory attuale o nella directory predecessore più vicina. Se non viene trovato alcun modulo soong_namespace di questo tipo, il modulo viene considerato nello spazio dei nomi radice implicito.
Ecco un esempio: soong tenta di risolvere la dipendenza D dichiarata dal modulo M nello spazio dei nomi N che importa gli spazi dei nomi I1, I2, I3...
- Se D è un nome completo nel formato
//namespace:module, viene cercato solo lo spazio dei nomi specificato per il nome del modulo specificato. - Altrimenti, soong cerca prima un modulo denominato D dichiarato nello spazio dei nomi N.
- Se quel modulo non esiste, soong cerca un modulo denominato D negli spazi dei nomi I1, I2, I3...
- Infine, prestog cerca nello spazio dei nomi principale.