| commit | f5c0af2f037b6e8405b4158b5e3041675da8e522 | [log] [tgz] |
|---|---|---|
| author | CQ Bot Account <pigweed-scoped@luci-project-accounts.iam.gserviceaccount.com> | Thu Jun 13 21:14:11 2024 +0000 |
| committer | Gerrit Code Review <noreply-gerritcodereview@google.com> | Thu Jun 13 21:14:11 2024 +0000 |
| tree | 33232cd41dee49bce74d20e95369cb43febde7a8 | |
| parent | e8ecc94fb142d1b32929796563e8ea354e06b6e8 [diff] | |
| parent | bda749523858b062275876edb5c62c7002ee73c9 [diff] |
Merge "Add basic example for testing/validation" into main
A small wrapper Bazel module that builds libusb from sources. Supports Windows, macOS, and Linux.
At this time, rules_libusb only supports bzlmod projects. Legacy WORKSPACE projects are not explicitly supported.
Add rules_libusb to your MODULE.bazel file:
bazel_dep(name = "rules_libusb", version="0.1.0-rc1")
libusb = use_extension("@rules_libusb//:extensions.bzl", "libusb")
# Versioning constraints are optional.
libusb.source_release(min_version = "1.0.27")
use_repo(libusb, "libusb")
Note: source_release constraints follow bzlmod behavior of minimal version selection.
Then add to the tool that requires libusb:
cc_binary(
name = "my_tool",
srcs = ["main.cpp"],
deps = ["@libusb//:libusb"],
)
The libusb build file offers two targets to help guide link behavior:
//:libusb: The generic cc_library for libusb. Most build targets should just use this.//:libusb_dynamic: The actual libusb dynamic/shared library (e.g. libusb-1.0.so).By default, @libusb//:libusb will always dynamically link. This can be disabled by toggling the flag that controls this:
bazel build //... --@rules_libusb//:force_dynamic_linkage=False
When @rules_libusb//:force_dynamic_linkage is disabled, the link behavior is fully controlled by your build system, and can be controlled on a per-binary basis by specifying dynamic_deps on build targets that require dynamic linkage of libusb:
cc_binary(
name = "my_tool",
srcs = ["main.cpp"],
deps = ["@libusb//:libusb"],
dynamic_deps = ["@libusb//:libusb_dynamic"],
)
To build this repo, run:
bazel build @libusb//:libusb