cef/tools/distrib
Marshall Greenblatt 08ae3a44a6 bazel: Fix resource paths as external repo (see #3757)
- Headers that are included by .rc files need to be supplied to
  `declare_exe` via the `resources_deps` attribute (passed as the `deps
  attribute to `compile_rc`). The headers must be part of a cc_library
  target via either the `hdrs` or `srcs` attribute.
- File paths for CEF resources are prefixed with "external/<repo>"
  when CEF is loaded as an external repo. Update `copy_filegroups` to
  work with these paths.
2024-08-02 16:51:11 -04:00
..
bazel bazel: Fix resource paths as external repo (see #3757) 2024-08-02 16:51:11 -04:00
gtest Check in fused GTest files 2021-08-24 17:43:02 -04:00
linux bazel: Add initial config for binary distribution (see #3757) 2024-07-28 18:19:47 +00:00
mac bazel: Add initial config for binary distribution (see #3757) 2024-07-28 18:19:47 +00:00
tools distrib: Add new tools distribution for mksnapshot (see #3734) 2024-07-16 12:43:12 -04:00
win bazel: Add initial config for binary distribution (see #3757) 2024-07-28 18:19:47 +00:00
README-TRANSFER.txt Branch CEF3 files from /branches/cef3 to /trunk/cef3 (issue #564). 2012-04-03 01:34:16 +00:00
README.client.txt Linux: Include cefsimple instead of cefclient in client distribution (issue #1916) 2016-06-06 18:23:15 -04:00
README.footer.txt make_distrib improvements: 2013-04-11 23:07:43 +00:00
README.header.txt Fix README typo 2017-12-18 14:18:03 -05:00
README.tools.txt distrib: Add new tools distribution for mksnapshot (see #3734) 2024-07-16 12:43:12 -04:00
transfer.cfg win: Fix MSVC compile error with cef_color_ids.h (see #3671) 2024-04-11 11:29:51 -04:00
transfer_standard.cfg Don't include ceftests/resources in minimal distrib (fixes issue #3408) 2022-10-10 14:11:22 -04:00

README.tools.txt

CONTENTS
--------

Debug       Contains the Debug build of tools.

Release     Contains the Release build of tools.


IMPORTANT NOTE
--------------

CEF/Chromium builds are created using the following host architectures:

- Linux:   x86-64 (Intel/AMD)
- Windows: x86-64 (Intel/AMD)
- MacOS:   ARM64 (Apple Silicon)

Binaries in this tools package must be run on the supported host OS/architecture
even in cases where the output targets a different architecture.

For example, files targeting a MacOS 64-bit (Intel) application must be created
on a MacOS ARM64 (Apple Silicon) host system using the MacOS 64-bit (Intel)
tools distribution.


USAGE
-----

Start with the required host system and the tools distribution that matches your
application's target OS/architecture and CEF version.

Custom V8 Snapshots

Custom startup snapshots [https://v8.dev/blog/custom-startup-snapshots] can be
used to speed up V8/JavaScript load time in the renderer process. With CEF this
works as follows:

1. Generate a single JavaScript file that contains custom startup data. For
   example, using https://github.com/atom/electron-link.

2. Execute the `run_mksnapshot` script to create a `v8_context_snapshot.bin`
   file containing the custom data in addition to the default V8 data.

   Example:
   % run_mksnapshot Release /path/to/snapshot.js

   Note that bin file names include an architecture component on MacOS
   (e.g. `v8_context_snapshot.[arm64|x86_64].bin`)

3. Replace the existing `v8_context_snapshot.bin` file in the installation
   folder or app bundle.

4. Run the application and verify in DevTools that the custom startup data
   exists. For example, electron-link adds a global `snapshotResult` object.

Please visit the CEF Website for additional usage information.

https://bitbucket.org/chromiumembedded/cef/