GeckoPort version2: what changed
Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | + | ### About | |
| 2 | + | ||
| 3 | + | GeckoPort is a Lazarus/Free Pascal version of Takanori Ito's Gecko SDK for Delphi, including the TGeckoBrowser component. Version 2 is based on automatically generated include-files from the idl files from the Gecko SDK. For this purpose the idltopas utility is used. This way it's earier to follow the fast Gecko-release cycle now gecko-developers do not maintain backwards compatibility anymore. You can find more information about the old version of GeckoPort [[GeckoPort|here]]. | |
| 4 | + | ||
| 5 | + | Current sources are based on Gecko 9, as Gecko 10 has a bug preventing it from being embedded. | |
| 6 | + | ||
| 7 | + | ### Screenshots | |
| 8 | + | ||
| 9 | + | <img src="GeckoPort_GBrowser_Win32.jpg" title="GBrowser sample app using the Win32 widgetset" width="600" /> | |
| 10 | + | ||
| 1 | 11 | ### License | |
| 2 | 12 | ||
| 3 | - | ||
| 13 | + | MPL 1.1 | |
| 4 | 14 | ||
| 5 | 15 | ### Installation | |
| 6 | 16 | ||
| 7 | - | ||
| 17 | + | There is a fpmake-package for GeckoPort in the Free Pascal repository. To install the geckoport fpmake-package on your system: | |
| 8 | 18 | ||
| 9 | - | ||
| 10 | - | ||
| 19 | + | - Make sure that you have [[fppkg]] correctly configured. Also look if the [[fppkg|path of your Lazarus installation]] is correctly set. | |
| 20 | + | - Install the fpmake gecko-package for Free Pascal. Give the following command on the command line: | |
| 11 | 21 | ||
| 12 | - | ||
| 22 | + | ``` bash | |
| 13 | 23 | fppkg install gecko | |
| 14 | 24 | ``` | |
| 15 | 25 | ||
| 16 | - | ||
| 17 | - | ||
| 18 | - | ||
| 19 | - | ||
| 26 | + | - When the installation is complete (re)start Lazarus | |
| 27 | + | - In Lazarus, choose Package \| Install/Uninstall Packages | |
| 28 | + | - Select GeckoComponents in the list of 'Do not install' packages and click on 'Install selection'. | |
| 29 | + | - Click 'Save and rebuild IDE' to rebuild and relaunch Lazarus. | |
| 20 | 30 | ||
| 21 | - | ||
| 31 | + | To compile a sample app: | |
| 22 | 32 | ||
| 23 | - | ||
| 24 | - | ||
| 33 | + | - Choose File \| Open, then select ChromeWin.lpi or GBrowser.lpi (both in the SampleApps subfolder). | |
| 34 | + | - Choose Run \| Run to compile and run the sample app. | |
| 25 | 35 | ||
| 26 | - | ||
| 27 | - | ||
| 28 | - | ||
| 29 | - | ||
| 36 | + | 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: | |
| 30 | 37 | ||
| 38 | + | ` `[`https://developer.mozilla.org/en/XULRunner`](https://developer.mozilla.org/en/XULRunner) | |
| 39 | + | ||
| 31 | 40 | ### Development | |
| 32 | 41 | ||
| 33 | - | ||
| 34 | - | ||
| 42 | + | You can download the sources from the GeckoPort from the Lazarus-ccr using Subversion: | |
| 43 | + | ||
| 44 | + | ``` bash | |
| 35 | 45 | svn co https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/components/geckoport/version2 [local dir] | |
| 36 | 46 | ``` | |
| 37 | 47 | ||
| 38 | - | ||
| 39 | - | ||
| 48 | + | To install this version, go to the (local) source-directory and use | |
| 49 | + | ||
| 50 | + | ``` bash | |
| 40 | 51 | fppkg install -o -gl | |
| 41 | 52 | ``` | |
| 42 | 53 | ||
| 43 | - | ||
| 54 | + | The '-o -gl' parameters are to include debug-info. | |
| 44 | 55 | ||
| 45 | 56 | ### To Do | |
| 46 | 57 | ||
| 47 | 58 | #### Win32 widgetset | |
| 48 | 59 | ||
| 49 | - | ||
| 60 | + | The ChromeWin and GBrowser sample apps work the same as they do with Delphi. | |
| 50 | 61 | ||
| 51 | - | ||
| 62 | + | Currently the code looks for a xulrunner in the following order: | |
| 52 | 63 | ||
| 53 | - | ||
| 54 | - | ||
| 55 | - | ||
| 56 | - | ||
| 57 | - | ||
| 64 | + | - The ParamStr(1). This means the first parameter in command line. This is **temporary** for testing purposes only and it will be removed soon. | |
| 65 | + | - The application is located in the same folder as the xulrunner. | |
| 66 | + | - The xulrunner is located in a folder under application executable. Folder must be named "xulrunner". | |
| 67 | + | - Scan registry looking for a GRE "*Gecko Runtime Environment*". | |
| 68 | + | - Scan registry looking for a Firefox installation. | |
| 58 | 69 | ||
| 59 | - | ||
| 60 | - | ||
| 70 | + | 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: | |
| 71 | + | ||
| 72 | + | ``` pascal | |
| 61 | 73 | SetExceptionMask([exInvalidOp, exDenormalized, exZeroDivide, exOverflow, exUnderflow, exPrecision]); | |
| 62 | 74 | ``` | |
| 63 | 75 | ||
| 64 | - | ||
| 76 | + | 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. | |
| 65 | 77 | ||
| 66 | - | ||
| 78 | + | 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. | |
| 67 | 79 | ||
| 68 | 80 | #### Carbon widgetset | |
| 69 | 81 | ||
| 70 | - | ||
| 82 | + | 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. | |
| 71 | 83 | ||
| 72 | 84 | #### Cocoa widgetset | |
| 73 | 85 | ||
| 74 | - | ||
| 86 | + | 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. | |
| 75 | 87 | ||
| 76 | - | ||
| 88 | + | 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, version 2.6 or higher, or compiled from FPC SVN trunk). | |
| 77 | 89 | ||
| 78 | - | ||
| 90 | + | 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. | |
| 79 | 91 | ||
| 80 | - | ||
| 92 | + | 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. | |
| 81 | 93 | ||
| 82 | - | ||
| 94 | + | The GBrowser sample app will crash because of the current incomplete state of the Cocoa widgetset. | |
| 83 | 95 | ||
| 84 | 96 | #### GTK2 widgetset | |
| 85 | 97 | ||
| 86 | - | ||
| 87 | - | ||
| 98 | + | 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: | |
| 99 | + | ||
| 100 | + | ``` bash | |
| 88 | 101 | export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/xulrunner-1.9.1.4 | |
| 89 | 102 | ``` | |
| 90 | 103 | ||
| 91 | - | ||
| 104 | + | The Gecko detect code in Linux gets the LD_LIBRARY_PATH environment variable and looks for a suitable XULRunner which path is in it. | |
| 92 | 105 | ||
| 93 | - | ||
| 106 | + | 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. | |
| 94 | 107 | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 108 | + | Please report testing success or failure to the GeckoPort maintainer: | |
| 100 | 109 | ||
| 110 | + | ` "José Mejuto" joshyfun (at) gmail (dot) com (`*`Current maintainer`*`)`\ | |
| 111 | + | ` MacPgmr (at) fastermac (dot) net (`*`Original maintainer`*`)` | |
| 112 | + | ||
| 101 | 113 | ## See also | |
| 102 | 114 | ||
| 103 | - | ||
| 115 | + | - [[GeckoPort]] | |
| 104 | 116 | ||
| 105 | 117 | --- | |
| 106 | - | ||
| 118 | + | *From the Free Pascal wiki, page "GeckoPort version2", 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).* | |
| 119 | + | Category: Components | |
| 120 | + | Category: Lazarus-CCR |