A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiungere classi e elementi ConfigStore
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Puoi aggiungere nuovi elementi ConfigStore (ovvero metodi di interfaccia) per una classe di interfaccia esistente. Se la classe di interfaccia non è definita, devi aggiungere una nuova classe prima di poter aggiungere un elemento ConfigStore per quella classe. Questa sezione utilizza l'esempio di un elemento di configurazione disableInitBlank per healthd da aggiungere alla classe di interfaccia IChargerConfigs.

Aggiungere classi di interfaccia

Se non è definita una classe di interfaccia per il metodo di interfaccia che vuoi aggiungere, devi aggiungere la classe di interfaccia prima di poter aggiungere gli elementi ConfigStore associati.

Crea un file di interfaccia HAL. La versione di ConfigStore è 1.0, quindi definisci le interfacce ConfigStore in hardware/interfaces/configstore/1.0. Ad esempio, in hardware/interfaces/configstore/1.0/IChargerConfigs.hal:
```
package android.hardware.configstore@1.0;

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

Aggiorna Android.bp e Android.mk per la libreria condivisa e i file di intestazione ConfigStore in modo da includere la nuova interfaccia HAL. Ad esempio:

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

Questi comandi aggiornano Android.bp e Android.mk in hardware/interfaces/configstore/1.0.

Genera lo stub C++ per l'implementazione del codice del server. Ad esempio:

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

Questo comando crea due file, ChargerConfigs.h e ChargerConfigs.cpp, in hardware/interfaces/configstore/1.0/default.

Apri i file di implementazione .h e .cpp e rimuovi il codice relativo alla funzione HIDL_FETCH_name (ad es.HIDL_FETCH_IChargerConfigs). Questa funzione è necessaria per la modalità di passaggio HIDL, che non viene utilizzata da ConfigStore.

Registra l'implementazione nel servizio ConfigStore. Ad esempio, in 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
}

Modifica il file Android.mk per aggiungere il file di implementazione (modulenameConfigs.cpp) a LOCAL_SRC_FILES e per mappare i flag di compilazione alle definizioni di macro. Ad esempio, in 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
```

(Facoltativo) Aggiungi una voce manifest. Se non esiste, viene utilizzato per impostazione predefinita il nome dell'istanza "predefinita" di ConfigStore. Ad esempio, in device/google/marlin/manifest.xml:

    <hal format="hidl">
        <name>android.hardware.configstore</name>
        ...
        <interface>
            <name>IChargerConfigs</name>
            <instance>default</instance>
        </interface>
    </hal>

Aggiungi la regola sepolicy, se necessario (ovvero se il client non ha le autorizzazioni per effettuare chiamate hwbinder a hal_configstore). Ad esempio, in system/sepolicy/private/healthd.te:
```
... // other rules
binder_call(healthd, hal_configstore)
```

Aggiungere nuovi elementi ConfigStore

Per aggiungere un nuovo elemento ConfigStore:

Apri il file HAL e aggiungi il metodo di interfaccia richiesto per l'elemento. I file .hal per ConfigStore si trovano in hardware/interfaces/configstore/1.0. Ad esempio, in hardware/interfaces/configstore/1.0/IChargerConfigs.hal:
```
package android.hardware.configstore@1.0;

interface IChargerConfigs {
    ... // Other interfaces
    disableInitBlank() generates(OptionalBool value);
};
```
Implementa il metodo nei file di implementazione HAL dell'interfaccia corrispondente (.h e .cpp). Posiziona le implementazioni predefinite in hardware/interfaces/configstore/1.0/default.
Nota: l'esecuzione di hidl-gen con -Lc++-impl genera il codice di scheletro per il metodo di interface appena aggiunto. Tuttavia, sovrascrive anche le implementazioni per tutti i metodi di interface esistenti, quindi utilizza l'opzione -o in modo appropriato.
Ad esempio, in hardware/interfaces/configstore/1.0/default/ChargerConfigs.h:
```
struct ChargerConfigs : public IChargerConfigs {
    ... // Other interfaces
    Return<void> disableInitBlank(disableInitBlank_cb _hidl_cb) override;
};
```
E in 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();
}
```

Utilizzare gli elementi ConfigStore

Per utilizzare un elemento ConfigStore:

Includi i file di intestazione richiesti. Ad esempio, in system/core/healthd/healthd.cpp:

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

Accedi all'elemento ConfigStore utilizzando la funzione del modello appropriata in android.hardware.configstore-utils. Ad esempio, in 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);
```
In questo esempio, l'elemento ConfigStore disableInitBlank viene recuperato e memorizzato in una variabile (utile quando è necessario accedere alla variabile più volte). Il valore recuperato da ConfigStore viene memorizzato nella cache all'interno della funzione del modello creata in modo da poter essere recuperato rapidamente dal valore memorizzato nella cache senza contattare il servizio ConfigStore per le chiamate successive alla funzione del modello creata.
Aggiungi la dipendenza da ConfigStore e dalla libreria configstore-utils in Android.mk o Android.bp. Ad esempio, in system/core/healthd/Android.mk:
```
LOCAL_SHARED_LIBRARIES := \
    android.hardware.configstore@1.0 \
    android.hardware.configstore-utils \
    ... (other libraries) \
```