Notes on WebKit - Revision history

Kraaabs: add backlinks to the eawebkit page ~Sarah

2023-01-29T22:32:51Z

add backlinks to the eawebkit page ~Sarah

← Older revision		Revision as of 22:32, 29 January 2023
Line 35:		Line 35:
	* Try to create an alternative backend for WPE. There is an x11 backend in the tree, but it's broken right now. Can a simple SDL2 backend be created so that we can use WPE on non-Wayland platforms?		* Try to create an alternative backend for WPE. There is an x11 backend in the tree, but it's broken right now. Can a simple SDL2 backend be created so that we can use WPE on non-Wayland platforms?
	* Decouple EGL from WPE. This could either be a lot of work, or fairly easy. Currently I think we can probably copy WPE, rip out the renderer, and replace it with the Cairo<ref>https://www.cairographics.org/</ref> renderer that many of the other ports (including fellow Igalia port WebKit2GTK+) use already. This would provide us with a software rendering option we can use with libWPE... as it stands, I don't think creating a platform from scratch is feasible with a small team, so targeting WPE is smart.		* Decouple EGL from WPE. This could either be a lot of work, or fairly easy. Currently I think we can probably copy WPE, rip out the renderer, and replace it with the Cairo<ref>https://www.cairographics.org/</ref> renderer that many of the other ports (including fellow Igalia port WebKit2GTK+) use already. This would provide us with a software rendering option we can use with libWPE... as it stands, I don't think creating a platform from scratch is feasible with a small team, so targeting WPE is smart.
	* If decoupling EGL is not feasible, and we DO have to write our own backend, ~~EA WebKit~~ (see below) may be a good reference point (it uses a Cairo based renderer, etc).		* If decoupling EGL is not feasible, and we DO have to write our own backend, [[EAWebKit]] (see below) may be a good reference point (it uses a Cairo based renderer, etc).

	== Other interesting WebKit platforms ==		== Other interesting WebKit platforms ==
Line 41:		Line 41:
	[[User:Vmlemon]] has helpfully uncovered a few commercial WebKit backends from throughout history that may be useful resources to look at as far as creating our own platform:		[[User:Vmlemon]] has helpfully uncovered a few commercial WebKit backends from throughout history that may be useful resources to look at as far as creating our own platform:

	* [https://gpl.ea.com/eawebkit.html EA WebKit] - As used in various EA games for embedded UIs/login screens/what have you. A ''very'' clean Cairo-based backend, and a very small codebase. Could be a great resource.		* [https://gpl.ea.com/eawebkit.html EA WebKit] - [[EAWebKit]] is used in various EA games for embedded UIs/login screens/what have you. A ''very'' clean Cairo-based backend, and a very small codebase. Could be a great resource.
	* [https://doc.dl.playstation.net/doc/ps3-oss/webkit.html PS3 WebKit] - As used in the PS3 web browser.		* [https://doc.dl.playstation.net/doc/ps3-oss/webkit.html PS3 WebKit] - As used in the PS3 web browser.
	* [https://github.com/blackberry/WebKit-Smartphone Blackberry WebKit] - As used on pre-BBOS 10 based Blackberry phones (Olympia platform). Could be interesting for future projects...		* [https://github.com/blackberry/WebKit-Smartphone Blackberry WebKit] - As used on pre-BBOS 10 based Blackberry phones (Olympia platform). Could be interesting for future projects...
Line 55:		Line 55:

	Nothing at all! NetFront NX is literally just renamed WebKit. Nothing has changed except the branding. I'm thinking it's more of a "service" than a "product".		Nothing at all! NetFront NX is literally just renamed WebKit. Nothing has changed except the branding. I'm thinking it's more of a "service" than a "product".

			== See also ==
			[[EAWebKit]]

	== Notes and References ==		== Notes and References ==

Kraaabs: /* Other interesting WebKit platforms */

2023-01-26T03:56:06Z

Other interesting WebKit platforms

← Older revision		Revision as of 03:56, 26 January 2023
Line 44:		Line 44:
	* [https://doc.dl.playstation.net/doc/ps3-oss/webkit.html PS3 WebKit] - As used in the PS3 web browser.		* [https://doc.dl.playstation.net/doc/ps3-oss/webkit.html PS3 WebKit] - As used in the PS3 web browser.
	* [https://github.com/blackberry/WebKit-Smartphone Blackberry WebKit] - As used on pre-BBOS 10 based Blackberry phones (Olympia platform). Could be interesting for future projects...		* [https://github.com/blackberry/WebKit-Smartphone Blackberry WebKit] - As used on pre-BBOS 10 based Blackberry phones (Olympia platform). Could be interesting for future projects...
	* [https://www.~~3dbrew~~.~~org~~/w/index.~~php?title=Internet_Browser 3DS~~ WebKit (NetFront)] - A variant of Access Co. Ltd.'s WebKit platform NetFront. '''(update: doesn't actually contain any 3DS modifications...?)'''		* [https://www.nintendo.co.jp/support/oss/index.html Nintendo WebKit (NetFront NX)] - A variant of Access Co. Ltd.'s WebKit platform NetFront NX, as used on the Wii U, Switch, and 3DS. '''(update: doesn't actually contain any 3DS/Wii U/Switch modifications...?)'''
	* [https://doc.dl.playstation.net/doc/psvita-oss/webkit.html PS Vita WebKit] - Another Sony WebKit variant, for the PlayStation Vita.		* [https://doc.dl.playstation.net/doc/psvita-oss/webkit.html PS Vita WebKit] - Another Sony WebKit variant, for the PlayStation Vita.
	* [https://archive.org/details/web-core-08w-11-prod-08w-37 Nokia S40 WebKit] - As used in the browser for Nokia S40 phones. Previously lost, was recovered by [[User:Vmlemon\|vmlemon]] from an old hard drive.		* [https://archive.org/details/web-core-08w-11-prod-08w-37 Nokia S40 WebKit] - As used in the browser for Nokia S40 phones. Previously lost, was recovered by [[User:Vmlemon\|vmlemon]] from an old hard drive.

Kraaabs: /* Where are we right now? */

2023-01-26T03:54:29Z

Where are we right now?

← Older revision		Revision as of 03:54, 26 January 2023
Line 35:		Line 35:
	* Try to create an alternative backend for WPE. There is an x11 backend in the tree, but it's broken right now. Can a simple SDL2 backend be created so that we can use WPE on non-Wayland platforms?		* Try to create an alternative backend for WPE. There is an x11 backend in the tree, but it's broken right now. Can a simple SDL2 backend be created so that we can use WPE on non-Wayland platforms?
	* Decouple EGL from WPE. This could either be a lot of work, or fairly easy. Currently I think we can probably copy WPE, rip out the renderer, and replace it with the Cairo<ref>https://www.cairographics.org/</ref> renderer that many of the other ports (including fellow Igalia port WebKit2GTK+) use already. This would provide us with a software rendering option we can use with libWPE... as it stands, I don't think creating a platform from scratch is feasible with a small team, so targeting WPE is smart.		* Decouple EGL from WPE. This could either be a lot of work, or fairly easy. Currently I think we can probably copy WPE, rip out the renderer, and replace it with the Cairo<ref>https://www.cairographics.org/</ref> renderer that many of the other ports (including fellow Igalia port WebKit2GTK+) use already. This would provide us with a software rendering option we can use with libWPE... as it stands, I don't think creating a platform from scratch is feasible with a small team, so targeting WPE is smart.
			* If decoupling EGL is not feasible, and we DO have to write our own backend, EA WebKit (see below) may be a good reference point (it uses a Cairo based renderer, etc).

	== Other interesting WebKit platforms ==		== Other interesting WebKit platforms ==

Kraaabs: Sony WebKit is NOT NetFront NX ~Sarah

2023-01-26T03:50:46Z

Sony WebKit is NOT NetFront NX ~Sarah

← Older revision		Revision as of 03:50, 26 January 2023
Line 47:		Line 47:
	* [https://archive.org/details/web-core-08w-11-prod-08w-37 Nokia S40 WebKit] - As used in the browser for Nokia S40 phones. Previously lost, was recovered by [[User:Vmlemon\|vmlemon]] from an old hard drive.		* [https://archive.org/details/web-core-08w-11-prod-08w-37 Nokia S40 WebKit] - As used in the browser for Nokia S40 phones. Previously lost, was recovered by [[User:Vmlemon\|vmlemon]] from an old hard drive.

	The commonly held belief is that the Sony WebKit variants are also Access Co's NetFront. ~~However, contributions~~ to the ~~mainline WebKit tree have some~~ Sony copyrights ~~attached~~. ~~Further investigation is needed to determine which is which~~.		The commonly held belief is that the Sony WebKit variants are also Access Co's NetFront. This appears to be false (at least for the PS3 and Vita variants). These variants contain ''Sony'' copyrights, not ''Access'' copyrights like the other NetFront NX-based stuff. (Not that that makes much difference. See below.)

	'''NOTE THAT THESE WEBKIT VARIANTS ARE FREELY DISTRIBUTABLE/MODIFIABLE UNDER THE LGPL!'''		'''NOTE THAT THESE WEBKIT VARIANTS ARE FREELY DISTRIBUTABLE/MODIFIABLE UNDER THE LGPL!'''

Kraaabs at 03:49, 26 January 2023

2023-01-26T03:49:04Z

← Older revision		Revision as of 03:49, 26 January 2023
Line 43:		Line 43:
	* [https://doc.dl.playstation.net/doc/ps3-oss/webkit.html PS3 WebKit] - As used in the PS3 web browser.		* [https://doc.dl.playstation.net/doc/ps3-oss/webkit.html PS3 WebKit] - As used in the PS3 web browser.
	* [https://github.com/blackberry/WebKit-Smartphone Blackberry WebKit] - As used on pre-BBOS 10 based Blackberry phones (Olympia platform). Could be interesting for future projects...		* [https://github.com/blackberry/WebKit-Smartphone Blackberry WebKit] - As used on pre-BBOS 10 based Blackberry phones (Olympia platform). Could be interesting for future projects...
	* [https://www.3dbrew.org/w/index.php?title=Internet_Browser 3DS WebKit (NetFront)] - A variant of Access Co. Ltd.'s WebKit platform NetFront.		* [https://www.3dbrew.org/w/index.php?title=Internet_Browser 3DS WebKit (NetFront)] - A variant of Access Co. Ltd.'s WebKit platform NetFront. '''(update: doesn't actually contain any 3DS modifications...?)'''
	* [https://doc.dl.playstation.net/doc/psvita-oss/webkit.html PS Vita WebKit] - Another Sony WebKit variant, for the PlayStation Vita.		* [https://doc.dl.playstation.net/doc/psvita-oss/webkit.html PS Vita WebKit] - Another Sony WebKit variant, for the PlayStation Vita.
	* [https://archive.org/details/web-core-08w-11-prod-08w-37 Nokia S40 WebKit] - As used in the browser for Nokia S40 phones. Previously lost, was recovered by [[User:Vmlemon\|vmlemon]] from an old hard drive.		* [https://archive.org/details/web-core-08w-11-prod-08w-37 Nokia S40 WebKit] - As used in the browser for Nokia S40 phones. Previously lost, was recovered by [[User:Vmlemon\|vmlemon]] from an old hard drive.
Line 50:		Line 50:

	'''NOTE THAT THESE WEBKIT VARIANTS ARE FREELY DISTRIBUTABLE/MODIFIABLE UNDER THE LGPL!'''		'''NOTE THAT THESE WEBKIT VARIANTS ARE FREELY DISTRIBUTABLE/MODIFIABLE UNDER THE LGPL!'''

			=== What makes NetFront NX different from regular WebKit? ===

			Nothing at all! NetFront NX is literally just renamed WebKit. Nothing has changed except the branding. I'm thinking it's more of a "service" than a "product".

	== Notes and References ==		== Notes and References ==

Kraaabs: Add section for existing third-party out-of-tree WebKit platforms (commercial stuff) ~Sarah

2023-01-26T02:49:22Z

Add section for existing third-party out-of-tree WebKit platforms (commercial stuff) ~Sarah

@@ Line 35: / Line 35: @@
 * Try to create an alternative backend for WPE. There is an x11 backend in the tree, but it's broken right now. Can a simple SDL2 backend be created so that we can use WPE on non-Wayland platforms?
 * Decouple EGL from WPE. This could either be a lot of work, or fairly easy. Currently I think we can probably copy WPE, rip out the renderer, and replace it with the Cairo<ref>https://www.cairographics.org/</ref> renderer that many of the other ports (including fellow Igalia port WebKit2GTK+) use already. This would provide us with a software rendering option we can use with libWPE... as it stands, I don't think creating a platform from scratch is feasible with a small team, so targeting WPE is smart.
 == Notes and References ==

Kraaabs at 20:37, 25 January 2023

2023-01-25T20:37:41Z

← Older revision		Revision as of 20:37, 25 January 2023
Line 1:		Line 1:
	[[Category:Preservation and Documentation]]		[[Category:Preservation and Documentation]]
	[[Category:Projects]]		[[Category:Projects]]

	WebKit is an open source Apple-led browser engine project that powers Safari and Epiphany, as well as being the original basis for Google's Blink engine. It is notably portable<ref>https://blogs.igalia.com/jaragunde/files/2015/10/igalia_building_browser_automotive.pdf</ref><ref>https://eu.access-company.com/netfront-html5-platforms-for-automotive.html</ref>, powering platforms such as automotive displays, game consoles, and more.		WebKit is an open source Apple-led browser engine project that powers Safari and Epiphany, as well as being the original basis for Google's Blink engine. It is notably portable<ref>https://blogs.igalia.com/jaragunde/files/2015/10/igalia_building_browser_automotive.pdf</ref><ref>https://eu.access-company.com/netfront-html5-platforms-for-automotive.html</ref>, powering platforms such as automotive displays, game consoles, and more.

Kraaabs: Initial WebKit page ~Sarah

2023-01-25T20:34:45Z

Initial WebKit page ~Sarah

New page

[[Category:Preservation and Documentation]]
[[Category:Projects]]

WebKit is an open source Apple-led browser engine project that powers Safari and Epiphany, as well as being the original basis for Google's Blink engine. It is notably portable<ref>https://blogs.igalia.com/jaragunde/files/2015/10/igalia_building_browser_automotive.pdf</ref><ref>https://eu.access-company.com/netfront-html5-platforms-for-automotive.html</ref>, powering platforms such as automotive displays, game consoles, and more.

Unfortunately, WebKit documentation is fairly sparse -- especially when it comes to creating a "platform" that embeds WebKit directly. Therefore, most open source embedded WebKit projects (such as the headless browsers listed [https://github.com/dhamaniasad/HeadlessBrowsers here]) choose to use the existing GTK+ or Qt backends instead of using WebKit itself directly; this introduces additional dependencies, and makes it more difficult to port WebKit to platforms with fewer resources or library availability.

Documenting the WebKit API will hopefully make it easier to port WebKit to weaker/vintage platforms, and also create a better understanding of what's going wrong when things inevitably go wrong...

== Architecture ==

WebKit is actually not the browser engine itself<ref>https://trac.webkit.org/wiki/SourceDirectory</ref>. Rather, WebKit is a frontend API that brings together WebCore (the rendering/layout engine) and JavaScriptCore (the JavaScript runtime) under one umbrella for browsers/platforms to use.

As a note, there are actually two WebKit APIs. WebKit2<ref>https://trac.webkit.org/wiki/WebKit2</ref> (now usually referred to as just "WebKit") is the current, "modern" API, with features such as multi-process rendering, sandboxing support, and more. The old API, which used to just be called "WebKit"<ref>Yes. This will cause confusion.</ref> is now called "WebKitLegacy". This is a more "classical" browser engine that runs in a single process and has little to no support for modern browser sandboxing features. It's kept in the tree, but I believe it's deprecated.

Modern ports (such as WPE or WebKit2GTK+) use the WebKit2/WebKit API. To avoid confusion over naming, this page will refer to the modern API as "WebKit2", and the older API as "WebKitLegacy" to avoid ambiguity.

=== Where does WPE factor in? ===

Igalia<ref>https://www.igalia.com/</ref> is an open source consultancy firm that is one of the primary non-Apple contributors to the WebKit codebase. Most notably, they maintain the WebKit2GTK+ port, as well as WPE.

WPE can be considered a "meta" or "hybrid"<ref>https://wpewebkit.org/about/architecture.html</ref> platform. Rather than targeting a specific UI toolkit or platform, it instead acts as a sort of shim on top of libWPE, which itself is a stripped back WebKit API. libWPE can target multiple backends, similarly to full-fat WebKit, and it's intended for use mostly in embedded applications, such as automotive displays or kiosks.

WPE only has a few hard dependencies by design. The most notable and largest of these is EGL (meaning WPE does require a "real" GPU running on Linux or (maybe) BSD).

== How do we add a new platform? ==

With great difficulty. WebKit's build system is old and large. Most of the build system is CMake, but there are also various Perl, Python, and Ruby scripts thrown into the mix gluing various things together (most notably the Perl scripts that manage WebKit developer builds). This means that adding a new platform involves writing a total of about a dozen CMake scripts, modifying the Perl scripts, and figuring out which build system options and configuration <code>#define</code>s are needed in order to get the platform working. There is some limited documentation<ref>https://trac.webkit.org/wiki/SuccessfulPortHowTo</ref> on this on the WebKit wiki... but it's mostly undocumented. This is where the most work will have to be done.

JSCOnly is a "platform" with a minimal setup that just builds JavaScriptCore and nothing else. This is often cited as an example to look at when creating a new platform. However, WPE is also likely something to look at, as it includes an actual renderer. This may help provide a better indication of what needs to get done.

== Where are we right now? ==

At the moment, [[User:Kraaabs]] has managed to build the WPE port, the libWPE Wayland/FDO backend, as well as cog<ref>https://github.com/Igalia/cog</ref>, the "reference" WPE frontend. Next steps are:

* Try to create an alternative backend for WPE. There is an x11 backend in the tree, but it's broken right now. Can a simple SDL2 backend be created so that we can use WPE on non-Wayland platforms?
* Decouple EGL from WPE. This could either be a lot of work, or fairly easy. Currently I think we can probably copy WPE, rip out the renderer, and replace it with the Cairo<ref>https://www.cairographics.org/</ref> renderer that many of the other ports (including fellow Igalia port WebKit2GTK+) use already. This would provide us with a software rendering option we can use with libWPE... as it stands, I don't think creating a platform from scratch is feasible with a small team, so targeting WPE is smart.

== Notes and References ==