Um die Oberfläche von Symbolen und Typen zu reduzieren, die als stabil gehalten werden müssen, hat der GKI-Kernel die Möglichkeit, exportierte Symbole auf diejenigen zu beschränken, die von Modulen benötigt werden. Für extern kompilierte Module benötigen Sie eine Liste der verwendeten Symbole, damit sie vom GKI-Kernel exportiert werden können. Symbole, die von Modulen für Cuttlefish verwendet werden, werden beispielsweise in android/abi_gki_aarch64_virtual_device gespeichert.
Ziel für die Generierung der Symbolliste hinzufügen
Symbollisten werden vom kernel_abi-Ziel generiert. Fügen Sie das Ziel dem Gerät BUILD.bazel mit den folgenden Optionen hinzu:
nameEr sollte das Format
<kernel_build>_abihaben.kernel_buildMuss den Namen des Gerätes enthalten, das
kernel_buildals Ziel hat.
Sie haben auch die folgenden Möglichkeiten:
kernel_modulesListe der Ziele für Out-of-Tree-Module. In-Tree-Module sollten hier nicht enthalten sein. Weitere Informationen finden Sie unter Integrierte Module für die Symbolextraktion vorbereiten.
kmi_symbol_list_add_onlyMit dieser Option wird verhindert, dass nicht verwendete Symbole entfernt werden. Das Entfernen von Symbolen ist nur zu bestimmten Zeiten während der Stabilisierung des KMI zulässig und nicht mehr, sobald das KMI eingefroren ist.
Das ist auch nützlich, wenn Sie dieselbe Symbolliste für mehrere verschiedene Geräte verwenden. So werden keine Symbole entfernt, die von Gerät A, aber nicht von Gerät B verwendet werden.
module_groupingWenn
Trueoder nichts angegeben ist, werden Symbole in der Symbolliste nach den Kernelmodulen gruppiert, die auf das Symbol verweisen. Andernfalls ist die Symbolliste eine sortierte Liste der Symbole, die von allen Kernelmodulen verwendet werden.
Siehe z. B. common-modules/virtual-device/BUILD.bazel:
kernel_abi(
name = "virtual_device_aarch64_abi",
kernel_build = ":virtual_device_aarch64",
kernel_modules = [
":virtual_device_aarch64_external_modules",
],
kmi_symbol_list_add_only = True,
)
Weitere Informationen finden Sie in der Referenzdokumentation zum kernel_abi-Ziel in Kleaf.
In-Tree-Module für die Symbolextraktion vorbereiten
Wenn Sie In-Tree-Module für die Symbolextraktion vorbereiten möchten, listen Sie Anbieterspezifische In-Tree-Module in einem module_outs-Attribut des kernel_build-Ziels auf. Ein Beispiel ist _VIRT_COMMON_MODULES und seine Verwendung. GKI-Module dürfen nicht in diese Liste aufgenommen werden.
Konfigurieren Sie diese Module als unsigniert, da die Symbolliste andernfalls leer sein könnte. Fügen Sie dazu folgende Zeile in die Kernel-Konfigurationsfragmente ein:
# CONFIG_MODULE_SIG_ALL is not set
Siehe z. B. common-modules/virtual-device/virtual_device_core.fragment.
Dem Kernel-Build des Geräts eine Gerätesymbolliste hinzufügen
Fügen Sie dem kernel_build-Ziel, das im Gerät BUILD.bazel definiert ist, das Attribut kmi_symbol_list hinzu. Der Name der Symbolliste muss das Format //common:android/abi_gki_<arch>_<device> haben. Siehe common-modules/virtual-device/BUILD.bazel, z. B.:
kernel_build(
name = "virtual_device_aarch64",
base_kernel = "//common:kernel_aarch64",
kmi_symbol_list = "//common:android/abi_gki_aarch64_virtual_device",
...
module_outs = _VIRT_COMMON_MODULES + _VIRT_AARCH64_MODULES,
)
Erste Symbolliste erstellen und einreichen
Erstellen Sie unter common/android/abi_gki_<arch>_<device> eine leere Symbolliste. Für das Beispiel oben lautet der Befehl:
touch common/android/abi_gki_aarch64_virtual_device
Fügen Sie diese Datei additional_kmi_symbol_lists des Basis-GKI-Kernel-Builds hinzu. Beispiel: //common:android/abi_gki_aarch64_virtual_device wird der Dateigruppe aarch64_additional_kmi_symbol_lists hinzugefügt, die in common/BUILD.bazel deklariert ist.
Aktualisieren Sie die Gerätesymbolliste, um die neue Symbolliste zu füllen, und senden Sie sie an das Android Common Kernel-Repository.
Gerätesymbolliste aktualisieren
Alle Kernelsymbole, die von Modulen in module_outs von kernel_build und kernel_modules von kernel_abi verwendet werden, sollten in der Symbolliste enthalten sein. Dazu können Sie das Ziel kernel_abi mit dem Suffix _update_symbol_list ausführen. Mit dem folgenden Befehl wird beispielsweise die Symbolliste für //common-modules/virtual-device:virtual_device_aarch64 aktualisiert:
tools/bazel run //common-modules/virtual-device:virtual_device_aarch64_abi_update_symbol_list
Symbollistenaktualisierung an ACK senden
Senden Sie einen Patch mit der Änderung der Symbolliste an das Gerrit-Repository des Android Common Kernel, damit die neuen Symbole Teil des KMI werden.
Die Commit-Nachricht sollte eine Liste der hinzugefügten oder entfernten Symbole enthalten. Sie können diese Liste entweder manuell schreiben, um eine kleine Symbolliste zu aktualisieren, oder den $DIST_DIR/abi.report.short-Bericht verwenden, nachdem Sie die ABI-Referenzdarstellung aktualisiert haben.
Es ist zwar nicht erforderlich, die Referenz-ABI-Darstellung zu aktualisieren, bevor Sie eine Symbollistenaktualisierung senden. Dadurch können jedoch zusätzliche Schritte vor dem Einreichen vermieden und die Änderung schneller eingereicht werden. In jedem Fall wird er während des Vorabsendens überprüft und bei Bedarf aktualisiert.
Ältere Versionen (Android 12 und niedriger)
Verwenden Sie das build_abi.sh-Tool so:
BUILD_CONFIG=path/to/build.config.device build/build_abi.sh --update-symbol-list
In diesem Beispiel muss build.config.device die folgenden Konfigurationsoptionen enthalten:
vmlinuxMuss Teil der
FILES-Liste sein. Dazu können Siebuild.config.aarch64verwenden.KMI_SYMBOL_LISTMuss festgelegt und auf die zu aktualisierende KMI-Symbolliste verweisen.
Nachdem Sie die Liste der Gerätesymbole aktualisiert haben, müssen Sie diese Änderungen auch im GKI-Build (common/build.config.gki.aarch64) berücksichtigen:
Kopieren Sie die aktualisierte Symbolliste nach
common/android/abi_gki_aarch64_<device>.Prüfen Sie, ob
android/abi_gki_aarch64_<device>inADDITIONAL_KMI_SYMBOL_LISTSincommon/build.config.gki.aarch64enthalten ist.