Mengimplementasikan layanan

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

Membuat kode antarmuka

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

Ubah Android.mk

Selanjutnya, ubah file Android.mk untuk menambahkan file implementasi (<modulename>Configs.cpp) ke LOCAL_SRC_FILES dan untuk memetakan tanda 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, pertimbangkan untuk memindahkan kode Anda ke file baru (yaitu, surfaceflinger.mk), lalu sertakan file tersebut dari Android.mk.

Menerapkan fungsi

Untuk mengisi fungsi guna menerapkan HAL, panggil kembali fungsi _hidl_cb dengan nilai yang berbeda (bergantung pada flag 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 bahwa implementasi tidak berisi fungsi bernama HIDL_FETCH_interface-name (misalnya, HIDL_FETCH_ISurfaceFlingerConfigs). Fungsi ini diperlukan untuk mode teruskan HIDL, yang tidak digunakan (dan dilarang) oleh configstore. ConfigStore harus selalu berjalan dalam mode binder.

Mendaftar 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();

Memastikan akses awal

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