Changes between Version 139 and Version 140 of BuildingGtk


Ignore:
Timestamp:
Jul 22, 2020 4:33:43 AM (14 months ago)
Author:
clopez@igalia.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • BuildingGtk

    v139 v140  
    4242}}}
    4343
    44 === Notes ===
     44
     45==== Notes ====
    4546
    4647 * You can pass parameters to the make command with the ''--makeargs'' argument.
     
    4950 * If you get build errors saying a library could not be found but you have the appropriate packages installed make sure you have up-to-date multiarch-support and binutils (or binutils-gold) packages.
    5051
    51 === Speeding up the build process ===
     52==== Speeding up the build process ====
    5253
    5354There are several tricks that can be used to build [wiki:WebKitGTK WebKitGTK] in less time. Check the [[WebKitGTK/SpeedUpBuild]] page for the details.
    5455
    5556
    56 == OS X ==
     57=== Building the GTK port on MacOS ===
    5758
    58 The code on Mac OS X should built like any Linux distribution, as long as you install the above build dependencies (in addition to an "ordinary build environment" that includes XCode Tools 2.3 or newer). [http://www.macports.org/ MacPorts] users can get the dependencies via:
     59The code on MacOS ''may'' `[1]` build like any Linux distribution, as long as you install the above build dependencies (in addition to an "ordinary build environment" that includes XCode Tools 2.3 or newer). [http://www.macports.org/ MacPorts] users can get the dependencies via:
    5960{{{
    6061#!sh
     
    6869}}}
    6970
     71`[1]` Note: The MacOS build is not actively maintained to the same standards than the Linux one. So your mileage may vary.
    7072
    71 == Cross Compiling for ARM devices ==
    7273
    73 If you need to make ARM builds you might find useful the [https://github.com/mariospr/webkit2gtk-ARM resources hosted in this git repository] which basically provide a [https://cmake.org/cmake/help/v3.6/manual/cmake-toolchains.7.html#cross-compiling-for-linux CMake Toolchain File] to build WebKit2GTK+, together with instructions on how to setup a local chroot environment to use it, so that both the environment and the build are reproducible.
    7474
    75 Wrapping up the instructions in there a bit, you'd basically have to follow 3 steps (or 2, after the initial setup):
    76   1. Create the chroot and provision it, running the [https://github.com/mariospr/webkit2gtk-ARM/blob/master/bootstrap.sh bootstrap script] provided (only once) as root (or with sudo)
    77   2. Configure the build as you please, pointing to the [https://github.com/mariospr/webkit2gtk-ARM/blob/master/armv7l-toolchain.cmake CMake Toolchain provided], which you placed somewhere in your disk
     75== Cross Compiling ==
     76
     77Below there are some tips for cross-compiling
     78
     79=== Yocto / OpenEmbedded ===
     80
     81One of the easiest ways to build WebKitGTK is with Yocto. There are recipes for webkitgtk in the main Yocto layer. On top of that there is also the [https://github.com/Igalia/meta-webkit meta-webkit] layer with extra recipes.
     82
     83
     84=== Using a cross-toolchain ===
     85
     86The instructions below are a bit old and won't work as such (you need a new GCC version now), but you can get an idea of how this can be done:
     87
     88 - If you need to make ARM builds you might find useful the [https://github.com/mariospr/webkit2gtk-ARM resources hosted in this git repository] which basically provide a [https://cmake.org/cmake/help/v3.6/manual/cmake-toolchains.7.html#cross-compiling-for-linux CMake Toolchain File] to build WebKit2GTK+, together with instructions on how to setup a local chroot environment to use it, so that both the environment and the build are reproducible.
     89
     90 - Wrapping up the instructions in there a bit, you'd basically have to follow 3 steps (or 2, after the initial setup):
     91   1. Create the chroot and provision it, running the [https://github.com/mariospr/webkit2gtk-ARM/blob/master/bootstrap.sh bootstrap script] provided (only once) as root (or with sudo)
     92   2. Configure the build as you please, pointing to the [https://github.com/mariospr/webkit2gtk-ARM/blob/master/armv7l-toolchain.cmake CMake Toolchain provided], which you placed somewhere in your disk
    7893{{{
    7994  $ mkdir /path/to/your/WebKit/BUILD && cd /path/to/your/WebKit/BUILD
     
    98113
    99114This has been tested with WebKit2GTK 2.12.x and 2.14.x releases as well as with trunk. If you find any issue/comment, please comment on the [https://github.com/mariospr/webkit2gtk-ARM github repo], or open a pull request.
     115
     116
     117= Running =
     118
     119== Running from git ==
     120
     121{{{
     122#!sh
     123$ Tools/Scripts/run-minibrowser --gtk
     124}}}
     125
     126
     127== Running from a tarball ==
     128
     1291. Install the built product
     1302. Execute your program using WebKit GTK
     131
     132Note: If you want to use the MiniBrowser, you need to enable it at build time by passing ```-DENABLE_MINIBROWSER=ON``` CMake