Bazel 中以 FIDL 繫結程式庫的教學課程

本教學課程的適用對象為想要使用以 FIDL 為基礎的 SDK 的驅動程式庫程式作者 自動產生的繫結程式庫本教學課程假設您熟悉下列項目：

• FIDL 教學課程：產生的繫結程式庫
• 為驅動程式建立新的繫結程式庫

相同部分有什麼差異？

上方連結教學課程中的大部分概念和範例皆適用 SDK 使用者

唯一的差別在於：

• 以 FIDL 為基礎的繫結程式庫 fuchsia_fidl_bind_library 的 Bazel 目標必須 。
• 繫結程式庫程式碼產生目標的 Bazel 目標「fuchsia_bind_cc_library」需要 。

範例

本節中的範例是手動定義的 FIDL 程式庫，以及如何使用產生的 繫結程式庫及其產生的程式碼，為子項驅動程式庫建立繫結規則， 從父項驅動程式庫存取這些繫結程式庫值的常數。

BUILD.bazel

FIDL 程式庫

# This is a FIDL library that we manually define.
fuchsia_fidl_library(
    name = "examples.gizmo",
    srcs = [
        "testfidl.fidl",
    ],
    library = "examples.gizmo",
)

# The C++ bindings for the FIDL library.
fuchsia_fidl_llcpp_library(
    name = "examples.gizmo_cc",
    library = ":examples.gizmo",
    visibility = ["//visibility:public"],
    deps = [
        "@fuchsia_sdk//pkg/fidl_cpp_v2",
        "@fuchsia_sdk//pkg/fidl_cpp_wire",
    ],
)

# We have to manually create the bind library from it.
fuchsia_fidl_bind_library(
    name = "examples.gizmo_bindlib",
    library = ":examples.gizmo",
    visibility = ["//visibility:public"],
)

# We have to manually create the C++ lib for the FIDL based bind library we created.
fuchsia_bind_cc_library(
    name = "examples.gizmo_bindlib_cc",
    library = ":examples.gizmo_bindlib",
    visibility = ["//visibility:public"],
)

家長驅動程式庫

fuchsia_cc_driver(
    name = "parent_driver",
    srcs = [
        "gizmo_server.h",
        "parent-driver.cc",
        "parent-driver.h",
    ],
    deps = [
        # This is a C++ lib from our manually created bind library.
        "//src/bind_library/lib:examples.gizmo.bind_cc",
        # This is a C++ lib from our manually created FIDL based bind library.
        "//src/bind_library/lib:examples.gizmo_bindlib_cc",
        "//src/bind_library/lib:examples.gizmo_cc",
        # This is a C++ lib from an SDK FIDL based bind library.
        "@fuchsia_sdk//fidl/fuchsia.device.fs:fuchsia.device.fs_bindlib_cc",
        "@fuchsia_sdk//pkg/driver_component_cpp",
    ],
)

子項繫結規則

fuchsia_driver_bind_bytecode(
    name = "bind_bytecode",
    output = "child-driver.bindbc",
    rules = "child-driver.bind",
    deps = [
        # This bind library is one we created manually.
        "//src/bind_library/lib:examples.gizmo.bind",
        # This bind library is from a FIDL library that we created manually.
        "//src/bind_library/lib:examples.gizmo_bindlib",
        # This bind library is from an SDK FIDL library.
        "@fuchsia_sdk//fidl/fuchsia.device.fs:fuchsia.device.fs_bindlib",
    ],
)

parent-driver.cc

#include <bind/examples/gizmo/bind/cpp/bind.h>
#include <bind/examples/gizmo/cpp/bind.h>
#include <bind/fuchsia/device/fs/cpp/bind.h>

...

properties[4] = fdf::MakeProperty(arena, bind_fuchsia_device_fs::EXPORTER,
                                  bind_fuchsia_device_fs::EXPORTER_ZIRCONTRANSPORT);
properties[5] = fdf::MakeProperty(arena, bind_examples_gizmo::TESTINGPROTOCOL,
                                  bind_examples_gizmo::TESTINGPROTOCOL_ZIRCONTRANSPORT);

child-driver.bind

using fuchsia.device.fs;
using examples.gizmo;

...

fuchsia.device.fs.Exporter == fuchsia.device.fs.Exporter.ZirconTransport;
examples.gizmo.TestingProtocol == examples.gizmo.TestingProtocol.ZirconTransport;