Gtkmozembed: Difference between revisions

m
(Update status.)
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Introduction ==
== Introduction ==
[[http://www.mozilla.org/unix/gtk-embedding.html GtkMozEmbed]] is an embedding API designed many years ago for use in Gtk applications.


[[http://www.mozilla.org/unix/gtk-embedding.html GtkMozEmbed]] is an embedding API designed many years ago for use in Gtk applications. See also [[http://lxr.mozilla.org/seamonkey/source/embedding/browser/gtk/src/ source code]]
See also [[http://lxr.mozilla.org/seamonkey/source/embedding/browser/gtk/src/ source code]]


Gtk is built around Glib signals and has a fixed C structure method dispatch design. GtkMozEmbed unfortunately isn't perfect and was designed with basically a single object to represent the entire browser of its time. This didn't scale well and unfortunately wrapping each and every object in Gecko is unreasonable. It is conceivable that someone might someday make a Glib-connect XPTCall layer or something like it that could proxy between XPCOM (or its replacement) and Glib. The main advantage of doing this is that no person would have to manually spend time writing bloaty wrappers for each and every imaginable Gecko object.
Gtk is built around Glib signals and has a fixed C structure method dispatch design. GtkMozEmbed unfortunately isn't perfect and was designed with basically a single object to represent the entire browser of its time. This didn't scale well and unfortunately wrapping each and every object in Gecko is unreasonable. It is conceivable that someone might someday make a Glib-connect XPTCall layer or something like it that could proxy between XPCOM (or its replacement) and Glib. The main advantage of doing this is that no person would have to manually spend time writing bloaty wrappers for each and every imaginable Gecko object.
Line 8: Line 9:


GtkMozEmbed hasn't really had much development in the past years, partly because of a Glib ABI promise (which we intend to break for Mozilla1.9, as the Linux distributors have explained very clearly that they really really really don't care about ABIs at all, as long as there's source compatibility, because as it happens, they rebuild everything for each distribution they make anyway).
GtkMozEmbed hasn't really had much development in the past years, partly because of a Glib ABI promise (which we intend to break for Mozilla1.9, as the Linux distributors have explained very clearly that they really really really don't care about ABIs at all, as long as there's source compatibility, because as it happens, they rebuild everything for each distribution they make anyway).
See also mailing list: [http://www.mail-archive.com/dev-embedding@lists.mozilla.org/msg00838.html GtkMozEmbed for 1.9]


== Goals ==
== Goals ==
Line 22: Line 25:
== Source code ==
== Source code ==


All the ongoing changes on GtkMozEmbed are made inside separate branches prefixed with "MICROB".
All the ongoing changes on GtkMozEmbed are made inside separate branches prefixed with "MICROB". As soon as they are considered stable they suppose to be merged to HEAD. Some of the development "MICROB" branches were merged to HEAD already.
 
As soon as they are considered stable they suppose to be merged to HEAD.
 
The first version of the changed GtkMozEmbed was merged to HEAD already.


The latest development branch that is going to be merged to HEAD next is  
The latest development branch that is going to be merged to HEAD next is  
[http://bonsai.mozilla.org/cvsquery.cgi?treeid=default&module=all&branch=MICROB_20061206_BRANCH&branchtype=match&dir=&file=&filetype=match&who=&whotype=match&sortby=Date&hours=2&date=all&mindate=1970-12-31+16%3A00%3A01&maxdate=1970-12-31+16%3A00%3A01&cvsroot=%2Fcvsroot MICROB_20061206_BRANCH]
[http://bonsai.mozilla.org/cvsquery.cgi?treeid=default&module=all&branch=MICROB_20070323_BRANCH&branchtype=match&dir=&file=&filetype=match&who=&whotype=match&sortby=Date&hours=2&date=all&mindate=1970-12-31+16%3A00%3A01&maxdate=1970-12-31+16%3A00%3A01&cvsroot=%2Fcvsroot MICROB_20070323_BRANCH]


There is a query for all the branches made for new GtkMozEmbed:
There is a query for all the branches made for new GtkMozEmbed: [http://bonsai.mozilla.org/cvsquery.cgi?treeid=default&module=all&branch=MICROB*&branchtype=regexp&dir=&file=&filetype=match&who=&whotype=match&sortby=Date&hours=2&date=all&mindate=1970-12-31+16%3A00%3A01&maxdate=1970-12-31+16%3A00%3A01&cvsroot=%2Fcvsroot MICROB]
 
[http://bonsai.mozilla.org/cvsquery.cgi?treeid=default&module=all&branch=MICROB*&branchtype=regexp&dir=&file=&filetype=match&who=&whotype=match&sortby=Date&hours=2&date=all&mindate=1970-12-31+16%3A00%3A01&maxdate=1970-12-31+16%3A00%3A01&cvsroot=%2Fcvsroot MICROB]


== Components ==
== Components ==
Line 46: Line 43:
| gtkmozembedmarshal.list || yes || Added glib marshal descriptions for new signals
| gtkmozembedmarshal.list || yes || Added glib marshal descriptions for new signals
|-  
|-  
| gtkmozembed_download.h gtkmozembed_download.cpp || yes || Download Object, related to one file transfer request
| gtkmozembed_download.h <br> gtkmozembed_download.cpp || yes || Download Object, related to one file transfer request
|-
| gtkmozembed_common.h <br> gtkmozembed_common.cpp || yes || Common GObject with interface for Windowless components.
|-
| EmbedPasswordMgr.h <br> EmbedPasswordMgr.cpp || yes || Embedded Password Manager support
|-
| EmbedGtkTools.h <br> EmbedGtkTools.cpp || yes || Misc Embedded functions
|-
| EmbedGlobalHistory.h <br> EmbedGlobalHistory.cpp || yes || Embedded Global History support
|-
| EmbedFilePicker.h <br> EmbedFilePicker.cpp || yes || Embedded File Picker interface
|-  
|-  
| gtkmozembed_common.h gtkmozembed_common.cpp || yes || Common GObject with interface for Windowless components.
| EmbedDownloadMgr.h <br> EmbedDownloadMgr.cpp || yes || Embedded Download Manager
|-  
|-  
| EmbedPasswordMgr.h EmbedPasswordMgr.cpp || yes || Embedded Password Manager support
| EmbedContextMenuInfo.h <br> EmbedContextMenuInfo.cpp || yes || Embedded Context Menu support
|-  
|-  
| EmbedGtkTools.h EmbedGtkTools.cpp || yes || Misc Embedded functions
| EmbedCertificates.h <br> EmbedCertificates.cpp || yes || Embedded Certificates Listener
|}
 
== Progress ==
 
The branches made for the new GtkMozEmbed:
 
{| border="1"
!style="background:#efefef;" | Branch Name
!style="background:#efefef;" | Description
!style="background:#efefef;" | Date branched
!style="background:#efefef;" | Status
|-  
|-  
| EmbedGlobalHistory.h EmbedGlobalHistory.cpp || yes || Embedded Global History support
| MICROB_20070323_BRANCH || N/A || 2007.03.23 || Current development
|-  
|-  
| EmbedFilePicker.h EmbedFilePicker.cpp || yes || Embedded File Picker interface
| MICROB_20070103_BRANCH || Major update || 2007.01.03 || Merged to trunk on 2007.03.23
|-  
|-  
| EmbedDownloadMgr.h EmbedDownloadMgr.cpp || yes || Embedded Download Manager
| MICROB_20061206_BRANCH || Global history support, bug fixes || 2006.12.06 || Merged to trunk on 2007.01.02
|-  
|-  
| EmbedContextMenuInfo.h EmbedContextMenuInfo.cpp || yes || Embedded Context Menu support
| MICROB_20061204_BRANCH || Bug fixes || 2006.12.04 || Moved to MICROB_20061206_BRANCH
|-  
|-  
| EmbedCertificates.h EmbedCertificates.cpp || yes || Embedded Certificates Listener
| MICROB_20061031_BRANCH || Initial version || 2006.10.31 || Merged to trunk on 2006.12.03
|}
|}


== Plans ==
== Plans ==
Sometime this month, the current changes on the MICROB_20061031_BRANCH will be landed on trunk and a new branch will be created for additional work. This pattern should be repeated a number of times during the 1.9 timeline.
Sometime this month, the current changes on the MICROB_20070323_BRANCH will be landed on trunk and a new branch will be created for additional work. This pattern should be repeated a number of times during the 1.9 timeline.
41

edits