Google Git
Sign in
pigweed / pigweed / rules_libusb / 7f91dc339a79292ab8aa5ca127572e54b0b586e8
commit7f91dc339a79292ab8aa5ca127572e54b0b586e8[log] [tgz]
authorArmando Montanez <amontanez@google.com>Mon Mar 17 14:55:09 2025 -0700
committerCQ Bot Account <pigweed-scoped@luci-project-accounts.iam.gserviceaccount.com>Mon Mar 17 14:55:09 2025 -0700
tree7f5c02d8e4ccdd705b02411308786b40bb0ecf36
parent2eb93d2b1f9d19a9e81e4abc6bb07ad39258dc0e [diff]
Cut over to 0.1.0-RC2

Bug: b/403670487
Change-Id: Ib9ce8217f859c1ffa07a5858f8c3874e32973bef
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/rules_libusb/+/276532
Commit-Queue: Auto-Submit <auto-submit@pigweed-service-accounts.iam.gserviceaccount.com>
Lint: Lint 🤖 <android-build-ayeaye@system.gserviceaccount.com>
Pigweed-Auto-Submit: Armando Montanez <amontanez@google.com>
Presubmit-Verified: CQ Bot Account <pigweed-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Ted Pudlik <tpudlik@google.com>
1 file changed
tree: 7f5c02d8e4ccdd705b02411308786b40bb0ecf36
  1. examples/
  2. include/
  3. linux/
  4. .bazelignore
  5. .gitignore
  6. AUTHORS
  7. BUILD.bazel
  8. CONTRIBUTING.md
  9. extensions.bzl
  10. libusb.BUILD
  11. LICENSE
  12. MODULE.bazel
  13. OWNERS
  14. README.md
README.md

rules_libusb

A small wrapper Bazel module that builds libusb from sources. Supports Windows, macOS, and Linux.

Getting Started

At this time, rules_libusb only supports bzlmod projects. Legacy WORKSPACE projects are not explicitly supported.

blzmod

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"],
)

Linking 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"],
)

Building this repo

To build this repo, run:

bazel build @libusb//:libusb