İstemci tarafı kullanım

.

Koşullu olarak derlenmiş kodu, buradan değerleri dinamik olarak okumak için yeniden düzenleyebilirsiniz. HAL arayüzü. Örnek:

#ifdef TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
// some code fragment
#endif

Çerçeve kodu, daha sonra buradaki <configstore/Utils.h> kullanabilirsiniz.

ConfigStore örneği

Bu örnekte, okuma etkinlikleri gösterilmektedir TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS, ConfigStore HAL'de tanımlanmış dönüş türüyle forceHwcForVirtualDisplays() olarak OptionalBool:

#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) configstore hizmetini kullanarak istemcinizde arayüz işleviyle daha sonra, herkese açık kullanıcı adını HIDL/hwbinder.

Yardımcı işlevler

<configstore/Utils.h>. (configstore/1.0/include/configstore/Utils.h) fayda sağlar Aşağıdakiler dahil olmak üzere her temel dönüş türü için işlevler: Optional[Bool|String|Int32|UInt32|Int64|UInt64], listelendiği şekliyle aşağıda bulabilirsiniz:

Tür İşlev (şablon parametreleri atlandı)
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ı aşağıdaki durumlarda döndürülen varsayılan değerdir: yapılandırma öğesi için bir değer belirtmez. Her fonksiyon iki şablon parametreleri:

  • I, arayüz sınıfının adıdır.
  • Func, şunun üye işlev işaretçisidir: yapılandırma öğesi alınıyor.

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ınmış değer kullanılarak daha verimli bir şekilde hizmet verebildiğini varsayalım.

configstore-utils kullan

ConfigStore HAL, alt sürümler için ileriye dönük olarak uyumlu olacak şekilde tasarlanmıştır. yani HAL revize edildiğinde ve bazı çerçeve kodları yeni kullanıma sunulan öğeleri kullanır. ConfigStore hizmeti, yaşı daha büyük olan bir /vendor üzerindeki sürüm kullanılmaya devam edebilir.

İleriye dönük uyumluluk için uygulamanızın şu politikalara uyduğundan emin olun: şu yönergeleri izleyin:

  1. Yeni öğeler, yalnızca eski sürümün hizmeti kullanılırken varsayılan değeri kullanır kullanılabilir. Örnek: 
    service = V1_1::IConfig::getService(); // null if V1_0 is installed
value = DEFAULT_VALUE;
  if(service) {
    value = service->v1_1API(DEFAULT_VALUE);
  }
    .
  2. İ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
    .
  3. Yeni sürümün hizmeti, eski sürümün arayüzü için alınabilir. İçinde aşağıdaki örnekte, yüklü sürüm v1_1 ise v1_1 hizmeti, getService() karşılığında iade edilecek: 
    V1_0::IConfig::getService()->v1_0API();

configstore-utils kitaplığındaki erişim işlevleri ConfigStore öğesine erişmek için kullanılır. #1, uygulama tarafından garanti edilir ve 2. uygulama, derleyici hatalarıyla garanti edilir. Bu nedenlerden dolayı, Mümkün olduğunda configstore-utils kullanmanızı öneririz.