Github-CI:
OS | Bazel | CMake |
---|---|---|
Linux | ||
MacOS | ||
Windows | ||
Docker |
Bazel C++ and Protobuf sample with tests and GitHub CI support.
This project should run on GNU/Linux, MacOS and Windows.
note: A CMake support is also provided as comparison
You'll need:
- "Bazel >= 6.0".
- "CMake >= 3.25".
The project layout is as follow:
To complexify a little, the CMake project is composed of three libraries (Foo, Bar and FooBar) with the following dependencies:
Foo:
Bar:
FooBar: PUBLIC Foo PRIVATE Bar
App: PRIVATE FooBar
note: Since Foo
is a public dependency of FooBar
, then FooBarApp
will
see Foo
inlude directories
To build this example you should use:
-
on UNIX:
bazel build -c opt --action_env=BAZEL_CXXOPTS="-std=c++17" --subcommands=true ...
-
on Windows when using MSVC:
bazel build -c opt --cxxopt="/std:c++17" --subcommands=true ...
To build this example you should use:
-
on UNIX:
bazel test -c opt --action_env=BAZEL_CXXOPTS="-std=c++17" --test_output=all ...
-
on Windows when using MSVC:
bazel test -c opt --cxxopt="/std:c++17" --test_output=all ...
In Bazel, subdirectories containing BUILD files are known as packages.
The new property visibility
will tell Bazel which package(s) can reference this target, in this case the //main
package can use hello-time
library.
lib/BUILD:
cc_library(
name = "hello-time",
srcs = ["hello-time.cc"],
hdrs = ["hello-time.h"],
visibility = ["//main:__pkg__"],
)
To use our hello-time
libary, an extra dependency is added in the form of //path/to/package:target_name
, in this case, it's //lib:hello-time
.
main/BUILD:
cc_binary(
name = "hello-world",
srcs = ["hello-world.cc"],
deps = [
":hello-greet",
"//lib:hello-time",
],
)
Please take a look at .github/workflows to find the configuration file for each jobs.
To install bazel on each hosted runner, follow these links: ref: https://docs.github.com/en/actions/using-github-hosted-runners/customizing-github-hosted-runners#installing-software-on-windows-runners
- Linux (Ubuntu latest LTS) ->
apt-get install bazel
ref: https://docs.bazel.build/versions/main/install-ubuntu.html
(as of 06/2021 Ubuntu 20.04 LTS is still not supported according to the doc...) - MacOS ->
brew install bazel
ref: https://formulae.brew.sh/formula/bazel#default - Windows ->
choco install bazel
ref: https://community.chocolatey.org/packages/bazel/
Few links on the subject...
Project layout:
- The Pitchfork Layout Revision 1 (cxx-pflR1)
Bazel:
Image has been generated using plantuml:
plantuml -Tsvg docs/{file}.dot
So you can find the dot source files in docs.
Apache 2. See the LICENSE file for details.
This is not an official Google product, it is just code that happens to be owned by Google.