Na tej stronie znajdziesz informacje o tworzeniu reprezentacji ABI jądra Androida i monitorowaniu ABI. Dotyczy to Androida 14 i nowszych wersji. Informacje o starszych wersjach znajdziesz w sekcji Starsze wersje jądra.
Zapoznaj się też z dokumentacją referencyjną Kleaf: Obsługa monitorowania ABI (GKI) i Obsługa monitorowania ABI (urządzenie).
Tworzenie jądra i jego reprezentacji ABI
Po pobraniu źródeł GKI uruchom to polecenie, aby utworzyć jądro GKI i artefakty ABI:
tools/bazel run //common:kernel_aarch64_abi_distTo polecenie tworzy bieżącą reprezentację ABI i kopiuje ją do pliku out_abi/kernel_aarch64/dist/abi.stg wraz z kompilowanym jądrem i modułami.
Dodatkowe argumenty narzędzia ABI możesz podać na końcu polecenia po --. Aby na przykład zmienić miejsce docelowe interfejsu ABI i artefakty kompilacji, możesz użyć opcji --dist_dir:
tools/bazel run //common:kernel_aarch64_abi_dist -- --dist_dir=out/distAnaliza różnic ABI między wersją kompilacji a reprezentacją referencyjną
Docelowy parametr //common:kernel_aarch64_abi_dist, który jest wykonywany w powyższym poleceniu, analizuje i zgłasza wszelkie różnice w ABI między wersją kompilacji a reprezentacją odniesienia znajdującą się w katalogu common/android/abi_gki_aarch64.stg (zdefiniowanym w pliku BUILD.bazel). Te różnice są wyprowadzane na koniec kompilacji, jak pokazano w tym przykładzie:
INFO: From [stg] Comparing Kernel ABI @//common:kernel_aarch64_abi_diff:
INFO: ABI DIFFERENCES HAVE BEEN DETECTED!
Wydrukowany raport pochodzi z elementu kompilacji znajdującego się w folderze out_abi/kernel_aarch64/dist/abi_stgdiff/abi.report.short, wraz z raportami w innych formatach.
Automatyzacja powinna używać kodu zakończenia polecenia kompilacji, który jest różny od 0, jeśli zostaną znalezione różnice.
Pamiętaj, że gałęzie fazy rozwoju, w tym android-mainline, nie mają referencyjnej reprezentacji ABI.
Bez niego //common:kernel_aarch64_abi_dist nie wykryje żadnych różnic.
Aktualizowanie odwołania do reprezentacji ABI
Wszystkie zmiany, które wpływają na interfejs ABI jądra, takie jak aktualizacja listy symboli, muszą być odzwierciedlone w referencyjnej reprezentacji ABI (common/android/abi_gki_aarch64.stg zdefiniowanej w BUILD.bazel).
W tym celu uruchom następujące polecenie:
tools/bazel run //common:kernel_aarch64_abi_updateTo polecenie wykonuje wszystkie czynności podane w kroku Analiza różnic w interfejsie ABI i dodatkowo aktualizuje reprezentację odwołania w źródłach. Zaktualizowany ABI można następnie przesłać w ramach tego samego zatwierdzenia, co zmiana. W komunikacie zatwierdzenia uwzględnij różnice pod względem interfejsu ABI względem raportu z $DIST_DIR/abi.report.short.
Monitorowanie ABI i urządzenia docelowe
Monitorowanie ABI musi być skonfigurowane tylko w przypadku docelowych wersji jądra. Mieszane konfiguracje kompilacji (te, które definiują base_kernel), które kompilują się bezpośrednio z jądrem GKI, muszą tylko dodać obsługę śledzenia listy symboli urządzenia.
Definicja ABI powinna zostać zaktualizowana za pomocą kompilacji GKI.
Zapoznaj się też z dokumentacją Kleaf: Obsługa monitorowania ABI (urządzenia).
Starsze wersje jądra
Android 13
Instrukcje kompilacji są w większości takie same jak w Androidzie 14, z wyjątkiem tego, że format ABI to XML, a referencyjna reprezentacja ABI to common/android/abi_gki_aarch64.xml.
Android 13 i starsze
Podobnie jak w Androidzie 13, format ABI to XML.
Starsze jądra używają build.sh zamiast Kleaf. W przypadku monitorowania ABI należy używać interfejsu build_abi.sh, który akceptuje te same zmienne środowiskowe, aby dostosować kompilację jako build.sh. Na przykład:
BUILD_CONFIG=common/build.config.gki.aarch64 build/build_abi.shSpowoduje to skompilowanie jądra i wyodrębnienie reprezentacji ABI w podkatalogu OUT_DIR (domyślnie out_abi) i jest równoważne docelowi //common:kernel_aarch64_abi_dist Kleaf (patrz Kompilowanie artefaktów jądra i ABI).
Referencyjna reprezentacja ABI jest przechowywana w android/abi_gki_aarch64.xml zgodnie z definicją zmiennej ABI_DEFINITION w common/build.config.gki.aarch64.
Jeśli chcesz zaktualizować reprezentację ABI jądra, najwygodniej jest użyć opcji --update i --print-report:
BUILD_CONFIG=common/build.config.gki.aarch64 build/build_abi.sh --update --print-reportPolecenie --print-report wyświetla różnice w ABI między obecną wersją pliku a nowo wygenerowanym ABI.
Opcja --update zastępuje referencyjną reprezentację ABI. Nie wykonuje też aktualizacji listy symboli, gdy używasz elementu BUILD_CONFIG na urządzeniu z konfigurowanym elementem KMI_SYMBOL_LIST.