Mengimplementasikan layanan

Untuk menyiapkan penerapan HAL, Anda dapat membuat kode antarmuka ConfigStore dasar, lalu mengubahnya untuk memenuhi kebutuhan Anda.

Membuat kode antarmuka

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

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

Pastikan akses awal

Untuk memastikan modul framework dapat mendapatkan akses awal ke layanan HAL, layanan HAL konfigurasi harus dimulai seawal mungkin, tepat setelah hwservicemanager siap. Karena layanan HAL konfigurasi tidak membaca file eksternal, layanan ini diharapkan akan siap dengan cepat setelah diluncurkan.