Możesz dodać nowe elementy ConfigStore (czyli metody interfejsu) dla istniejącej klasy interfejsu. Jeśli klasa interfejsu nie jest zdefiniowana, przed dodaniem elementu ConfigStore dla tej klasy należy dodać nową klasę. W tej sekcji wykorzystano przykład elementu konfiguracji disableInitBlank
dla healthd
dodanego do klasy interfejsu IChargerConfigs
.
Dodawanie klas interfejsu
Jeśli dla metody interfejsu, którą chcesz dodać, nie zdefiniowano żadnej klasy interfejsu, musisz dodać klasę interfejsu, zanim będzie można dodać powiązane elementy ConfigStore.
- Utwórz plik interfejsu HAL. Wersja ConfigStore to 1.0, więc zdefiniuj interfejsy ConfigStore w
hardware/interfaces/configstore/1.0
. Na przykład whardware/interfaces/configstore/1.0/IChargerConfigs.hal
:package android.hardware.configstore@1.0; interface IChargerConfigs { // TO-BE-FILLED-BELOW };
- Zaktualizuj pliki
Android.bp
iAndroid.mk
dla bibliotek współdzielonych i plików nagłówkowych ConfigStore, aby uwzględnić nowy interfejs HAL. Na przykład:hidl-gen -o hardware/interfaces/configstore/1.0/default -Lmakefile -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.configstore@1.0::IChargerConfigs
hidl-gen -o hardware/interfaces/configstore/1.0/default -Landroidbp -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.configstore@1.0::IChargerConfigs
Android.bp
iAndroid.mk
whardware/interfaces/configstore/1.0
. - Wygeneruj kod pośredniczący C++ do implementacji kodu serwera. Na przykład:
hidl-gen -o hardware/interfaces/configstore/1.0/default -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.configstore@1.0::IChargerConfigs
To polecenie tworzy dwa pliki,ChargerConfigs.h
iChargerConfigs.cpp
, whardware/interfaces/configstore/1.0/default
. - Otwórz pliki implementacyjne
.h
i.cpp
i usuń kod związany zHIDL_FETCH_ name
(na przykładHIDL_FETCH_IChargerConfigs
). Ta funkcja jest potrzebna w trybie przekazywania HIDL, który nie jest używany przez ConfigStore. - Zarejestruj wdrożenie w usłudze ConfigStore. Na przykład w
hardware/interfaces/configstore/1.0/default/service.cpp
:#include <android/hardware/configstore/1.0/IChargerConfigs.h> #include "ChargerConfigs.h" using android::hardware::configstore::V1_0::IChargerConfigs; using android::hardware::configstore::V1_0::implementation::ChargerConfigs; int main() { ... // other code sp<IChargerConfigs> chargerConfigs = new ChargerConfigs; status = chargerConfigs->registerAsService(); LOG_ALWAYS_FATAL_IF(status != OK, "Could not register IChargerConfigs"); ... // other code }
- Zmodyfikuj plik
Android.mk
, aby dodać plik implementacyjny (modulename Configs.cpp
) doLOCAL_SRC_FILES
i zamapować flagi kompilacji na definicje makr. Na przykład whardware/interfaces/configstore/1.0/default/Android.mk
:LOCAL_SRC_FILES += ChargerConfigs.cpp ifeq ($(strip $(BOARD_CHARGER_DISABLE_INIT_BLANK)),true) LOCAL_CFLAGS += -DCHARGER_DISABLE_INIT_BLANK endif
- (Opcjonalnie) Dodaj wpis manifestu. Jeśli nie istnieje, użyj domyślnej nazwy instancji ConfigStore. Na przykład w
device/google/marlin/manifest.xml
:<hal format="hidl"> <name>android.hardware.configstore</name> ... <interface> <name>IChargerConfigs</name> <instance>default</instance> </interface> </hal>
- W razie potrzeby dodaj regułę sepolicy (to znaczy, jeśli klient nie ma uprawnień do wykonywania wywołań hwbinder do
hal_configstore
). Na przykład wsystem/sepolicy/private/healthd.te
:... // other rules binder_call(healthd, hal_configstore)
Dodawanie nowych elementów ConfigStore
Aby dodać nowy element ConfigStore:
- Otwórz plik HAL i dodaj wymaganą metodę interfejsu dla elementu. (Pliki
.hal
dla ConfigStore znajdują się whardware/interfaces/configstore/1.0
.) Na przykład whardware/interfaces/configstore/1.0/IChargerConfigs.hal
:package android.hardware.configstore@1.0; interface IChargerConfigs { ... // Other interfaces disableInitBlank() generates(OptionalBool value); };
- Zaimplementuj metodę w odpowiednich plikach implementacji interfejsu HAL (
.h
i.cpp
). Umieść domyślne implementacje whardware/interfaces/configstore/1.0/default
. Na przykład whardware/interfaces/configstore/1.0/default/ChargerConfigs.h
:struct ChargerConfigs : public IChargerConfigs { ... // Other interfaces Return<void> disableInitBlank(disableInitBlank_cb _hidl_cb) override; };
Oraz whardware/interfaces/configstore/1.0/default/ChargerConfigs.cpp
:Return<void> ChargerConfigs::disableInitBlank(disableInitBlank_cb _hidl_cb) { bool value = false; #ifdef CHARGER_DISABLE_INIT_BLANK value = true; #endif _hidl_cb({true, value}); return Void(); }
Korzystanie z elementów ConfigStore
Aby użyć elementu ConfigStore:
- Dołącz wymagane pliki nagłówkowe. Na przykład w
system/core/healthd/healthd.cpp
:#include <android/hardware/configstore/1.0/IChargerConfigs.h> #include <configstore/Utils.h>
- Uzyskaj dostęp do elementu ConfigStore przy użyciu odpowiedniej funkcji szablonu w
android.hardware.configstore-utils
. Na przykład wsystem/core/healthd/healthd.cpp
:using namespace android::hardware::configstore; using namespace android::hardware::configstore::V1_0; static int64_t disableInitBlank = getBool< IChargerConfigs, &IChargerConfigs::disableInitBlank>(false);
W tym przykładzie elementdisableInitBlank
magazynu ConfigStore jest pobierany i zapisywany w zmiennej (przydatne, gdy trzeba uzyskać wielokrotny dostęp do zmiennej). Wartość pobrana z magazynu ConfigStore jest buforowana w utworzonej funkcji szablonu, dzięki czemu można ją szybko pobrać z wartości w pamięci podręcznej bez konieczności kontaktowania się z usługą ConfigStore w celu późniejszych wywołań funkcji szablonu utworzonej instancji. - Dodaj zależność od ConfigStore i biblioteki
configstore-utils
wAndroid.mk
lubAndroid.bp
. Na przykład wsystem/core/healthd/Android.mk
:LOCAL_SHARED_LIBRARIES := \ android.hardware.configstore@1.0 \ android.hardware.configstore-utils \ ... (other libraries) \