Current build and test status:

The following build combinations are tested automatically for each PR (the current config only allows to generate 1 summary badge, for everything):

• all supported Yocto versions (Kirkstone, Scarthgap, Styhead, Walnascar/master)
• both ESR and latest Firefox version
• glibc and musl
• 4 arches: arm, aarch64, riscv-64 and x86-64

All combinations of the above are tested, except for RISC-V@Kirkstone combinations, which are not tested.

This layer provides web browser recipes for use with OpenEmbedded and/or Yocto.

This layer depends on oe-core (poky), meta-oe and meta-clang. Additionally, the Rust version shipped with Kirkstone and Scarthgap oe-core is out of date, which can be remediated by other third-party layers: for Kirkstone and Scarthgap version the corresponding branch of meta-lts-mixins is required for up to date Rust compiler. It is fairly easy to make meta-rust layer work also, however there is no out of box support for it anymore.

For the tested revision/release combinations, see meta-firefox-test repository, especially the kas folder - that contains all the branch/revision information used for testing.

meta-clang layer requires libstdc++ to be installed on the build machine - make sure to install it, in case it is missing (e.g. on Debian based systems install libstdc++-dev or on Fedora install libstdc++-devel)

Note: Firefox requires at least Rust 1.76 starting from version 127, and Rust 1.82 from version 137.

At this time the state of Rust in the Yocto ecosystem is not the best. Master/Walnascar provides 1.83 - so this works for all Firefox. meta-lts-mixins layers however are below 1.82 for both Kirkstone and Scarthgap, and until this doesn't change, meta-rust layer should be used.

For Styhead there is no up to date Rust available officially.

When using meta-rust, make sure to add the following to a bbappend or local.conf:

# when using a bbappend
RUST_HOST = "${BUILD_SYS}"
RUST_TARGET = "${TARGET_SYS}"

# when using local.conf
RUST_HOST:pn-firefox = "${BUILD_SYS}"
RUST_TARGET:pn-firefox = "${TARGET_SYS}"

Due to this, the selection of Rust provider needs some caution. Testing is performed using the following combinations (the "latest" version should also be able to compile "ESR"):

Note1: The latest available Rust for Scarthgap is 1.81.0 in meta-lts-mixins layer. Meta-rust layer claims to have version 1.82.0 and is compatible with Scarthgap, however unfortunately in practice it throws various errors. I expect meta-lts-mixins to be updated in the foreseeable future, however until then I have backported some relevant patches from oe-core master to a fork of meta-lts-mixins: https://github.com/OldManYellsAtCloud/meta-lts-mixins Testing was performed successfully using this Rust version. Note that this fork mostly for testing, and while I am willing to support it to build Firefox, in general it shouldn't be used for other things than experimenting.

Note2: The latest available Rust for Styhead is 1.79 at the time of writing this, and that branch is only weeks away from being EOL. Due to this, the latest Firefox version was not tested with it. In case you find up-to-date enough recipes for Rust that work on Styhead, Firefox should work also. In case support is needed, I can only provide very limited about for this combination.

The preferred way to contribute to this layer is to send GitHub pull requests or report problems in GitHub's issue tracker.

Classic patch submissions via email are not accepted for this layer.

• OldManYellsAtCloud/Gyorgy Sarvari skandigraun@gmail.com

recipes-browser/firefox: Firefox browser.

This recipe provides a package for the Firefox web browser.

Two separate recipes are available: one for the latest stable version, and one for the latest ESR version.

recipes-browser/firefox-i10l: Language packs for Firefox. The default language is English, but installing any of these packages will make the new language available in the settings menu.

• alsa: (detected automatically) Enable ALSA support to play audio. It will be enabled automatically when DISTRO_FEATURES contains "alsa". Note that Firefox's default audio backend is PulseAudio, not ALSA. Although it's not enabled in official build, we enable it by default to make easy to play audio without additional daemons. When PulseAudio is running, it will be used instead of using ALSA directly even if this config is specified.

• wayland: (detected automatically) Enable wayland support. It will be enabled automatically when DISTRO_FEATURES contains "wayland".

• gpu: (off by default) Enable GPU acceleration.

• openmax: (off by default) Enable OpenMAX IL decoder to play H.264 video. This features is confirmed only on Renesas RZ/G1. Note: it is untested with version 113+.

• webgl: (off by default) Firefox on Linux doesn't enable WebGL against most GPUs by default. This option adds a config file to enable it forcedly.

• forbid-multiple-compositors: (off by default) This option allows to create only one GPU accelerated compositor, second and the following windows will use basic compositors. Multiple compositor may cause crash on platforms that doesn't support multiple EGL windows.

• disable-sandboxed-libraries: (off by default) By default WASM libraries are sandboxed for security purposes, however that can introduce quite a big build-time overhead due to extra dependencies. Setting this disallows sandboxing these libraries, and removes the wasi-sdk dependency.

• disable-gecko-profiler: (on by default, only v127+) Disable collecting profile statistics in different components of the browser. Reduces resource and size footprint (though not drastically).

• rust-simd: (on by default) Enable explicit SIMD in Rust code, when supported by the CPU.

• wayland-only: (off by default, only v120+) Don't build Firefox with X11 dependencies. This config should not be enabled if x11-only is enabled.

• x11-only: (off by default, only v120+) Don't build Firefox with Wayland dependencies. This config should not be enable if wayland-only is enabled.

• system-av1: (off by default) Use system av1. Currently untested.

• system-nspr: (off by default and autodetected in some cases) Use NSPR from the operating system, instead of building it with Firefox. In case an ARM CPU is the target without cryptographic capabilities, this config is automatically enabled.

• system-nss: (off by default and autodetected in some cases) Use NSS from the operating system, instead of building it with Firefox. In case an ARM CPU is the target without cryptographic capabilities, this config is automatically enabled.

• system-ffi: (off by default) Use system libffi

• system-icu: (off by default) Use system ICU.

• system-zlib: (off by default) Use system libz.

• system-pixman: (off by default) Use system pixman.

• system-jpeg: (off by default) Use system libjpeg.

• system-libevent: (off by default) Use system libevent.

• system-libvpx: (off by default) Use system libvpx.

• system-png: (off by default) Use system libpng (APNG support is required).

• system-webp: (off by default) Use system libwebp.

While the source tarballs contains most of the compile dependencies, unfortunately some are missing, making it impossible to build Firefox without network connection. Due to this the Rust crates are downloaded directly (the list of downloaded crates and their version is taken from the third_party/rust folder), and some are downloaded from git directly (for the most part these were gathered from the top level Cargo.toml). This section hopefully documents where those magic commit hashes come from. (And will also be helpful for me, when I'm trying to figure out where a specific dependency is coming from during updating to new versions).

In case a dependency is required by multiple sources, and they specify different versions, the latest version is taken into account only.

Note: the dependency column refers to the destsuffix used in the recipes.