VERSIONS: Versioning for webkit is somewhat confusing because it's trying to incorporate webkit, gtk and (various linux distribution) versions. The way they version webkitGTK is different from webkit. WebkitGTK: 2.5 is webkit2. [2.4-..) is Gtk3. Further, linux distributions might refer to webkit2 bindings linked against gtk3 differently. E.g on Fedora: webkitgtk4 = webkit2 / Gtk3 webkit2gtk3 = WebKit2/ Gtk3 Webkit2 loading: - Dynamic bindings are auto generated and linked when the @dynamic keyword is used in WebKitGTK.java Unlike in OS.java, you don't have to add any code saying what lib the dynamic method is linked to. It's auto-linked to webkit lib by default. - At no point should you have hard-compiled code, because this will cause crashes on older machines without webkit2. (the exception is the webextension, because it runs as a separate process and is only loaded dynamically). - Try to keep all of your logic in Java and avoid writing custom C-code. (I went down this pit). Because if you use native code, then you have to write dynamic native code (get function pointers, cast types etc.. big pain in the ass). - Don't try to add webkit2 include flags to pkg-config, as this will tie the swt-glue code to specific webkit versions. Thou shall not do this. EVENT_HANDLING_DOC: - On webkit2, signals are implemented via regular gtk mechanism, hook events and pass them along as we receive them. I haven't found a need to use the dom events, because webkitgtk seems to adequately meet the requirements via regular gtk events, but maybe I missed something? Who knows. setUrl(..) with 'post data' was implemented in a very hacky way, via native Java due to missing webkit2gtk api. It's the best that could be done at the time, but it could result in strange behavior like some webpages loading in funky ways if post-data is used. Some good resources that I found are as following: - Webkit2 reference: https://webkitgtk.org/reference/webkit2gtk/stable/ - To understand GDBus, consider reading this guide: http://www.cs.grinnell.edu/~rebelsky/Courses/CSC195/2013S/Outlines/ And then see the relevant reference I made in WebkitGDBus.java. Note, DBus is not the same as GDBus. GDBus is an implementation of the DBus protocol (with it's own quirks). - This is a good starting point for webkit2 extension reading: https://blogs.igalia.com/carlosgc/2013/09/10/webkit2gtk-web-process-extensions/ [April 2018] Note on WebKitContext: We only use a single webcontext, so WebKitGTK.webkit_web_context_get_default() works well for getting this when needed. ~May the force be with you.