212 lines
7.0 KiB
Plaintext
212 lines
7.0 KiB
Plaintext
--------------------------------------------------------------------------------
|
|
Build Instructions for Windows NetSurf 13 February 2010
|
|
--------------------------------------------------------------------------------
|
|
|
|
This document provides instructions for building the Windows version
|
|
of NetSurf and provides guidance on obtaining NetSurf's build
|
|
dependencies.
|
|
|
|
Windows NetSurf has been tested on Wine and Vista.
|
|
|
|
|
|
Building and executing NetSurf
|
|
================================
|
|
|
|
The windows netsurf port uses the MinGW (Minimal GNU on Windows)
|
|
system as its build infrastructure. This allows the normal netsurf
|
|
build process to be used.
|
|
|
|
The method outlined here to create executables cross compiles
|
|
windows executable from a Linux OS host.
|
|
|
|
First of all, you should examine the contents of Makefile.defaults
|
|
and enable and disable relevant features as you see fit by creating
|
|
a Makefile.config file. Some of these options can be automatically
|
|
detected and used, and where this is the case they are set to such.
|
|
Others cannot be automatically detected from the Makefile, so you
|
|
will either need to install the dependencies, or set them to NO.
|
|
|
|
You should then obtain NetSurf's dependencies, keeping in mind which
|
|
options you have enabled in the configuration file. See the next
|
|
section for specifics.
|
|
|
|
Once done, to build windows NetSurf on a UNIX-like platform, simply run:
|
|
|
|
$ export MINGW_PREFIX=i586-mingw32msvc-
|
|
$ export MINGW_INSTALL_ENV=/usr/i586-mingw32msvc/
|
|
$ make TARGET=windows
|
|
|
|
If that produces errors, you probably don't have some of NetSurf's
|
|
build dependencies installed. See "Obtaining NetSurf's dependencies"
|
|
below. Or turn off the complaining features in a Makefile.config
|
|
file. You may need to "make clean" before attempting to build after
|
|
installing the dependencies.
|
|
|
|
You will need the libgnurx-0.dll from /usr/i586-mingw32msvc/bin/
|
|
copied next to the exe and the windows/res directory available, also
|
|
next to the executable.
|
|
|
|
Run NetSurf by executing it:
|
|
|
|
$ wine NetSurf.exe
|
|
|
|
The staticaly linked binary which is generated may be several
|
|
megabytes in size, this can be reduced by stripping the binary.
|
|
|
|
$ i586-mingw32msvc-strip NetSurf.exe
|
|
|
|
|
|
Obtaining NetSurf's build dependencies
|
|
========================================
|
|
|
|
Package installation
|
|
----------------------
|
|
|
|
Debian-based OS:
|
|
|
|
The mingw cross compilation tools are required. These can be
|
|
installed as pakages on Debian/Ubuntu systems:
|
|
|
|
$ sudo apt-get install mingw32 mingw32-binutils mingw32-runtime
|
|
|
|
These provide a suitable set of compilers and headers including the win32 API.
|
|
|
|
The includes and associated libraries are installed in
|
|
/usr/i586-mingw32msvc/ Which is where the build system will include
|
|
files from by default. The packages at time of writing only target
|
|
32bit windows builds.
|
|
|
|
Other:
|
|
|
|
For other OS the apropriate packages and environment must be installed.
|
|
|
|
pkg-config
|
|
------------
|
|
|
|
A pkg-config wrapper script is required to make things easier
|
|
|
|
cat > /usr/i586-mingw32msvc/bin/pkg-config <<EOF
|
|
#!/bin/bash
|
|
export PKG_CONFIG_LIBDIR=/usr/i586-mingw32msvc/lib/pkgconfig
|
|
/usr/bin/pkg-config $*
|
|
EOF
|
|
|
|
|
|
Base libraries
|
|
----------------
|
|
|
|
Unlike other OS the base libraries and their dependancies need to be
|
|
built and installed.
|
|
|
|
The instructions given here assume you will be installing on a
|
|
Debian derived OS using the mingw32 packages. The libraries should
|
|
be unpacked and built from a suitable temporary directory.
|
|
|
|
zlib:
|
|
|
|
$ apt-get source zlib1g
|
|
$ cd zlib-1.2.3.3.dfsg
|
|
$ CC=i586-mingw32msvc-gcc AR=i586-mingw32msvc-ar RANLIB=i586-mingw32msvc-ranlib CFLAGS="-DNO_FSEEKO" ./configure --prefix=/usr/i586-mingw32msvc/
|
|
$ make
|
|
$ sudo make install
|
|
|
|
libiconv:
|
|
|
|
$ wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.1.tar.gz
|
|
$ tar -zxf libiconv-1.13.1.tar.gz
|
|
$ cd libiconv-1.13.1
|
|
$ ./configure --prefix=/usr/i586-mingw32msvc/ --host=i586-mingw32msvc --disable-shared
|
|
$ make
|
|
$ sudo make install
|
|
|
|
regex:
|
|
|
|
$ wget http://kent.dl.sourceforge.net/project/mingw/Other/UserContributed/regex/mingw-regex-2.5.1/mingw-libgnurx-2.5.1-src.tar.gz
|
|
$ tar -zxf mingw-libgnurx-2.5.1-src.tar.gz
|
|
$ cd mingw-libgnurx-2.5.1
|
|
$ ./configure --prefix=/usr/i586-mingw32msvc/ --host=i586-mingw32msvc
|
|
$ make
|
|
$ sudo make install
|
|
|
|
openssl:
|
|
|
|
$ wget http://www.openssl.org/source/openssl-1.0.0a.tar.gz
|
|
$ tar -zxf openssl-1.0.0a.tar.gz
|
|
$ cd openssl-1.0.0a
|
|
$ PATH=/usr/i586-mingw32msvc/bin/:$PATH ./Configure no-shared disable-capieng --prefix=/usr/i586-mingw32msvc/ mingw
|
|
$ PATH=/usr/i586-mingw32msvc/bin/:$PATH make CC=i586-mingw32msvc-gcc RANLIB=i586-mingw32msvc-ranlib
|
|
$ sudo make install
|
|
|
|
libxml:
|
|
|
|
$ apt-get source libxml2
|
|
$ cd libxml2-2.7.6.dfsg
|
|
$ ./configure --prefix=/usr/i586-mingw32msvc/ --disable-shared --without-python --host=i586-mingw32msvc
|
|
$ make
|
|
$ sudo make install
|
|
|
|
libcurl:
|
|
|
|
$ wget http://curl.haxx.se/download/curl-7.26.0.tar.gz
|
|
$ tar -zxf curl-7.26.0.tar.gz
|
|
$ cd curl-7.26.0
|
|
$ LDFLAGS=-mwindows ./configure --prefix=/usr/i586-mingw32msvc/ --host=i586-mingw32msvc --disable-shared --disable-ldap --without-random
|
|
$ make
|
|
$ sudo make install
|
|
|
|
libpng:
|
|
|
|
$ wget http://kent.dl.sourceforge.net/project/libpng/libpng14/1.4.12/libpng-1.4.12.tar.gz
|
|
$ tar -zxf libpng-1.4.12.tar.gz
|
|
$ cd libpng-1.4.12
|
|
$ ./configure --prefix=/usr/i586-mingw32msvc/ --host=i586-mingw32msvc
|
|
$ make
|
|
$ sudo make install
|
|
|
|
libjpeg:
|
|
|
|
$ wget http://www.ijg.org/files/jpegsrc.v8d.tar.gz
|
|
$ tar -zxf jpegsrc.v8d.tar.gz
|
|
$ cd jpeg-8d
|
|
$ ./configure --prefix=/usr/i586-mingw32msvc/ --host=i586-mingw32msvc --disable-shared
|
|
$ make
|
|
$ sudo make install
|
|
|
|
The NetSurf project's libraries
|
|
---------------------------------
|
|
|
|
The NetSurf project has developed several libraries which are required by
|
|
the browser. These are:
|
|
|
|
LibParserUtils -- Parser building utility functions
|
|
LibWapcaplet -- String internment
|
|
Hubbub -- HTML5 compliant HTML parser
|
|
LibCSS -- CSS parser and selection engine
|
|
LibNSGIF -- GIF format image decoder
|
|
LibNSBMP -- BMP and ICO format image decoder
|
|
LibROSprite -- RISC OS Sprite format image decoder
|
|
|
|
To fetch each of these libraries, run the appropriate commands from the
|
|
Docs/LIBRARIES file.
|
|
|
|
To build and install these libraries.
|
|
|
|
Ensure the MINGW_INSTALL_ENV variable is correctly set.
|
|
|
|
$ export MINGW_INSTALL_ENV=/usr/i586-mingw32msvc/
|
|
|
|
Then simply enter each of their directories and run:
|
|
|
|
$ make TARGET=windows PREFIX=/usr/i586-mingw32msvc/
|
|
$ sudo make TARGET=windows PREFIX=/usr/i586-mingw32msvc/ install
|
|
|
|
Resources
|
|
-----------
|
|
|
|
The windows resources may be rebuilt. Currently there is 1 object
|
|
file included in the Git distribution of NetSurf that could be
|
|
manually compiled
|
|
|
|
$ cd windows/res
|
|
$ i586-mingw32msvc-windres resource.rc -O coff -o resource.o
|