Bu sayfa, Cloud Translation API ile çevrilmiştir.

İstemci tarafı kullanım

Koşullu olarak derlenmiş kodu, HAL arayüzünden değerleri dinamik olarak okuyacak şekilde yeniden yapılandırabilirsiniz. Örnek:

#ifdef TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
// some code fragment
#endif

Çerçeve kodu, türüne bağlı olarak <configstore/Utils.h> içinde tanımlanan uygun bir yardımcı program işlevini çağırabilir.

ConfigStore örneği

Bu örnekte, ConfigStore HAL'de forceHwcForVirtualDisplays() olarak tanımlanan ve OptionalBool döndürme türüne sahip TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS okuma işlemi gösterilmektedir:

#include <configstore/Utils.h>
using namespace android::hardware::configstore;
using namespace android::hardware::configstore::V1_0;

static bool vsyncPhaseOffsetNs = getBool<ISurfaceFlingerConfigs,
        ISurfaceFlingerConfigs::forceHwcForVirtualDisplays>(false);

Yardımcı program işlevi (yukarıdaki örnekte getBool), arayüz işlevinin proxy'sinin tutamacını almak için configstore hizmetiyle iletişim kurar, ardından HIDL/hwbinder üzerinden tutamacını çağırarak değeri alır.

Yardımcı işlevler

Tür	İşlev (şablon parametreleri atlanmıştır)
`OptionalBool`	`bool getBool(const bool defValue)`
`OptionalInt32`	`int32_t getInt32(const int32_t defValue)`
`OptionalUInt32`	`uint32_t getUInt32(const uint32_t defValue)`
`OptionalInt64`	`int64_t getInt64(const int64_t defValue)`
`OptionalUInt64`	`uint64_t getUInt64(const uint64_t defValue)`
`OptionalString`	`std::string getString(const std::string &defValue)`

defValue, HAL uygulaması yapılandırma öğesi için bir değer belirtmediğinde döndürülen varsayılan değerdir. Her işlev iki şablon parametresi alır:

I, arayüz sınıfının adıdır.
Func, yapılandırma öğesini almak için kullanılan üye işlevi işaretçisidir.

Yapılandırma değeri salt okunur olduğundan ve değişmediğinden, yardımcı program işlevi yapılandırma değerini dahili olarak önbelleğe alır. Sonraki çağrılar, aynı bağlantı biriminde önbelleğe alınan değer kullanılarak daha verimli bir şekilde sunulur.

configstore-utils'i kullanma

ConfigStore HAL, küçük sürüm yükseltmeleri için ileriye dönük uyumlu olacak şekilde tasarlanmıştır. Yani HAL düzeltildiğinde ve bazı çerçeve kodları yeni tanıtılan öğeleri kullandığında /vendor'te daha eski bir küçük sürüme sahip ConfigStore hizmeti yine kullanılabilir.

Gelecekteki uyumluluk için uygulamanızın aşağıdaki yönergelere uyduğundan emin olun:

Yeni öğeler, yalnızca eski sürümün hizmeti kullanılabilir olduğunda varsayılan değeri kullanır. Örnek:

service = V1_1::IConfig::getService(); // null if V1_0 is installed
value = DEFAULT_VALUE;
  if(service) {
    value = service->v1_1API(DEFAULT_VALUE);
  }

İstemci, ConfigStore öğesini içeren ilk arayüzü kullanır. Örnek:

V1_1::IConfig::getService()->v1_0API(); // NOT ALLOWED

V1_0::IConfig::getService()->v1_0API(); // OK

Yeni sürümün hizmeti, eski sürümün arayüzü için alınabilir. Aşağıdaki örnekte yüklü sürüm v1_1 ise getService() için v1_1 hizmetinin döndürülmesi gerekir:
```
V1_0::IConfig::getService()->v1_0API();
```
Not: Mevcut AOSP uygulaması bu şartı karşılamaktadır.

configstore-utils kitaplığındaki erişim işlevleri ConfigStore öğesine erişmek için kullanıldığında #1 uygulama uygulama tarafından, 2 numara ise derleyici hatalarıyla garanti edilir. Bu nedenlerle, mümkün olan her yerde configstore-utils kullanmanızı önemle tavsiye ederiz.