Mengimplementasikan layanan

Untuk mempersiapkan implementasi HAL, Anda dapat membuat kode antarmuka ConfigStore dasar, lalu mengubahnya sesuai kebutuhan.

Membuat kode antarmuka

Untuk membuat kode boilerplate untuk antarmuka, jalankan hidl-gen. Misalnya, guna membuat kode untuk 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

Mengubah Android.mk

Selanjutnya, ubah file Android.mk untuk menambahkan file implementasi (<modulename>Configs.cpp) ke LOCAL_SRC_FILES dan untuk memetakan flag build ke dalam definisi makro. Misalnya, Anda dapat mengubah surfaceflinger di 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

Jika Android.mk menyertakan beberapa blok ifeq-endif, sebaiknya pindahkan kode ke file baru (yaitu surfaceflinger.mk), lalu sertakan file tersebut dari Android.mk.

Mengimplementasikan fungsi

Untuk mengisi fungsi guna menerapkan HAL, panggil kembali fungsi _hidl_cb dengan nilai yang berbeda (dikondisikan pada tanda build). Misalnya, Anda dapat mengisi fungsi untuk surfaceflinger di 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
}

Pastikan implementasi tidak berisi fungsi bernama HIDL_FETCH_interface-name (misalnya, HIDL_FETCH_ISurfaceFlingerConfigs). Fungsi ini diperlukan untuk mode passthrough HiDL, yang tidak digunakan (dan dilarang) oleh configstore. ConfigStore harus selalu berjalan dalam mode binderized.

Daftar sebagai layanan

Terakhir, daftarkan semua implementasi antarmuka ke layanan configstore. Misalnya, Anda dapat mendaftarkan implementasi surfaceflinger di 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();

Pastikan akses awal

Untuk memastikan bahwa modul framework bisa mendapatkan akses awal layanan HAL, layanan HAL konfigurasi harus dimulai sedini mungkin, tepat setelah hwservicemanager siap. Karena layanan HAL konfigurasi tidak membaca file eksternal, layanan tersebut diharapkan siap dengan cepat setelah diluncurkan.