GeckoPort: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		### New version available
2	2
3	3		This information is based on the older, version 1 of GeckoPort. For the latest version see [[GeckoPort version2\|here]].
4	4
5	5		### About
6	6
7	7		GeckoPort is a Lazarus/Free Pascal version of Takanori Ito's Gecko SDK for Delphi, including the TGeckoBrowser component. The original unported Delphi source is available from here:
8	8
9	9		` `[`http://d-gecko.svn.sourceforge.net/viewvc/d-gecko/`](http://d-gecko.svn.sourceforge.net/viewvc/d-gecko/)
10	10
11	11		### Screenshots
12	12
13		-	~~<figure>~~
14	13		<img src="GeckoPort_GBrowser_Win32.jpg" title="GBrowser sample app using the Win32 widgetset" width="600" />
15		-	~~<figcaption>GBrowser sample app using the Win32 widgetset</figcaption>~~
16		-	~~</figure>~~
17	14
18	15		### Download
19	16
20	17		You can download the ported source using Subversion:
21	18
22	19		``` bash
23	20		svn co https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/components/geckoport/version1 [local dir]
24	21		```
25	22
26	23		### License
27	24
28	25		MPL 1.1
29	26
30	27		### Installation
31	28
32	29		To install the GeckoComponents package in Lazarus:
33	30
34	31		- Choose Package \\| Open package file, then select GeckoComponents.lpk (in the Components subfolder).
35	32
36	33		- Click Compile to compile the package.
37	34
38	35		- Click Install to rebuild and relaunch Lazarus.
39	36
40	37		To compile a sample app:
41	38
42	39		- Choose File \\| Open, then select ChromeWin.lpi or GBrowser.lpi (both in the SampleApps subfolder).
43	40
44	41		- Choose Run \\| Run to compile and run the sample app.
45	42
46	43		Note that you'll need the Gecko libraries installed before you can run one of the sample apps. If necessary, use an installer from here:
47	44
48	45		` `[`https://developer.mozilla.org/en/XULRunner`](https://developer.mozilla.org/en/XULRunner)
49	46
50	47		### To Do
51	48
52	49		#### Win32 widgetset
53	50
54	51		The ChromeWin and GBrowser sample apps work the same as they do with Delphi.
55	52
56	53		Currently the code looks for a xulrunner in the following order:
57	54
58	55		- The ParamStr(1). This means the first parameter in command line. This is temporary for testing purposes only and it will be removed soon.
59	56		- The application is located in the same folder as the xulrunner.
60	57		- The xulrunner is located in a folder under application executable. Folder must be named "xulrunner".
61	58		- Scan registry looking for a GRE "Gecko Runtime Environment".
62	59		- Scan registry looking for a Firefox installation.
63	60
64		-	<s>Xulrunner working up to revision 1.9.1.11 Releases 1.9.2.x and up does not work currently.</s> XULRunner has been tested with 1.9.2.5 since calling mode in fpc 2.5.1 has been fixed and it works. XULRunner has been tested with 2.0.0.8pre and works but as there are some incompatibilities with 1.x.x.x branch in XULRunner the source code must be compiled using "-dXULRUNNER2".
	61	+	Xulrunner working up to revision 1.9.1.11 Releases 1.9.2.x and up does not work currently. XULRunner has been tested with 1.9.2.5 since calling mode in fpc 2.5.1 has been fixed and it works. XULRunner has been tested with 2.0.0.8pre and works but as there are some incompatibilities with 1.x.x.x branch in XULRunner the source code must be compiled using "-dXULRUNNER2".
65	62
66	63		With Free Pascal 2.4.x and 2.5.1 on Windows, you must disable floating point exceptions as soon as possible in your program. Add the Math unit to your uses clause and add the following statement at the beginning of your program:
67	64
68	65		``` pascal
69	66		SetExceptionMask([exInvalidOp, exDenormalized, exZeroDivide, exOverflow, exUnderflow, exPrecision]);
70	67		```
71	68
72	69		Note that this will disable floating point exceptions in all code, not just in the Gecko libraries. See the sample app .dpr files for examples of how to add this code.
73	70
74		-	<s>Firefox runner has not been tested as 3.6 does not work at all.</s> Firefox runner is now working, tested with Firefox 3.6.12 but the application exe MUST be in the same folder as Firefox or you will get a hangup now of them.
	71	+	Firefox runner has not been tested as 3.6 does not work at all. Firefox runner is now working, tested with Firefox 3.6.12 but the application exe MUST be in the same folder as Firefox or you will get a hangup now of them.
75	72
76	73		#### Carbon widgetset
77	74
78		-	~~<s>Carbon will not work due the lack of safecall calling convention in current fpc ( 2.5.1 ).</s>~~
	75	+	Carbon will not work due the lack of safecall calling convention in current fpc ( 2.5.1 ).
79	76
80	77		A native window must be passed in to initialize the browser component. On OS X, this must be a Cocoa window, otherwise the Carbon widgetset will not work.
81	78
82	79		#### Cocoa widgetset
83	80
84		-	~~<s>Cocoa will not work due the lack of safecall calling convention in current fpc ( 2.5.1 ).</s>~~
	81	+	Cocoa will not work due the lack of safecall calling convention in current fpc ( 2.5.1 ).
85	82
86	83		Although the Cocoa widgetset currently has support only for TForm and one or two other controls, the ChromeWin sample app can be run with the Cocoa widgetset since this app uses only TForm.
87	84
88	85		Note that the GeckoPort package now uses the new Objective Pascal-based Cocoa widgetset instead of the old PasCocoa-based widgetset. To compile the ObjC-based Cocoa widgetset, you will need a version of FPC that includes Objective Pascal support (for example, compiled from the FPC SVN trunk, which is currently version 2.5.1).
89	86
90	87		You will also need to set the app's widgetset to Cocoa, since the default is Carbon. Or you can compile ChromeWin.lpi with lazbuild and specify the --ws=cocoa switch. See the lb-cw-cocoa.sh script for an example.
91	88
92	89		To run the ChromeWin sample app, you need to set DYLD_LIBRARY_PATH so that the XUL library can load the other Gecko libraries it depends on. A simple way to do this is to start ChromeWin.app with the included run-cw-mac.sh script. Note that this script assumes that you have the XUL.framework installed.
93	90
94	91		The GBrowser sample app will crash because of the current incomplete state of the Cocoa widgetset.
95	92
96	93		#### GTK2 widgetset
97	94
98		-	~~<s>GTK2 on Linux/Unix will not work due the lack of safecall calling convention in current fpc ( 2.5.1 ).</s> Solved by Joost in fpc 2.5.1~~
	95	+	GTK2 on Linux/Unix will not work due the lack of safecall calling convention in current fpc ( 2.5.1 ). Solved by Joost in fpc 2.5.1
99	96
100	97		On Linux, be sure to set the LD_LIBRARY_PATH environment variable to the xulrunner directory before running one of the sample apps. For example:
101	98
102	99		``` bash
103	100		export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/xulrunner-1.9.1.4
104	101		```
105	102
106		-	~~<s>For now the code assumes that libxul.so is located in /usr/lib/xulrunner-1.9.1.4. You can edit the code to change this.</s>~~
	103	+	For now the code assumes that libxul.so is located in /usr/lib/xulrunner-1.9.1.4. You can edit the code to change this.
107	104
108	105		The Gecko detect code in Linux gets the LD_LIBRARY_PATH environment variable and looks for a suitable XULRunner which path is in it.
109	106
110		-	~~<s>Currently the sample apps do not work on Linux, failing in libmozjs.so within the call to libxul.so's XRE_InitEmbedding from nsXRE.pas.</s>~~
	107	+	Currently the sample apps do not work on Linux, failing in libmozjs.so within the call to libxul.so's XRE_InitEmbedding from nsXRE.pas.
111	108
112	109		Currently sample apps works in Linux/Ubuntu 9.04 using Lazarus 0.9.29 and fpc 2.5.1 with some paint problems that I think will be resolved soon and seems to be related to GTK2 interface.
113	110
114	111		Please report testing success or failure to the GeckoPort maintainer:
115	112
116	113		` "José Mejuto" joshyfun (at) gmail (dot) com (``Current maintainer``)`\
117	114		` MacPgmr (at) fastermac (dot) net (``Original maintainer``)`
118	115
119	116		## See also
120	117
121	118		- [[GeckoPort version2]]
122	119		- [A detailed Tutorial at LazPlanet](http://lazplanet.blogspot.com/2013/10/browser-in-lazarus-with-gecko-pt1.html)
123	120
124	121		---
125	122		From the Free Pascal wiki, page "GeckoPort", as it stood on 2020-02-16 after a change by GAN, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
126	123		Category: Components
127	124		Category: Lazarus-CCR

Back to history