1 |
persson |
1807 |
<!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 14th, 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.</p> |
56 |
|
|
|
57 |
|
|
|
58 |
|
|
<h3><a name="pkg">3. pkg-config and gtkmm</a></h3> |
59 |
|
|
|
60 |
|
|
<p>The pkg-config tool is needed by the configure script in all the |
61 |
|
|
LinuxSampler packages. pkg-config is included in gtkmm, which is |
62 |
|
|
needed by gigedit. (If you are not going to build gigedit, you can |
63 |
|
|
download just GLib and pkg-config |
64 |
|
|
from <a href="http://www.gtk.org">www.gtk.org</a>.)</p> |
65 |
|
|
|
66 |
|
|
<p>Download the gtkmm windows installer, |
67 |
|
|
gtkmm-win32-runtime-2.14.1-3.exe, |
68 |
|
|
from <a href="http://www.gtkmm.org">www.gtkmm.org</a>, and run it. Let |
69 |
|
|
the installer adjust the PATH variable as it wants.</p> |
70 |
|
|
|
71 |
|
|
|
72 |
|
|
<h3><a name="msys">4. MSYS</a></h3> |
73 |
|
|
|
74 |
|
|
<p>I use the 1.0.11 Technology Preview version, as I had problems |
75 |
|
|
building DLLs with the 1.0.10 current version.</p> |
76 |
|
|
|
77 |
|
|
<p>Download from "MSYS Base System, Technology Preview: MSYS-1.0.11":</p> |
78 |
|
|
|
79 |
|
|
<pre>msysCORE-1.0.11-20080826.tar.gz |
80 |
|
|
bash-3.1-MSYS-1.0.11-1.tar.bz2</pre> |
81 |
|
|
|
82 |
|
|
<p>Unpack these to a directory of your choice, for example C:\msys. As |
83 |
|
|
1.0.11 doesn't have an installer yet, you need to have an unpacker |
84 |
|
|
that supports tar.gz/tar.bz, for example 7-Zip. The rest of the files |
85 |
|
|
you can unpack with the tar included in msysCORE.</p> |
86 |
|
|
|
87 |
|
|
<p>Run the postinstall\pi.bat file and specify your MinGW |
88 |
|
|
directory.</p> |
89 |
|
|
|
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>Download from "MSYS Supplementary Tools, Current Release: |
109 |
|
|
msysDTK-1.0.1":</p> |
110 |
|
|
|
111 |
|
|
<pre>m4-1.4.7-MSYS.tar.bz2 **</pre> |
112 |
|
|
|
113 |
|
|
|
114 |
|
|
<p>Extract all these files to the msys directory, by starting msys, |
115 |
|
|
do "cd /" and use tar.</p> |
116 |
|
|
|
117 |
|
|
|
118 |
|
|
<h3><a name="asio">5. ASIO SDK</a></h3> |
119 |
|
|
|
120 |
|
|
<p>Download asiosdk2.2.zip from Steinberg. Extract it to your msys |
121 |
|
|
$HOME.</p> |
122 |
|
|
|
123 |
|
|
|
124 |
|
|
<h3><a name="vst">6. VST SDK</a></h3> |
125 |
|
|
|
126 |
|
|
<p>If you want to build the LinuxSampler VST plugin, download |
127 |
|
|
vst_sdk2_4_rev2.zip from Steinberg (note that you should not choose |
128 |
|
|
version 3). Extract it to msys $HOME.</p> |
129 |
|
|
|
130 |
|
|
|
131 |
|
|
<h3><a name="intl">7. intltool ***</a></h3> |
132 |
|
|
|
133 |
|
|
<p>Download intltool_0.40.4-1_win32.zip from |
134 |
|
|
<a href="http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool">http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool</a></p> |
135 |
|
|
|
136 |
|
|
<p>Unzip this into the msys local directory, (C:\msys\local for |
137 |
|
|
example)</p> |
138 |
|
|
|
139 |
|
|
|
140 |
|
|
<h3><a name="perl">8. Perl ***</a></h3> |
141 |
|
|
|
142 |
|
|
<p>The perl in MSYS is lacking an XML parser which is needed by |
143 |
|
|
intltool. Download ActivePerl |
144 |
|
|
from <a href="http://www.activestate.com">www.activestate.com</a> and |
145 |
|
|
install it.</p> |
146 |
|
|
|
147 |
|
|
|
148 |
|
|
<h3><a name="xslt">9. xsltproc ***</a></h3> |
149 |
|
|
|
150 |
|
|
<p>The gigedit Makefile wants to build the gigedit quick start |
151 |
|
|
documentation, so it needs the xsltproc command. Download from |
152 |
|
|
<a href="ftp://ftp.zlatkovic.com/pub/libxml/">ftp://ftp.zlatkovic.com/pub/libxml/</a>:</p> |
153 |
|
|
|
154 |
|
|
<pre>libxml2-2.7.2+.win32.zip |
155 |
|
|
libxslt-1.1.24.win32.zip</pre> |
156 |
|
|
|
157 |
|
|
<p>Copy the contents of the bin directories from both zip files to a |
158 |
|
|
directory of your choice. Add this directory last in your msys PATH, |
159 |
|
|
for example:</p> |
160 |
|
|
|
161 |
|
|
<pre>export PATH=$PATH:$HOME/xsltproc</pre> |
162 |
|
|
|
163 |
|
|
|
164 |
|
|
<h3><a name="setup">10. MSYS setup</a></h3> |
165 |
|
|
|
166 |
|
|
<p>Add the gtkmm aclocal directory to the list of extra directories used |
167 |
|
|
by autoconf (make sure the gtkmm path is the one where you installed |
168 |
|
|
it):</p> |
169 |
|
|
|
170 |
|
|
<pre>echo "/c/Program Files/gtkmm/share/aclocal" >> /usr/local/share/aclocal/dirlist</pre> |
171 |
|
|
|
172 |
|
|
|
173 |
|
|
<p>Make sure pkg-config will find the LinuxSampler libraries:</p> |
174 |
|
|
|
175 |
|
|
<pre>export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig</pre> |
176 |
|
|
|
177 |
|
|
|
178 |
|
|
<p>*** The intltool scripts expect perl to be in /opt/perl/bin, so |
179 |
|
|
make a link to the ActivePerl installation. Also add ActivePerl to |
180 |
|
|
PATH:</p> |
181 |
|
|
|
182 |
|
|
<pre>mkdir -p /opt/perl/bin |
183 |
|
|
ln -s /c/Perl/bin/perl.exe /opt/perl/bin |
184 |
|
|
export PATH=/c/Perl/bin:$PATH</pre> |
185 |
|
|
|
186 |
|
|
|
187 |
|
|
<p>*** MSYS gettext and gtkmm both include libintl. We want the gtkmm |
188 |
|
|
version. Remove the MSYS files so the gettext configure tools don't |
189 |
|
|
choose the wrong version:</p> |
190 |
|
|
|
191 |
|
|
<pre>rm /usr/local/include/libintl.h /usr/local/lib/libintl*</pre> |
192 |
|
|
|
193 |
|
|
|
194 |
|
|
<p>*** The gettext configure tools also need:</p> |
195 |
|
|
|
196 |
|
|
<pre>export CPPFLAGS="-I/c/Program Files/gtkmm/include" |
197 |
|
|
export LDFLAGS="-L/c/Program Files/gtkmm/lib"</pre> |
198 |
|
|
|
199 |
|
|
|
200 |
|
|
<h3><a name="sndfile">11. Building libsndfile</a></h3> |
201 |
|
|
|
202 |
|
|
<p>The windows precompiled version of libsndfile doesn't include the |
203 |
|
|
neccessary pkg-config file, so it's best to build libsndfile |
204 |
|
|
yourself. Download libsndfile-1.0.17.tar.gz |
205 |
|
|
from <a href="http://www.mega-nerd.com/libsndfile/">www.mega-nerd.com</a> and |
206 |
|
|
extract it to your $HOME:</p> |
207 |
|
|
|
208 |
|
|
<pre>cd |
209 |
|
|
tar xzf libsndfile-1.0.17.tar.gz</pre> |
210 |
|
|
|
211 |
|
|
<p>To prevent a compilation error for the test cases, add</p> |
212 |
|
|
|
213 |
|
|
<pre>#include <stdint.h></pre> |
214 |
|
|
|
215 |
|
|
<p>to tests/utils.h.</p> |
216 |
|
|
|
217 |
|
|
<pre>./configure |
218 |
|
|
make |
219 |
|
|
make install</pre> |
220 |
|
|
|
221 |
|
|
|
222 |
|
|
<h3><a name="gig">12. Building libgig</a></h3> |
223 |
|
|
|
224 |
|
|
<p>Just use the same commands as you would in linux:</p> |
225 |
|
|
|
226 |
|
|
<pre>make -f Makefile.cvs (if you build from CVS) |
227 |
|
|
./configure (add any configuration parameters as you wish) |
228 |
|
|
make |
229 |
|
|
make install</pre> |
230 |
|
|
|
231 |
|
|
|
232 |
|
|
<h3><a name="ls">13. Building linuxsampler</a></h3> |
233 |
|
|
|
234 |
|
|
<pre>make -f Makefile.cvs (if you build from CVS) |
235 |
|
|
./configure --enable-asiosdk-dir=$HOME --enable-vstsdk-dir=$HOME/vstsdk2.4 |
236 |
|
|
make |
237 |
|
|
make install</pre> |
238 |
|
|
|
239 |
|
|
|
240 |
|
|
<h3><a name="gigedit">14. Building gigedit</a></h3> |
241 |
|
|
|
242 |
|
|
<pre>make -f Makefile.cvs (if you build from CVS) |
243 |
|
|
./configure |
244 |
|
|
make |
245 |
|
|
make install</pre> |
246 |
|
|
</body> |
247 |
|
|
</html> |