Format pliku Android.bp

Pliki Android.bp są z założenia proste. Nie zawierają one instrukcji warunkowych ani instrukcji sterowania. Wszystkie złożoności są obsługiwane przez logikę kompilacji napisaną w języku Go. W miarę możliwości składnia i semantyka plików Android.bp są podobne do plików Bazel BUILD.

Moduły

Moduł w pliku Android.bp zaczyna się od typu modułu, a następuje po nim zestaw właściwości w formacie name: "value",:

cc_binary {
    name: "gzip",
    srcs: ["src/test/minigzip.c"],
    shared_libs: ["libz"],
    stl: "none",
}

Każdy moduł musi mieć właściwość name, a wartość musi być unikalna we wszystkich plikach Android.bp, z wyjątkiem wartości właściwości name w przestrzeniach nazw i gotowych modułach, które mogą się powtarzać.

Właściwość srcs określa pliki źródłowe użyte do skompilowania modułu jako lista ciągów znaków. Za pomocą składni odwołania do modułu ":<module-name>" możesz odwoływać się do danych wyjściowych innych modułów, które tworzą pliki źródłowe, np. genrule lub filegroup.

Listę prawidłowych typów modułów i ich właściwości znajdziesz w dokumentacji modułów Song.

Typy

Zmienne i właściwości są wpisane dynamicznie – zmienne są dynamicznie określane w zależności od pierwszego przypisania, a właściwości ustawiane statycznie przez typ modułu. Obsługiwane typy:

• Wartości logiczne (true lub false)
• Liczby całkowite (int)
• Ciągi tekstowe ("string")
• Listy ciągów tekstowych (["string1", "string2"])
• Mapy ({key1: "value1", key2: ["value2"]})

Mapy mogą zawierać wartości dowolnego typu, w tym zagnieżdżone mapy. Listy i mapy mogą zawierać przecinki po ostatniej wartości.

Globy

Właściwości, które przyjmują listę plików, np. srcs, mogą też przyjmować wzorce glob. Wzorce kuli ziemskiej mogą zawierać normalny symbol wieloznaczny * systemu UNIX, na przykład *.java. Wzorce globów mogą też zawierać jeden symbol wieloznaczny ** jako element ścieżki, który pasuje do co najmniej jednego elementu ścieżki. Na przykład java/**/*.java pasuje do wzorca java/Main.java i java/com/android/Main.java.

Zmienne

Plik Android.bp może zawierać przypisania zmiennych na najwyższym poziomie:

gzip_srcs = ["src/test/minigzip.c"],
cc_binary {
    name: "gzip",
    srcs: gzip_srcs,
    shared_libs: ["libz"],
    stl: "none",
}

Zmienne są ograniczone do reszty pliku, w którym zostały zadeklarowane, a także do wszystkich podrzędnych plików Blueprint. Zmienne są niezmienne z jednym wyjątkiem: można do nich dołączać przypisania za pomocą instrukcji +=, ale tylko przed ich wywołaniem.

Komentarze

Android.bp Pliki mogą zawierać wielowierszowe /* */ i komentarze w stylu C++ jednowierszowe //.

Operatorzy

Ciągi tekstowe, listy ciągów tekstowych i mapy można dołączać za pomocą operatora +. Całkowite można sumować za pomocą operatora +. Dołączenie mapy powoduje ujednolicenie kluczy w obu mapach i dołączenie wartości wszystkich kluczy, które znajdują się w obu mapach.

Warunkowe

Utwór nie obsługuje warunków warunkowych w plikach Android.bp. Zamiast tego złożoność reguł kompilacji, które wymagają instrukcji warunkowych, jest obsługiwana w języku Go, gdzie można używać funkcji języka na wysokim poziomie, a ukryte zależności wprowadzone przez instrukcje warunkowe można śledzić. Większość warunków warunkowych jest konwertowana na właściwość mapy, w której jedna z wartości z mapy jest wybierana i dołączana do właściwości najwyższego poziomu.

Aby na przykład zapewnić obsługę plików architektonicznych:

cc_library {
    ...
    srcs: ["generic.cpp"],
    arch: {
        arm: {
            srcs: ["arm.cpp"],
        },
        x86: {
            srcs: ["x86.cpp"],
        },
    },
}

Formater

Soong zawiera kanoniczny formater plików Blueprint, podobny do gofmt. Aby rekursywnie zmienić format wszystkich plików Android.bp w bieżącym katalogu, uruchom polecenie:

bpfmt -w .

Format kanoniczny obejmuje wcięcia co 4 spacje, nowe wiersze po każdym elemencie listy wieloelementowej oraz przecinek na końcu w listach i mapach.