mkvtoolnix/README.Windows.txt

103 lines
3.2 KiB
Plaintext
Raw Normal View History

Building mkvtoolnix 5.4.0 on Windows
====================================
2003-05-09 06:27:26 +00:00
There is currently only one supported way to build MKVToolNix for
Windows: on Linux using a mingw cross compiler. It is known that you
can also build it on Windows itself with the mingw gcc compiler, but
that's not supported officially as I don't have such a setup myself.
Earlier versions could still be built with Microsoft's Visual Studio /
Visual C++ programs, and those steps were described here as
well. However, current MKVToolNix versions require many features of
the new C++11 standard that even the newest C++ compilers from
Microsoft simply don't support. Therefore the old project files that
enabled building with Visual Studio 8 or newer were removed.
Section 1 -- Building with a mingw cross compiler
-------------------------------------------------
1.1. Preparations
2011-10-23 19:06:28 +00:00
You will need:
- a mingw cross compiler
- roughly 2 GB of free space available
2011-10-23 19:06:28 +00:00
Earlier versions of this document described in painful details how to
build each library. Luckily there's the "mingw-cross-env" project at
http://mingw-cross-env.nongnu.org/ that provides an easy-to-use way of
setting up everything we need.
2011-10-23 19:06:28 +00:00
First, download a release or the current development version; see
http://mingw-cross-env.nongnu.org/#latest-release to to retrieve
them. Then unpack the release.
2011-10-23 19:06:28 +00:00
The rest of this guide assumes that you've unpacked mingw-cross-env
into the directory $HOME/mingw-cross-env.
1.2. Automatic build script
mkvtoolnix contains a script that can download, compile and install
2011-10-23 19:06:28 +00:00
all required libraries into the directory $HOME/mingw-cross-env.
If the script does not work or you want to do everything yourself
you'll find instructions for manual compilation in section 2.3.
1.2.1. Script configuration
The script is called winbuild/setup_cross_compilation_env.sh. It
contains the following variables that can be adjusted to fit your
needs:
2011-10-23 19:06:28 +00:00
TARGET=i686-pc-mingw32
2011-10-23 19:06:28 +00:00
The target specification for the standard configure scripts.
2011-10-23 19:06:28 +00:00
INSTALL_DIR=$HOME/mingw-cross-env
Base installation directory
2011-10-23 19:06:28 +00:00
PARALLEL=
2011-10-23 19:06:28 +00:00
Number of processes to execute in parallel. Will be set to the number
of cores available if left empty.
1.2.2. Execution
From the mkvtoolnix source directory run:
./winbuild/setup_cross_compilation_env.sh
2010-03-07 17:56:35 +00:00
If everything works fine you'll end up with a configured mkvtoolnix
2011-10-23 19:06:28 +00:00
source tree. You just have to run 'drake' afterwards.
1.3. Manual installation
2011-10-23 19:06:28 +00:00
First you will need the mingw-cross-env build scripts. Get them by
downloading them (see above) and unpacking them into
$HOME/mingw-cross-env.
Next, build the required libraries:
cd $HOME/mingw-cross-env
make gcc w32api mingwrt gettext boost bzip2 curl file flac libiconv \
lzo ogg pthreads vorbis wxwidgets zlib
2011-10-23 19:06:28 +00:00
Append the installation directory to your PATH variable:
export PATH=$PATH:$HOME/mingw-cross-env/usr/i686-pc-mingw32/bin
Finally, configure mkvtoolnix:
cd $HOME/path/to/mkvtoolnix-source
./configure \
2011-10-23 19:06:28 +00:00
--host=i686-pc-mingw32 \
--with-boost=$HOME/mingw-cross-env/usr/i686-pc-mingw32 \
--with-wx-config=$HOME/mingw-cross-env/usr/i686-pc-mingw32/bin/i686-pc-mingw32-wx-config
If everything works then build it:
./drake
You're done.