يمكنك إضافة عناصر ConfigStore جديدة (أي أساليب الواجهة) لفئة واجهة موجودة. إذا لم يتم تعريف فئة الواجهة، فيجب عليك إضافة فئة جديدة قبل أن تتمكن من إضافة عنصر ConfigStore لتلك الفئة. يستخدم هذا القسم مثال عنصر تكوين disableInitBlank
healthd
التي تتم إضافتها إلى فئة واجهة IChargerConfigs
.
إضافة فئات الواجهة
إذا لم يتم تحديد فئة واجهة لأسلوب الواجهة الذي تريد إضافته، فيجب عليك إضافة فئة الواجهة قبل أن تتمكن من إضافة عناصر ConfigStore المرتبطة.
- إنشاء ملف واجهة HAL. إصدار ConfigStore هو 1.0، لذا حدد واجهات ConfigStore في
hardware/interfaces/configstore/1.0
. على سبيل المثال، فيhardware/interfaces/configstore/1.0/IChargerConfigs.hal
:package android.hardware.configstore@1.0; interface IChargerConfigs { // TO-BE-FILLED-BELOW };
- قم بتحديث
Android.bp
وAndroid.mk
لمكتبة ConfigStore المشتركة وملفات الرأس لتشمل الواجهة الجديدة HAL. على سبيل المثال: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
Android.bp
وAndroid.mk
فيhardware/interfaces/configstore/1.0
. - قم بإنشاء كعب روتين C++ لتنفيذ رمز الخادم. على سبيل المثال:
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
يقوم هذا الأمر بإنشاء ملفين،ChargerConfigs.h
وChargerConfigs.cpp
، فيhardware/interfaces/configstore/1.0/default
. - افتح ملفات التنفيذ
.h
و.cpp
وقم بإزالة التعليمات البرمجية المتعلقةHIDL_FETCH_ name
(على سبيل المثال،HIDL_FETCH_IChargerConfigs
). هذه الوظيفة مطلوبة لوضع عبور HIDL، الذي لا يستخدمه ConfigStore. - قم بتسجيل التنفيذ في خدمة ConfigStore. على سبيل المثال، في
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 }
- قم بتعديل ملف
Android.mk
لإضافة ملف التنفيذ (modulename Configs.cpp
) إلىLOCAL_SRC_FILES
ولتعيين إشارات البناء في تعريفات الماكرو. على سبيل المثال، في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
- (اختياري) قم بإضافة إدخال بيان. إذا لم يكن موجودًا، فانتقل افتراضيًا إلى اسم المثيل "الافتراضي" لـ ConfigStore. على سبيل المثال، في
device/google/marlin/manifest.xml
:<hal format="hidl"> <name>android.hardware.configstore</name> ... <interface> <name>IChargerConfigs</name> <instance>default</instance> </interface> </hal>
- أضف قاعدة الخصوصية إذا لزم الأمر (أي إذا لم يكن لدى العميل أذونات لإجراء مكالمات hwbinder إلى
hal_configstore
). على سبيل المثال، فيsystem/sepolicy/private/healthd.te
:... // other rules binder_call(healthd, hal_configstore)
إضافة عناصر ConfigStore جديدة
لإضافة عنصر ConfigStore جديد:
- افتح ملف HAL وأضف طريقة الواجهة المطلوبة للعنصر. (توجد ملفات
.hal
الخاصة بـ ConfigStore فيhardware/interfaces/configstore/1.0
.) على سبيل المثال، فيhardware/interfaces/configstore/1.0/IChargerConfigs.hal
:package android.hardware.configstore@1.0; interface IChargerConfigs { ... // Other interfaces disableInitBlank() generates(OptionalBool value); };
- قم بتنفيذ الطريقة في ملفات تنفيذ HAL للواجهة المقابلة (
.h
و.cpp
). ضع التطبيقات الافتراضية فيhardware/interfaces/configstore/1.0/default
. على سبيل المثال، فيhardware/interfaces/configstore/1.0/default/ChargerConfigs.h
:struct ChargerConfigs : public IChargerConfigs { ... // Other interfaces Return<void> disableInitBlank(disableInitBlank_cb _hidl_cb) override; };
وفي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(); }
استخدام عناصر ConfigStore
لاستخدام عنصر ConfigStore:
- قم بتضمين ملفات الرأس المطلوبة. على سبيل المثال، في
system/core/healthd/healthd.cpp
:#include <android/hardware/configstore/1.0/IChargerConfigs.h> #include <configstore/Utils.h>
- قم بالوصول إلى عنصر ConfigStore باستخدام وظيفة القالب المناسبة في
android.hardware.configstore-utils
. على سبيل المثال، في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);
في هذا المثال، يتم استرداد عنصر ConfigStoredisableInitBlank
وتخزينه في متغير (مفيد عندما يلزم الوصول إلى المتغير عدة مرات). يتم تخزين القيمة المستردة من ConfigStore مؤقتًا داخل وظيفة القالب الذي تم إنشاء مثيل له بحيث يمكن استرجاعها بسرعة من القيمة المخزنة مؤقتًا دون الاتصال بخدمة ConfigStore لإجراء مكالمات لاحقة إلى وظيفة القالب الذي تم إنشاء مثيل له. - أضف التبعية إلى ConfigStore ومكتبة
configstore-utils
فيAndroid.mk
أوAndroid.bp
. على سبيل المثال، فيsystem/core/healthd/Android.mk
:LOCAL_SHARED_LIBRARIES := \ android.hardware.configstore@1.0 \ android.hardware.configstore-utils \ ... (other libraries) \