The goal of this project is to enable Chromium browser to run on Wayland. Note that contrary to 01.org/ozone-wayland, the idea is to keep it very close to upstream developments as well as aligned on Google's own plans. In particular, this fork is rebased against Chromium ToT each week and patches are upstreamed as soon as possible.
The implementation also relies on actively developed Chromium technologies:
- Aura and MUS for the user interface.
- Ozone as a platform abstraction layer together with the upstream Wayland backend.
- Mojo to perform IPC communication.
Notice that the effort done here is also useful to run Chromium via MUS on Linux Desktop for X11.
Chromium
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all users to experience the web.
The project's web site is https://www.chromium.org.
Documentation in the source is rooted in docs/README.md.
Learn how to Get Around the Chromium Source Code Directory Structure .
General information is provided by the upstream documentation for Chromium on Linux and Ozone. Here is the summary of commands to build and run Chrome for Wayland:
gn args out/Ozone --args="use_ozone=true enable_package_mash_services=true"
ninja -C out/Ozone chrome
./out/Ozone/chrome --mus --ozone-platform=wayland
By default, the headless, x11 and wayland Ozone backends are
compiled and X11 is selected when --ozone-platform is not specified.
Please refer to the
GN Configuration notes for details on how to change
that behavior.
Most of the Chromium tests should pass although they are not regularly tested for now. One can run the MUS Demo as follows:
ninja -C out/Ozone mus_demo mash:all
./out/Ozone/mash --service=mus_demo --external-window-count=2
One can also run automated unit tests. For example to check the MUS demo and window server:
ninja -C out/Ozone mus_ws_unittests mus_demo_unittests
./out/Ozone/mus_demo_unittests
./out/Ozone/mus_ws_unittests
Note that --ozone-platform can be passed to all the programs above to select
a specific Ozone backend.
As mentioned above, the fork is rebased every week against Chromium ToT. The goal is to be as close as possible to the lastest Mus code, which is constantly receiving performance and stability fixes.
Here is the current process:
-
Every week, a member of the Igalia Chromium team takes the rebase shift.
-
Commits that are complementary of each other, receive a "fixup!" prefix on the commit title, and keep the rest of original commit title unchanged.
For example:
$ git log --oneline
commit 1
commit 2
commit 3
fixup! commit 1
fixup! commit 2
commit 4
fixup! commit 2
(..)
This allows an easy identification of "fixup" commits, which should be squashed into their original counterpart commit as part of the next rebase cycle. That way we keep our Git history clean, and commits as atomic as possible, for when upstreaming.
Git has an optimized flow for this as well.
- We always keep the 'ozone-wayland-dev' branch as our primarily development branch.
This means that force pushes will happen. So every time one of the team members rebases our branch, the developer should first back up the existing ozone-wayland-dev browser, with the following naming: ozone-wayland-dev-rXXXX, where XXXX is the respective Chromium baseline of the branch.
- Branch acceptance criteria
compilation targets:
chrome mash:all mus_ws_unittests base_unittests services/ui/demo mus_*_unittests ozone_unittests mus_demo_unittests
... on LinuxOS and ChromeOS builds.
Pass mus_demo and mus_demo_unittests tests.
Run chrome --mash / --mus on the configurations above, and performance some sanity tests: basic mouse clicking / keyboard; basic navigation; multi window creation; etc.
- Keep our internal buildbot green.