Difference between revisions of "Gecko"

From WineHQ Wiki
Jump to: navigation, search
(update current version)
(Wine Gecko 2.47 release.)
(10 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
===Installing===
 
===Installing===
When your application tries to display a site, current Wine loads its custom implementation from the files wine_gecko-2.44-x86.msi and (on 64 bit systems) wine_gecko-2.44-x86_64.msi (older versions of Wine use older versions of wine-gecko).
+
When your application tries to display a site, current Wine loads its custom implementation of Gecko from .msi files. Wine will try to install Gecko when a wineprefix is created. If the file can't be found on your computer, Wine will download it for you. If the download fails, you can download the appropriate version (see table below) yourself from http://dl.winehq.org/wine/wine-gecko/.
 +
*For 64 bit (WoW64) Wine, both the x86 and x86_64 .msi files are required.
 +
*In most cases, the file(s) should be placed in /usr/share/wine/gecko.
 +
*If you installed Wine in some $prefix rather than /usr, place the .msi files in $prefix/share/wine/gecko/ instead of /usr/share/wine/gecko. (e.g. if you installed it from source, then place the files in /usr/local/share/wine/gecko).
  
Wine looks for this file first in /usr/share/wine/gecko/ (good distributions of Wine put that file there). Wine will try to install Gecko when a prefix is created. If the file can't be found on your computer, Wine will download it for you. If your distribution of Wine doesn't put the .msi (or .cab for older Wine versions) file in the right place for you, you can avoid downloading Gecko every time you create a wineprefix by putting it there yourself with the commands:
 
 
<pre>
 
$ wget http://dl.winehq.org/wine/wine-gecko/2.40//wine_gecko-2.44-x86.msi
 
$ wget http://dl.winehq.org/wine/wine-gecko/2.40//wine_gecko-2.44-x86_64.msi
 
$ sudo mkdir -p /usr/share/wine/gecko
 
$ sudo mv wine_gecko-2.44-x86.msi /usr/share/wine/gecko/
 
$ sudo mv wine_gecko-2.44-x86_64.msi /usr/share/wine/gecko/
 
</pre>
 
The above commands are for a 64 bit system using wine-1.9.3 or later. On a 32 bit system, only wine_gecko-2.44-x86.msi needs to be installed.
 
 
Older versions of Wine use other Gecko versions:
 
 
{|class="wikitable"
 
{|class="wikitable"
 
|-
 
|-
Line 58: Line 49:
 
||wine-1.7.38 - wine-1.7.49 || || wine_gecko-2.36-x86.msi || || wine_gecko-2.36-x86_64.msi  
 
||wine-1.7.38 - wine-1.7.49 || || wine_gecko-2.36-x86.msi || || wine_gecko-2.36-x86_64.msi  
 
|-
 
|-
||wine-1.7.50 - wine-1.9.2 || || wine_gecko-2.40-x86.msi || || wine_gecko-2.40-x86_64.msi  
+
||wine-1.7.50 - wine-1.9.2 || || [http://dl.winehq.org/wine/wine-gecko/2.40/wine_gecko-2.40-x86.msi wine_gecko-2.40-x86.msi] || || [http://dl.winehq.org/wine/wine-gecko/2.40/wine_gecko-2.40-x86_64.msi wine_gecko-2.40-x86_64.msi]
 
|-
 
|-
||wine-1.9.3 - current || || wine_gecko-2.44-x86.msi || || wine_gecko-2.44-x86_64.msi
+
||wine-1.9.3 - wine-1.9.12 || || [http://dl.winehq.org/wine/wine-gecko/2.44/wine_gecko-2.44-x86.msi wine_gecko-2.44-x86.msi] || || [http://dl.winehq.org/wine/wine-gecko/2.44/wine_gecko-2.44-x86_64.msi wine_gecko-2.44-x86_64.msi]
 +
|-
 +
||wine-1.9.13 - current || || [http://dl.winehq.org/wine/wine-gecko/2.47/wine_gecko-2.47-x86.msi wine_gecko-2.47-x86.msi] || || [http://dl.winehq.org/wine/wine-gecko/2.47/wine_gecko-2.47-x86_64.msi wine_gecko-2.47-x86_64.msi]
 
|}
 
|}
If you installed Wine in some $prefix rather than /usr, it will look in $prefix/share/wine/gecko/ instead of /usr/share/wine/gecko. e.g. if you installed it from source, then the default-path is /usr/local/share/wine/gecko.
 
  
 
=== Running Wine from source tree ===
 
=== Running Wine from source tree ===
Line 68: Line 60:
  
 
=== Debug info ===
 
=== Debug info ===
If Gecko is crashing on you, you can download a debug build to get more verbose logs.  Here's how:
+
If Gecko is crashing on you, you can download a debug build from http://dl.winehq.org/wine/wine-gecko/ to get more verbose logs.  Download the -unstripped.tar.bz2 file for the version you are using (on a 64 bit system, download both the x86 and x86_64 tarballs), unpack the files, and replace the files in <tt>$WINEPREFIX/drive_c/windows/system32/gecko/''version''</tt> and (on 64 bit) <tt>$WINEPREFIX/drive_c/windows/sysWoW64/gecko/''version''</tt> with the extracted files.
 +
 
 +
=== Building Wine Gecko ===
 +
 
 +
The following describe how the Wine Gecko package is built.
 +
 
 +
NOTE: If you're unsure if you want to build it yourself, the answer is no. There is no reason to build it yourself unless you're going to work on Mozilla code. If you need Gecko to run an app in Wine, follow the instructions above. Wine Gecko source is hosted in Git on [http://sourceforge.net/p/wine/wine-gecko/ci/master/tree/ Sourceforge].
 +
 
 +
Wine Gecko is maintained by Jacek Caban. If you need help, feel free to contact him.
 +
 
 +
==== Mingw-w64 ====
 +
It is [https://developer.mozilla.org/en-US/docs/Cross_Compile_Mozilla_for_Mingw32 encouraged] to use [http://mingw-w64.sourceforge.net mingw-w64] for cross-compiling.
 +
 
 +
===== Building Mingw-w64 =====
 +
The exact instruction about building the package of 2.34 version are hosted in [http://sourceforge.net/p/wine/wine-gecko/ci/master/tree/wine/README wine/README] in Wine Gecko source directory.
 +
 
 +
===== Binary Packages =====
 +
Some Distro are maintaining mingw-w64 in their repo, like [https://apps.fedoraproject.org/packages/mingw-headers Fedora]. You can install the dependencies with commands like
 +
<source lang="bash"># yum-builddep mingw32-wine-gecko</source>
 +
 
 +
==== Troubleshooting ====
 +
===== 'pthread_t' does not name a type =====
 +
Try to remove media/libstagefright/ports/win32/include/pthread.h
 +
===== mingw-w64 too old =====
 +
For example:
 +
 
 +
*[http://sourceforge.net/p/mingw-w64/mingw-w64/ci/7268caece9b4cb33ff698306e51140b11d7656b0/#diff-3 'ILocation' was not declared].
 +
*[http://sourceforge.net/p/mingw-w64/mingw-w64/ci/6c56d0b0eb5be9fbeb552ba070a2304b842a5102/ 'EXTERN_C' does not name a type]
  
<pre>
+
The mingw-w64 package on your distro may be too old to include this patch.[https://lists.fedoraproject.org/pipermail/mingw/2015-April/009047.html (for example, it will take some time to backport these patch to stable branches like v4.x)]
$ wget http://dl.winehq.org/wine/wine-gecko/2.44/wine_gecko-2.44-x86-unstripped.tar.bz2
+
If you faced this trouble, please consider compile mingw-w64 by yourself(as [http://sourceforge.net/p/wine/wine-gecko/ci/master/tree/wine/README README] said)
$ cd .wine/drive_c/windows/system32/gecko/2.44
+
$ mv wine_gecko wine_gecko.old
+
$ tar -jxf ~/wine_gecko-2.44-x86-unstripped.tar.bz2
+
</pre>
+
winetricks can install gecko-dbg, use 'winetricks gecko-dbg' to automate the above steps.
+
  
 
=== See also ===
 
=== See also ===
* MozillaIntegration
+
* [[iexplore]]
* ["iexplore"]
+
* BuildingWineGecko
+
 
* [http://source.winehq.org/git/wine.git/blob/HEAD:/dlls/appwiz.cpl/addons.c#l54 Gecko version needed by current Wine git]
 
* [http://source.winehq.org/git/wine.git/blob/HEAD:/dlls/appwiz.cpl/addons.c#l54 Gecko version needed by current Wine git]
  
 
[[Category:Networking]]
 
[[Category:Networking]]

Revision as of 09:08, 25 July 2016

Wine implements its own version of Internet Explorer. The implementation is based on a custom version of Mozilla's Gecko Layout Engine.

Installing

When your application tries to display a site, current Wine loads its custom implementation of Gecko from .msi files. Wine will try to install Gecko when a wineprefix is created. If the file can't be found on your computer, Wine will download it for you. If the download fails, you can download the appropriate version (see table below) yourself from http://dl.winehq.org/wine/wine-gecko/.

  • For 64 bit (WoW64) Wine, both the x86 and x86_64 .msi files are required.
  • In most cases, the file(s) should be placed in /usr/share/wine/gecko.
  • If you installed Wine in some $prefix rather than /usr, place the .msi files in $prefix/share/wine/gecko/ instead of /usr/share/wine/gecko. (e.g. if you installed it from source, then place the files in /usr/local/share/wine/gecko).
Wine Gecko (32 bit) Gecko (64 bit)
wine-0.9.47 - wine-1.1.11 wine_gecko-0.1.0.cab
wine-1.1.12 - wine-1.1.14 wine_gecko-0.9.0.cab
wine-1.1.15 - wine-1.1.26 wine_gecko-0.9.1.cab
wine-1.1.27 - wine-1.3.1 wine_gecko-1.0.0-x86.cab
wine-1.3.2 - wine-1.3.15 wine_gecko-1.1.0-x86.cab wine_gecko-1.1.0-x86_64.cab
wine-1.3.16 - wine-1.3.26 wine_gecko-1.2.0-x86.msi wine_gecko-1.2.0-x86_64.msi
wine-1.3.27 - wine-1.3.32 wine_gecko-1.3-x86.msi wine_gecko-1.3-x86_64.msi
wine-1.3.33 - wine-1.4 wine_gecko-1.4-x86.msi wine_gecko-1.4-x86_64.msi
wine-1.5.0 - wine-1.5.6 wine_gecko-1.5-x86.msi wine_gecko-1.5-x86_64.msi
wine-1.5.7 - wine-1.5.9 wine_gecko-1.6-x86.msi wine_gecko-1.6-x86_64.msi
wine-1.5.10 - wine-1.5.14 wine_gecko-1.7-x86.msi wine_gecko-1.7-x86_64.msi
wine-1.5.15 - wine-1.5.21 wine_gecko-1.8-x86.msi wine_gecko-1.8-x86_64.msi
wine-1.5.22 - wine-1.5.30 wine_gecko-1.9-x86.msi wine_gecko-1.9-x86_64.msi
wine-1.5.31 - wine-1.7.2 wine_gecko-2.21-x86.msi wine_gecko-2.21-x86_64.msi
wine-1.7.3 - wine-1.7.30 wine_gecko-2.24-x86.msi wine_gecko-2.24-x86_64.msi
wine-1.7.31 - wine-1.7.37 wine_gecko-2.34-x86.msi wine_gecko-2.34-x86_64.msi
wine-1.7.38 - wine-1.7.49 wine_gecko-2.36-x86.msi wine_gecko-2.36-x86_64.msi
wine-1.7.50 - wine-1.9.2 wine_gecko-2.40-x86.msi wine_gecko-2.40-x86_64.msi
wine-1.9.3 - wine-1.9.12 wine_gecko-2.44-x86.msi wine_gecko-2.44-x86_64.msi
wine-1.9.13 - current wine_gecko-2.47-x86.msi wine_gecko-2.47-x86_64.msi

Running Wine from source tree

If you are using Git or running Wine from source code, then Wine will try to find the .msi file by looking in ../gecko/ (relative to the build tree).

Debug info

If Gecko is crashing on you, you can download a debug build from http://dl.winehq.org/wine/wine-gecko/ to get more verbose logs. Download the -unstripped.tar.bz2 file for the version you are using (on a 64 bit system, download both the x86 and x86_64 tarballs), unpack the files, and replace the files in $WINEPREFIX/drive_c/windows/system32/gecko/version and (on 64 bit) $WINEPREFIX/drive_c/windows/sysWoW64/gecko/version with the extracted files.

Building Wine Gecko

The following describe how the Wine Gecko package is built.

NOTE: If you're unsure if you want to build it yourself, the answer is no. There is no reason to build it yourself unless you're going to work on Mozilla code. If you need Gecko to run an app in Wine, follow the instructions above. Wine Gecko source is hosted in Git on Sourceforge.

Wine Gecko is maintained by Jacek Caban. If you need help, feel free to contact him.

Mingw-w64

It is encouraged to use mingw-w64 for cross-compiling.

Building Mingw-w64

The exact instruction about building the package of 2.34 version are hosted in wine/README in Wine Gecko source directory.

Binary Packages

Some Distro are maintaining mingw-w64 in their repo, like Fedora. You can install the dependencies with commands like

# yum-builddep mingw32-wine-gecko

Troubleshooting

'pthread_t' does not name a type

Try to remove media/libstagefright/ports/win32/include/pthread.h

mingw-w64 too old

For example:

The mingw-w64 package on your distro may be too old to include this patch.(for example, it will take some time to backport these patch to stable branches like v4.x) If you faced this trouble, please consider compile mingw-w64 by yourself(as README said)

See also