इस पेज का अनुवाद Cloud Translation API से किया गया है.

सेवा को लागू करना

एचएएल लागू करने के लिए, ConfigStore इंटरफ़ेस का बुनियादी कोड जनरेट किया जा सकता है. इसके बाद, अपनी ज़रूरतों के हिसाब से उसमें बदलाव किया जा सकता है.

इंटरफ़ेस कोड जनरेट करें

इंटरफ़ेस के लिए, छोटे-मोटे बदलाव वाला कोड जनरेट करने के लिए, hidl-gen चलाएं. उदाहरण के लिए, surfaceflinger के लिए कोड जनरेट करने के लिए:

hidl-gen -o hardware/interfaces/configstore/1.0/default \
    -Lc++-impl \
    -randroid.hardware:hardware/interfaces \
    -randroid.hidl:system/libhidl/transport \
    android.hardware.config@1.0::ISurfaceFlingerConfigs

ध्यान दें: hidl-gen को -Landroidbp-impl के साथ न चलाएं, क्योंकि इससे Android.bp जनरेट होता है. Android.mk के साथ मॉड्यूल को बिल्ड करना ज़रूरी है, ताकि बिल्ड फ़्लैग ऐक्सेस किए जा सकें.

Android.mk को बदलें

इसके बाद, Android.mk फ़ाइल में बदलाव करके, LOCAL_SRC_FILES में लागू करने की फ़ाइल (<modulename>Configs.cpp) जोड़ें. साथ ही, मैक्रो डेफ़िनिशन में बिल्ड फ़्लैग को मैप करें. उदाहरण के लिए, surfaceflinger को hardware/interface/configstore/1.0/default/Android.mk में बदला जा सकता है:

LOCAL_SRC_FILES += SurfaceFlingerConfigs.cpp
ifneq ($(NUM_FRAMEBUFFER_SURFACE_BUFFERS),)
    LOCAL_CFLAGS += -DNUM_FRAMEBUFFER_SURFACE_BUFFERS=$(NUM_FRAMEBUFFER_SURFACE_BUFFERS)
endif

ifeq ($(TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK),true)
    LOCAL_CFLAGS += -DRUNNING_WITHOUT_SYNC_FRAMEWORK
endif

अगर Android.mk में कई ifeq-endif ब्लॉक शामिल हैं, तो अपने कोड को किसी नई फ़ाइल (यानी, surfaceflinger.mk) में ले जाएं. इसके बाद, उस फ़ाइल को Android.mk में शामिल करें.

फ़ंक्शन लागू करना

एचएएल को लागू करने के लिए फ़ंक्शन भरने के लिए, _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 को हमेशा बाइंडर मोड में चलाना चाहिए.

सेवा के तौर पर रजिस्टर करना

आखिर में, इंटरफ़ेस के सभी लागू होने की जानकारी को 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 सेवा का रिलीज़ होने से पहले ऐक्सेस मिल सके, hwservicemanager के तैयार होने के बाद, कॉन्फ़िगर की गई HAL सेवा को जल्द से जल्द शुरू किया जाना चाहिए. कॉन्फ़िगरेशन एचएएल सेवा, बाहरी फ़ाइलों को नहीं पढ़ती. इसलिए, लॉन्च होने के बाद यह जल्द ही तैयार हो जाएगी.