Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

Dodawanie klas i elementów ConfigStore
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Do istniejącej klasy interfejsu możesz dodawać nowe elementy ConfigStore (czyli metody interfejsu). Jeśli klasa interfejsu nie jest zdefiniowana, przed dodaniem elementu ConfigStore dla tej klasy musisz dodać nową klasę. W tej sekcji przykład elementu konfiguracji disableInitBlank dla healthd jest dodawany do klasy interfejsu IChargerConfigs.

Dodawanie klas interfejsu

Jeśli dla metody interfejsu, którą chcesz dodać, nie jest zdefiniowana klasa interfejsu, musisz dodać klasę interfejsu, zanim dodasz powiązane elementy ConfigStore.

Utwórz plik interfejsu HAL. Wersja ConfigStore to 1.0, więc zdefiniuj interfejsy ConfigStore w pliku hardware/interfaces/configstore/1.0. Na przykład w pliku hardware/interfaces/configstore/1.0/IChargerConfigs.hal:
```
package android.hardware.configstore@1.0;

interface IChargerConfigs {
    // TO-BE-FILLED-BELOW
};
```

Zaktualizuj pliki Android.bp i Android.mk biblioteki współdzielonej ConfigStore oraz pliki nagłówków, aby uwzględnić nowy interfejs HAL. 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

Te polecenia aktualizują Android.bp i Android.mk w hardware/interfaces/configstore/1.0.

Wygeneruj złącze C++ do implementacji kodu serwera. 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 w hardware/interfaces/configstore/1.0/default 2 pliki: ChargerConfigs.h i ChargerConfigs.cpp.

Otwórz pliki implementacji .h i .cpp i usuń kod związany z funkcją HIDL_FETCH_name (na przykład HIDL_FETCH_IChargerConfigs). Ta funkcja jest potrzebna do obsługi trybu przekazywania HIDL, który nie jest używany przez ConfigStore.

Zarejestruj implementację w usłudze ConfigStore. Na przykład w przypadku: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 implementacji (modulenameConfigs.cpp) do pliku LOCAL_SRC_FILES i przypisać flagi kompilacji do definicji makr. Na przykład w przypadku:hardware/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 w pliku manifestu. Jeśli nie istnieje, domyślnie jest używana nazwa instancji ConfigStore „default”. Na przykład w przypadku: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 (czyli jeśli klient nie ma uprawnień do wywoływania funkcji hwbinder w funkcji hal_configstore). Na przykład w funkcji system/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 do niego wymaganą metodę interfejsu. (Pliki .hal dla ConfigStore znajdują się w hardware/interfaces/configstore/1.0). Na przykład w hardware/interfaces/configstore/1.0/IChargerConfigs.hal:
```
package android.hardware.configstore@1.0;

interface IChargerConfigs {
    ... // Other interfaces
    disableInitBlank() generates(OptionalBool value);
};
```
Wdroż metodę w odpowiednich plikach implementacji interfejsu HAL (.h i .cpp). Umieść domyślne implementacje w pliku hardware/interfaces/configstore/1.0/default.
Uwaga: uruchomienie hidl-gen z -Lc++-impl generuje kod szablonu dla nowo dodanej metody interfejsu. Jednak zastępuje ona też implementacje wszystkich dotychczasowych metod interfejsu, dlatego należy odpowiednio używać opcji -o.
Na przykład w przypadku:hardware/interfaces/configstore/1.0/default/ChargerConfigs.h
```
struct ChargerConfigs : public IChargerConfigs {
    ... // Other interfaces
    Return<void> disableInitBlank(disableInitBlank_cb _hidl_cb) override;
};
```
hardware/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łówka. Na przykład w przypadku:system/core/healthd/healthd.cpp

#include <android/hardware/configstore/1.0/IChargerConfigs.h>
#include <configstore/Utils.h>

Uzyskaj dostęp do elementu ConfigStore za pomocą odpowiedniej funkcji szablonu w android.hardware.configstore-utils. Na przykład w przypadku:system/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 element ConfigStore disableInitBlank jest pobierany i przechowywany w zmiennej (przydatne, gdy trzeba uzyskać dostęp do zmiennej kilka razy). Wartość pobrana z ConfigStore jest przechowywana w pamięci podręcznej wewnątrz wywołanej funkcji szablonu, aby można było ją szybko pobrać z wartości z pamięci podręcznej bez kontaktowania się z usługą ConfigStore w przypadku późniejszych wywołań funkcji szablonu.
Dodaj zależność od ConfigStore i biblioteki configstore-utils w pliku Android.mk lub Android.bp. Na przykład w przypadku:system/core/healthd/Android.mk
```
LOCAL_SHARED_LIBRARIES := \
    android.hardware.configstore@1.0 \
    android.hardware.configstore-utils \
    ... (other libraries) \
```