mirror of
https://bitbucket.org/chromiumembedded/cef
synced 2024-12-26 17:42:35 +01:00
a6c00b2ff6
Add support for building the CEF binary distribution using Bazel and the default platform toolchain. Tested to work for Windows x64, MacOS ARM64 and x64 (cross-compile from ARM64), and Linux x64. Windows x86 (cross-compile from x64) is known to be broken, see https://github.com/bazelbuild/bazel/issues/22164. Includes minor changes to tests directory structure to meet Bazel build requirements. |
||
|---|---|---|
| .. | ||
| README.minimal.txt | ||
| README.redistrib.txt | ||
| README.standard.txt | ||
CONTENTS
--------
bazel Contains Bazel configuration files shared by all targets.
cmake Contains CMake configuration files shared by all targets.
Debug Contains libcef.so and other components required to run the debug
version of CEF-based applications. By default these files should be
placed in the same directory as libcef.so and will be copied there
as part of the build process.
include Contains all required CEF header files.
libcef_dll Contains the source code for the libcef_dll_wrapper static library
that all applications using the CEF C++ API must link against.
Release Contains libcef.so and other components required to run the release
version of CEF-based applications. By default these files should be
placed in the same directory as libcef.so and will be copied there
as part of the build process.
Resources Contains resources required by libcef.so. By default these files
should be placed in the same directory as libcef.so and will be
copied there as part of the build process.
tests/ Directory of tests that demonstrate CEF usage.
cefclient Contains the cefclient sample application configured to build
using the files in this distribution. This application demonstrates
a wide range of CEF functionalities.
cefsimple Contains the cefsimple sample application configured to build
using the files in this distribution. This application demonstrates
the minimal functionality required to create a browser window.
ceftests Contains unit tests that exercise the CEF APIs.
gtest Contains the Google C++ Testing Framework used by the ceftests
target.
shared Contains source code shared by the cefclient and ceftests targets.
USAGE
-----
Building using CMake:
CMake can be used to generate project files in many different formats. See
usage instructions at the top of the CMakeLists.txt file.
Building using Bazel:
Bazel can be used to build CEF-based applications. CEF support for Bazel is
considered experimental. For current development status see
https://github.com/chromiumembedded/cef/issues/3757.
To build the bundled cefclient sample application using Bazel:
1. Install Bazelisk [https://github.com/bazelbuild/bazelisk/blob/master/README.md]
2. Install the patchelf package:
$ sudo apt install patchelf
3. Build using Bazel:
$ bazel build //tests/cefclient
4. Run using Bazel:
$ bazel run //tests/cefclient
Other sample applications (cefsimple, ceftests) can be built in the same way.
Additional notes:
- To generate a Debug build add `-c dbg` (both `build` and `run`
command-line).
- To pass arguments using the `run` command add `-- [...]` at the end.
Please visit the CEF Website for additional usage information.
https://bitbucket.org/chromiumembedded/cef/