用戶端使用

您可以重構有條件編譯的程式碼，從 HAL 介面以動態方式讀取值。例如：

#ifdef TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
// some code fragment
#endif

接著，架構程式碼即可根據其類型，呼叫 <configstore/Utils.h> 中定義的適當公用程式函式。

ConfigStore 範例

本範例說明如何讀取 TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS，在 ConfigStore HAL 中定義為 forceHwcForVirtualDisplays()，並具有 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);

公用函式 (上例中的 getBool) 會與 configstore 服務聯絡，以取得介面函式 Proxy 的句柄，然後透過 HIDL/hwbinder 叫用句柄來擷取值。

公用函式

<configstore/Utils.h> (configstore/1.0/include/configstore/Utils.h) 為每種原始傳回類型提供公用程式函式，包括 Optional[Bool|String|Int32|UInt32|Int64|UInt64]，如下所列：

類型 函式(略去範本參數)
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 實作未為設定項目指定值時傳回的預設值。每個函式都會採用兩個範本參數：

  • I 是介面類別名稱。
  • Func 是用於取得設定項目的會員函式指標。

由於設定值為唯讀且不會變更，因此公用程式函式會在內部快取設定值。後續呼叫會使用相同連結單位中的快取值，以更有效率的方式提供服務。

使用 configstore-utils

ConfigStore HAL 適合用於次要版本升級，也就是說，當 HAL 經過修改且部分架構程式碼使用新導入的項目時，仍可使用 /vendor 中較舊版本的 ConfigStore 服務。

為了確保向前相容性，請確保您的實作方式符合下列指南：

  1. 如果「僅」提供舊版服務，新項目就會使用預設值。示例： 
    service = V1_1::IConfig::getService(); // null if V1_0 is installed
value = DEFAULT_VALUE;
  if(service) {
    value = service->v1_1API(DEFAULT_VALUE);
  }
  2. 用戶端會使用第一個包含 ConfigStore 項目的介面。範例： 
    V1_1::IConfig::getService()->v1_0API(); // NOT ALLOWED

V1_0::IConfig::getService()->v1_0API(); // OK
  3. 舊版介面可擷取新版的服務。在下列範例中，如果已安裝的版本是 v1_1，則必須為 getService() 傳回 v1_1 服務： 
    V1_0::IConfig::getService()->v1_0API();

當 configstore-utils 程式庫中的存取函式用於存取 ConfigStore 項目時，#1 會由實作保證，#2 則由編譯器錯誤保證。因此，我們強烈建議您盡可能使用 configstore-utils。