| 1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| 2 |
<html> |
| 3 |
<head> |
| 4 |
<meta content="text/html; charset=ISO-8859-1" |
| 5 |
http-equiv="content-type"> |
| 6 |
<title>Windows Build Instructions</title> |
| 7 |
<link rel="shortcut icon" href="http://download.linuxsampler.org/favicon.ico" type="image/x-icon"> |
| 8 |
<link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all"> |
| 9 |
</head> |
| 10 |
<body> |
| 11 |
<h2 align="center">Windows Build Instructions <img src="gfx/logos/msys.png" alt="msys logo"> HOWTO by Andreas Persson</h2> |
| 12 |
<br> |
| 13 |
<center>December 28th, 2008</center><br> |
| 14 |
<div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;"> |
| 15 |
<a href="#intro">1. Introduction</a><br> |
| 16 |
<a href="#mingw">2. MinGW</a><br> |
| 17 |
<a href="#pkg">3. pkg-config and gtkmm</a><br> |
| 18 |
<a href="#msys">4. MSYS</a><br> |
| 19 |
<a href="#asio">5. ASIO SDK</a><br> |
| 20 |
<a href="#vst">6. VST SDK</a><br> |
| 21 |
<a href="#intl">7. intltool</a><br> |
| 22 |
<a href="#perl">8. Perl</a><br> |
| 23 |
<a href="#xslt">9. xsltproc</a><br> |
| 24 |
<a href="#setup">10. MSYS setup</a><br> |
| 25 |
<a href="#sndfile">11. Building libsndfile</a><br> |
| 26 |
<a href="#gig">12. Building libgig</a><br> |
| 27 |
<a href="#ls">13. Building linuxsampler</a><br> |
| 28 |
<a href="#gigedit">14. Building gigedit</a><br> |
| 29 |
</div> |
| 30 |
|
| 31 |
|
| 32 |
<h3><a name="intro">1. Introduction</a></h3> |
| 33 |
|
| 34 |
<p>These are instructions for building libgig, linuxsampler and |
| 35 |
gigedit on Windows (32 bit) with help of MinGW and MSYS. After the |
| 36 |
MinGW and MSYS environment and the other prerequisites are installed, |
| 37 |
the build procedure will be the same as in Linux, that is, basically: |
| 38 |
./configure ; make ; make install.</p> |
| 39 |
|
| 40 |
<p>The versions of the files to download are just the ones I used |
| 41 |
before writing this text. You can probably use later ones if |
| 42 |
available.</p> |
| 43 |
|
| 44 |
<p>Some of the instructions below are marked with ** and ***:</p> |
| 45 |
|
| 46 |
<p>** = only needed if you are going to build from CVS, not if you are |
| 47 |
using the tar file releases</p> |
| 48 |
|
| 49 |
<p>*** = only needed if you are going to build gigedit</p> |
| 50 |
|
| 51 |
|
| 52 |
<h3><a name="mingw">2. MinGW</a></h3> |
| 53 |
|
| 54 |
<p>Download the MinGW installer, MinGW-5.1.4.exe, |
| 55 |
from <a href="http://www.mingw.org">www.mingw.org</a> and run it. The |
| 56 |
installer will automatically download and install further |
| 57 |
packages. Choose the base tools and the g++ compiler.</p> |
| 58 |
|
| 59 |
|
| 60 |
<h3><a name="pkg">3. pkg-config and gtkmm</a></h3> |
| 61 |
|
| 62 |
<p>The pkg-config tool is needed by the configure script in all the |
| 63 |
LinuxSampler packages. pkg-config is included in gtkmm, which is |
| 64 |
needed by gigedit. (If you are not going to build gigedit, you can |
| 65 |
download just GLib and pkg-config |
| 66 |
from <a href="http://www.gtk.org">www.gtk.org</a>.)</p> |
| 67 |
|
| 68 |
<p>Download the gtkmm windows installer, |
| 69 |
gtkmm-win32-devel-2.14.3-2.exe, |
| 70 |
from <a href="http://www.gtkmm.org">www.gtkmm.org</a>, and run it. Let |
| 71 |
the installer adjust the PATH variable as it wants.</p> |
| 72 |
|
| 73 |
|
| 74 |
<h3><a name="msys">4. MSYS</a></h3> |
| 75 |
|
| 76 |
<p>I use the 1.0.11 Technology Preview version, as I had problems |
| 77 |
building DLLs with the 1.0.10 current version.</p> |
| 78 |
|
| 79 |
<p>Download from "MSYS Base System, Technology Preview: MSYS-1.0.11":</p> |
| 80 |
|
| 81 |
<pre>msysCORE-1.0.11-20080826.tar.gz</pre> |
| 82 |
|
| 83 |
<p>Unpack the file to a directory of your choice, for example C:\msys. As |
| 84 |
1.0.11 doesn't have an installer yet, you need to have an unpacker |
| 85 |
that supports tar.gz/tar.bz, for example 7-Zip. The rest of the files |
| 86 |
you can unpack with the tar included in msysCORE.</p> |
| 87 |
|
| 88 |
<p>Run the postinstall\pi.bat file and specify your MinGW |
| 89 |
directory.</p> |
| 90 |
|
| 91 |
<p>Download from "MSYS Supplementary Tools, Technology Preview: Tools for |
| 92 |
MSYS-1.0.11":</p> |
| 93 |
|
| 94 |
<pre>autoconf2.5-2.61-1-bin.tar.bz2 ** |
| 95 |
autoconf-4-1-bin.tar.bz2 ** |
| 96 |
automake1.10-1.10-1-bin.tar.bz2 ** |
| 97 |
automake-3-1-bin.tar.bz2 ** |
| 98 |
bison-2.3-MSYS-1.0.11-1.tar.bz2 ** |
| 99 |
crypt-1.1-1-MSYS-1.0.11-1.tar.bz2 ** |
| 100 |
cvs-1.11.22-MSYS-1.0.11-1-bin.tar.gz ** |
| 101 |
gettext-0.16.1-1-bin.tar.bz2 *** |
| 102 |
gettext-0.16.1-1-dll.tar.bz2 *** |
| 103 |
libiconv-1.11-1-bin.tar.bz2 *** |
| 104 |
libiconv-1.11-1-dll.tar.bz2 *** |
| 105 |
libtool1.5-1.5.25a-1-bin.tar.bz2 |
| 106 |
perl-5.6.1-MSYS-1.0.11-1.tar.bz2 ***</pre> |
| 107 |
|
| 108 |
<p>Extract all these files to the msys directory, by starting msys, do |
| 109 |
"cd /" followed by "tar xjf <i>filename</i>" for .tar.bz2 files and |
| 110 |
"tar xzf <i>filename</i>" for .tar.gz files.</p> |
| 111 |
|
| 112 |
|
| 113 |
<h3><a name="asio">5. ASIO SDK</a></h3> |
| 114 |
|
| 115 |
<p>Download asiosdk2.2.zip from Steinberg. Extract it to your msys |
| 116 |
$HOME.</p> |
| 117 |
|
| 118 |
|
| 119 |
<h3><a name="vst">6. VST SDK</a></h3> |
| 120 |
|
| 121 |
<p>If you want to build the LinuxSampler VST plugin, download |
| 122 |
vst_sdk2_4_rev2.zip from Steinberg (note that you should not choose |
| 123 |
version 3). Extract it to msys $HOME.</p> |
| 124 |
|
| 125 |
|
| 126 |
<h3><a name="intl">7. intltool ***</a></h3> |
| 127 |
|
| 128 |
<p>Download intltool_0.40.4-1_win32.zip from |
| 129 |
<a href="http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool">http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool</a></p> |
| 130 |
|
| 131 |
<p>Unzip this into the msys local directory, (C:\msys\local for |
| 132 |
example)</p> |
| 133 |
|
| 134 |
|
| 135 |
<h3><a name="perl">8. Perl ***</a></h3> |
| 136 |
|
| 137 |
<p>The perl in MSYS is lacking an XML parser which is needed by |
| 138 |
intltool. Download ActivePerl |
| 139 |
from <a href="http://www.activestate.com">www.activestate.com</a> and |
| 140 |
install it.</p> |
| 141 |
|
| 142 |
|
| 143 |
<h3><a name="xslt">9. xsltproc ***</a></h3> |
| 144 |
|
| 145 |
<p>The gigedit Makefile wants to build the gigedit quick start |
| 146 |
documentation, so it needs the xsltproc command. Download from |
| 147 |
<a href="ftp://ftp.zlatkovic.com/pub/libxml/">ftp://ftp.zlatkovic.com/pub/libxml/</a>:</p> |
| 148 |
|
| 149 |
<pre>libxml2-2.7.2+.win32.zip |
| 150 |
libxslt-1.1.24.win32.zip</pre> |
| 151 |
|
| 152 |
<p>Copy the contents of the bin directories from both zip files to a |
| 153 |
directory of your choice. Add this directory last in your msys PATH, |
| 154 |
for example:</p> |
| 155 |
|
| 156 |
<pre>export PATH=$PATH:$HOME/xsltproc</pre> |
| 157 |
|
| 158 |
|
| 159 |
<h3><a name="setup">10. MSYS setup</a></h3> |
| 160 |
|
| 161 |
<p>Add the gtkmm aclocal directory to the list of extra directories |
| 162 |
used by autoconf. (Make sure the gtkmm path is the one where you |
| 163 |
installed it. The space in "Program Files" causes problems, so the |
| 164 |
short file name form is used here):</p> |
| 165 |
|
| 166 |
<pre>echo "/c/Progra~1/gtkmm/share/aclocal" >> /usr/local/share/aclocal/dirlist</pre> |
| 167 |
|
| 168 |
<p>Add the gtkmm bin directory first in your PATH (the installer has |
| 169 |
already added gtkmm to the PATH, but it may have used "Program Files" |
| 170 |
with a space in it, which causes configure to fail):</p> |
| 171 |
|
| 172 |
<pre>export PATH=/c/Progra~1/gtkmm/bin:$PATH</pre> |
| 173 |
|
| 174 |
<p>Make sure pkg-config will find the LinuxSampler libraries:</p> |
| 175 |
|
| 176 |
<pre>export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig</pre> |
| 177 |
|
| 178 |
|
| 179 |
<p>*** The intltool scripts expect perl to be in /opt/perl/bin, so |
| 180 |
make a link to the ActivePerl installation. Also add ActivePerl to |
| 181 |
PATH:</p> |
| 182 |
|
| 183 |
<pre>mkdir -p /opt/perl/bin |
| 184 |
ln -s /c/Perl/bin/perl.exe /opt/perl/bin |
| 185 |
export PATH=/c/Perl/bin:$PATH</pre> |
| 186 |
|
| 187 |
|
| 188 |
<p>*** MSYS gettext and gtkmm both include libintl. We want the gtkmm |
| 189 |
version. Remove the MSYS files so the gettext configure tools don't |
| 190 |
choose the wrong version:</p> |
| 191 |
|
| 192 |
<pre>rm /usr/local/include/libintl.h /usr/local/lib/libintl*</pre> |
| 193 |
|
| 194 |
|
| 195 |
<p>*** The gettext configure tools also need:</p> |
| 196 |
|
| 197 |
<pre>export CPPFLAGS="-I/c/Progra~1/gtkmm/include" |
| 198 |
export LDFLAGS="-L/c/Progra~1/gtkmm/lib"</pre> |
| 199 |
|
| 200 |
|
| 201 |
<h3><a name="sndfile">11. Building libsndfile</a></h3> |
| 202 |
|
| 203 |
<p>The windows precompiled version of libsndfile doesn't include the |
| 204 |
neccessary pkg-config file, so it's best to build libsndfile |
| 205 |
yourself. Download libsndfile-1.0.17.tar.gz |
| 206 |
from <a href="http://www.mega-nerd.com/libsndfile/">www.mega-nerd.com</a> and |
| 207 |
extract it to your $HOME:</p> |
| 208 |
|
| 209 |
<pre>cd |
| 210 |
tar xzf libsndfile-1.0.17.tar.gz</pre> |
| 211 |
|
| 212 |
<p>To prevent a compilation error for the test cases, add</p> |
| 213 |
|
| 214 |
<pre>#include <stdint.h></pre> |
| 215 |
|
| 216 |
<p>to tests/utils.h.</p> |
| 217 |
|
| 218 |
<pre>./configure |
| 219 |
make |
| 220 |
make install</pre> |
| 221 |
|
| 222 |
|
| 223 |
<h3><a name="gig">12. Building libgig</a></h3> |
| 224 |
|
| 225 |
<p>Just use the same commands as you would in linux:</p> |
| 226 |
|
| 227 |
<pre>make -f Makefile.cvs (if you build from CVS) |
| 228 |
./configure (add any configuration parameters as you wish) |
| 229 |
make |
| 230 |
make install</pre> |
| 231 |
|
| 232 |
|
| 233 |
<h3><a name="ls">13. Building linuxsampler</a></h3> |
| 234 |
|
| 235 |
<pre>make -f Makefile.cvs (if you build from CVS) |
| 236 |
./configure --enable-asiosdk-dir=$HOME --enable-vstsdk-dir=$HOME/vstsdk2.4 |
| 237 |
make |
| 238 |
make install</pre> |
| 239 |
|
| 240 |
|
| 241 |
<h3><a name="gigedit">14. Building gigedit</a></h3> |
| 242 |
|
| 243 |
<pre>make -f Makefile.cvs (if you build from CVS) |
| 244 |
./configure |
| 245 |
make |
| 246 |
make install</pre> |
| 247 |
</body> |
| 248 |
</html> |
Parent Directory
| 
Revision Log