RGBCube/serenity
1
Fork 0
mirror of https://github.com/RGBCube/serenity synced 2025-07-27 23:47:45 +00:00
Code Issues Activity Actions

Meta: Add and document convenient method to build non-Qt Ladybird chrome

Browse source 
This lets us switch between the AppKit and Qt chromes more easily.
This commit is contained in:
Timothy Flynn 2023-08-25 07:05:57 -04:00 • committed by Tim Flynn
parent b7f9634f6c
commit 5d7e73adfe
2 changed files with 34 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

19
Documentation/BuildInstructionsLadybird.md
View file

@ -65,12 +65,27 @@ MinGW/MSYS2 are not supported, but may work with sufficient elbow grease. Native
The simplest way to build and run ladybird is via the serenity.sh script:
```
```bash
# From /path/to/serenity
./Meta/serenity.sh run lagom ladybird
./Meta/serenity.sh gdb lagom ladybird
```
By default, the above commands will build Ladybird using Qt for the browser chrome. We also support
the following platform-specific browser chromes:
* [AppKit](https://developer.apple.com/documentation/appkit?language=objc) - The native chrome on macOS.
To build Ladybird using one of these chromes on the appropriate platform, use the following serenity.sh
commands:
```bash
# From /path/to/serenity
./Meta/serenity.sh run lagom ladybird-appkit # Use the AppKit chrome on macOS.
```
### Disabling Ladybird
Note that running ladybird from the script will change the CMake cache in your Build/lagom build
directory to always build LibWeb and Ladybird for Lagom when rebuilding SerenityOS using the
serenity.sh script to run a qemu instance.
@ -78,7 +93,7 @@ serenity.sh script to run a qemu instance.
To restore the previous behavior that only builds code generators and tools from Lagom when
rebuilding serenity, you must modify the CMake cache back to the default.
```
```bash
cmake -S Meta/Lagom -B Build/lagom -DENABLE_LAGOM_LADYBIRD=OFF -DENABLE_LAGOM_LIBWEB=OFF -DBUILD_LAGOM=OFF
```