از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
در مرحله بعد، فایل Android.mk را تغییر دهید تا فایل پیاده سازی ( <modulename>Configs.cpp ) را به LOCAL_SRC_FILES اضافه کنید و پرچم های ساخت را در تعاریف ماکرو ترسیم کنید. به عنوان مثال، می توانید surfaceflinger در hardware/interface/configstore/1.0/default/Android.mk تغییر دهید:
اگر Android.mk شامل چندین بلوک ifeq-endif است، کد خود را به یک فایل جدید (یعنی surfaceflinger.mk ) منتقل کنید، سپس آن فایل را از Android.mk وارد کنید.
پیاده سازی توابع
برای پر کردن توابع برای اجرای HAL، تابع _hidl_cb را با مقادیر مختلف (مشروط به پرچم‌های ساخت) فراخوانی کنید. برای مثال، می‌توانید توابع surfaceflinger را در hardware/interfaces/configstore/1.0/default/SurfaceFlingerConfigs.cpp پر کنید:
Return<void> SurfaceFlingerConfigs::numFramebufferSurfaceBuffers(
numFramebufferSurfaceBuffers_cb _hidl_cb) {
#if NUM_FRAMEBUFFER_SURFACE_BUFFERS 2
_hidl_cb(NumBuffers.TWO);
#else if NUM_FRAMEBUFFER_SURFACE_BUFFERS 3
_hidl_cb(NumBuffers.THREE);
#else
_hidl_cb(NumBuffers.USE_DEFAULT);
#endif
}
Return<void> SurfaceFlingerConfigs::runWithoutSyncFramework(
runWithoutSyncFramework_cb _hidl_cb) {
#ifdef RUNNING_WITHOUT_SYNC_FRAMEWORK
_hidl_cb({true /* specified */, true /* value */});
#else
// when macro not defined, we can give any value to the second argument.
// It will simply be ignored in the framework side.
_hidl_cb({false /* specified */, false /* value */});
#endif
}
اطمینان حاصل کنید که پیاده‌سازی تابعی به نام HIDL_FETCH_ interface-name ندارد (به عنوان مثال، HIDL_FETCH_ISurfaceFlingerConfigs ). این تابع برای حالت عبور HIDL مورد نیاز است که توسط configstore استفاده نشده (و ممنوع است). ConfigStore باید همیشه در حالت binderized اجرا شود.
به عنوان یک سرویس ثبت نام کنید
در نهایت، تمام پیاده سازی های رابط را در سرویس configstore ثبت کنید. برای مثال، می‌توانید پیاده‌سازی‌های surfaceflinger را در hardware/interfaces/configstore/1.0/default/service.cpp ثبت کنید:
configureRpcThreadpool(maxThreads, true);
sp<ISurfaceFlingerConfigs> surfaceFlingerConfigs = new SurfaceFlingerConfigs;
status_t status = surfaceFlingerConfigs->registerAsService();
sp<IBluetoothConfigs> bluetoothConfigs = new BluetoothConfigs;
status = bluetoothConfigs->registerAsService();
// register more interfaces here
joinRpcThreadpool();
از دسترسی زودهنگام اطمینان حاصل کنید
برای اطمینان از اینکه یک ماژول چارچوب می‌تواند به سرویس HAL دسترسی زودهنگام داشته باشد، سرویس پیکربندی HAL باید در اسرع وقت، درست پس از آماده شدن hwservicemanager شروع شود. از آنجایی که سرویس پیکربندی HAL فایل های خارجی را نمی خواند، انتظار می رود پس از راه اندازی به سرعت آماده شود.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Implement the service\n\n| **Warning:** Android 10 deprecates the ConfigStore HAL and replaces the HAL with system properties. For details, refer to [Configuring](/docs/core/architecture/configuration).\n\nTo prepare for the HAL implementation, you can generate basic ConfigStore\ninterface code, then modify it to meet your needs.\n\nGenerate interface code\n-----------------------\n\nTo generate boilerplate code for the interface, run `hidl-gen`.\nFor example, to generate code for `surfaceflinger`: \n\n```\nhidl-gen -o hardware/interfaces/configstore/1.0/default \\\n -Lc++-impl \\\n -randroid.hardware:hardware/interfaces \\\n -randroid.hidl:system/libhidl/transport \\\n android.hardware.config@1.0::ISurfaceFlingerConfigs\n```\n| **Note:** Don't run `hidl-gen` with `-Landroidbp-impl` as this generates `Android.bp`. The module must be built with `Android.mk` to access build flags.\n\nModify Android.mk\n-----------------\n\nNext, modify the `Android.mk` file to add the implementation file\n(`\u003cmodulename\u003eConfigs.cpp`) to `LOCAL_SRC_FILES` and\nto map build flags into macro definitions. For example, you can modify\n`surfaceflinger` in\n`hardware/interface/configstore/1.0/default/Android.mk`: \n\n```\nLOCAL_SRC_FILES += SurfaceFlingerConfigs.cpp\nifneq ($(NUM_FRAMEBUFFER_SURFACE_BUFFERS),)\n LOCAL_CFLAGS += -DNUM_FRAMEBUFFER_SURFACE_BUFFERS=$(NUM_FRAMEBUFFER_SURFACE_BUFFERS)\nendif\n\nifeq ($(TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK),true)\n LOCAL_CFLAGS += -DRUNNING_WITHOUT_SYNC_FRAMEWORK\nendif\n```\n\nIf `Android.mk` includes several `ifeq-endif` blocks,\nconsider moving your code into a new file (that is,\n`surfaceflinger.mk`) then include that file from\n`Android.mk`.\n\nImplement functions\n-------------------\n\nTo fill the functions to implement the HAL, call back the\n`_hidl_cb` function with different values (conditioned on build\nflags). For example, you can fill the functions for `surfaceflinger`\nin\n`hardware/interfaces/configstore/1.0/default/SurfaceFlingerConfigs.cpp`: \n\n```\nReturn\u003cvoid\u003e SurfaceFlingerConfigs::numFramebufferSurfaceBuffers(\n numFramebufferSurfaceBuffers_cb _hidl_cb) {\n #if NUM_FRAMEBUFFER_SURFACE_BUFFERS 2\n _hidl_cb(NumBuffers.TWO);\n #else if NUM_FRAMEBUFFER_SURFACE_BUFFERS 3\n _hidl_cb(NumBuffers.THREE);\n #else\n _hidl_cb(NumBuffers.USE_DEFAULT);\n #endif\n}\n\nReturn\u003cvoid\u003e SurfaceFlingerConfigs::runWithoutSyncFramework(\n runWithoutSyncFramework_cb _hidl_cb) {\n #ifdef RUNNING_WITHOUT_SYNC_FRAMEWORK\n _hidl_cb({true /* specified */, true /* value */});\n #else\n // when macro not defined, we can give any value to the second argument.\n // It will simply be ignored in the framework side.\n _hidl_cb({false /* specified */, false /* value */});\n #endif\n}\n```\n\nEnsure that the implementation doesn't contain a function named\n`HIDL_FETCH_`\u003cvar translate=\"no\"\u003einterface-name\u003c/var\u003e (for example,\n`HIDL_FETCH_ISurfaceFlingerConfigs`). This function is needed for\nHIDL passthrough mode, which is unused (and prohibited) by\n`configstore`. ConfigStore must always run in binderized mode.\n\nRegister as a service\n---------------------\n\nFinally, register all interface implementations to the\n`configstore` service. For example, you can register\n`surfaceflinger` implementations in\n`hardware/interfaces/configstore/1.0/default/service.cpp`: \n\n```\nconfigureRpcThreadpool(maxThreads, true);\nsp\u003cISurfaceFlingerConfigs\u003e surfaceFlingerConfigs = new SurfaceFlingerConfigs;\nstatus_t status = surfaceFlingerConfigs-\u003eregisterAsService();\n\nsp\u003cIBluetoothConfigs\u003e bluetoothConfigs = new BluetoothConfigs;\nstatus = bluetoothConfigs-\u003eregisterAsService();\n\n// register more interfaces here\njoinRpcThreadpool();\n```\n\nEnsure early access\n-------------------\n\nTo ensure that a framework module can get early access the HAL service, the\nconfig HAL service should start as early as possible, just after\n`hwservicemanager` is ready. As the config HAL service doesn't read\nexternal files, it's expected to be ready quickly after it's launched."]]
