การใช้งานฝั่งไคลเอ็นต์

คุณเปลี่ยนโครงสร้างโค้ดที่คอมไพล์แบบมีเงื่อนไขเพื่ออ่านค่าแบบไดนามิกจากอินเทอร์เฟซ 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 เพื่อรับแฮนเดิลสำหรับพร็อกซีของฟังก์ชันอินเทอร์เฟซ จากนั้นเรียกค่าด้วยการเรียกใช้แฮนเดิลผ่าน 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 ไม่ได้ระบุค่าสำหรับรายการการกำหนดค่า แต่ละฟังก์ชันจะต้องมีพารามิเตอร์เทมเพลต 2 ตัว ได้แก่

  • I คือชื่อคลาสอินเทอร์เฟซ
  • Func คือเคอร์เซอร์ฟังก์ชันสมาชิกสำหรับการรับรายการการกำหนดค่า

เนื่องจากค่าของการกำหนดค่าเป็นแบบอ่านอย่างเดียวและไม่เปลี่ยนแปลง ฟังก์ชันยูทิลิตีจะแคชค่าการกำหนดค่าภายใน การโทรครั้งต่อๆ ไปจะได้รับการบริการอย่างมีประสิทธิภาพมากขึ้นโดยใช้ค่าที่แคชไว้ในหน่วยการลิงก์เดียวกัน

ใช้ configstore-utils

HAL ของ ConfigStore ได้รับการออกแบบมาให้เข้ากันได้กับการอัปเกรดเวอร์ชันย่อย ซึ่งหมายความว่าเมื่อมีการแก้ไข HAL และโค้ดเฟรมเวิร์กบางรายการใช้รายการที่เพิ่งแนะนำ บริการ ConfigStore ที่มีเวอร์ชันย่อยที่เก่ากว่าใน /vendor จะยังคงใช้งานได้

สำหรับความเข้ากันได้กับการส่งต่อ ให้ตรวจสอบว่าการใช้งานเป็นไปตามหลักเกณฑ์ต่อไปนี้

  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 ต้องส่งคืนบริการ v1_1 สำหรับ getService() 
    V1_0::IConfig::getService()->v1_0API();

เมื่อมีการใช้ฟังก์ชันการเข้าถึงในไลบรารี configstore-utils เพื่อเข้าถึงรายการ ConfigStore จะมีการรับประกัน #1 จากการใช้งาน และ #2 จะได้รับการรับประกันจากข้อผิดพลาดของคอมไพเลอร์ ด้วยเหตุนี้ เราจึงขอแนะนำอย่างยิ่งให้ใช้ configstore-utils ทุกครั้งที่ทำได้