Debian Codegraph @

subprojects/gperf/INSTALL.windows

raw
1 Installation on Microsoft Windows:
2
3 There are three ways to create binaries of this package for Microsoft Windows:
4 1) Native binaries, built using the mingw tool chain.
5 2) Native binaries, built using the MS Visual C/C++ tool chain.
6 3) Binaries for the Cygwin environment.
7
8 ===============================================================================
9 1) Native binaries, built using the mingw tool chain.
10
11 I recommend to use the Cygwin environment as the development environment
12 and mingw only as the target (runtime, deployment) environment.
13 For this, you need to install
14 * Cygwin (from https://cygwin.com/),
15 * some packages available from the Cygwin package installer:
16 make
17 * the mingw cross-compilation tools and runtime package, available from
18 the Cygwin package installer (setup-x86_64.exe):
19 - for creating 32-bit binaries: packages
20 mingw64-i686-gcc-core,
21 mingw64-i686-gcc-g++,
22 mingw64-i686-headers,
23 mingw64-i686-runtime
24 - for creating 64-bit binaries: packages
25 mingw64-x86_64-gcc-core,
26 mingw64-x86_64-gcc-g++,
27 mingw64-x86_64-headers,
28 mingw64-x86_64-runtime
29
30 Building 32-bit binaries for mingw is achieved through the following
31 preparation, configure, and build commands:
32
33 PATH=/usr/local/mingw32/bin:/usr/i686-w64-mingw32/sys-root/mingw/bin:$PATH
34 export PATH
35 ./configure --host=i686-w64-mingw32 --prefix=/usr/local/mingw32 \
36 CC=i686-w64-mingw32-gcc \
37 CXX=i686-w64-mingw32-g++ \
38 CPPFLAGS="-I/usr/local/mingw32/include -Wall" \
39 LDFLAGS="-L/usr/local/mingw32/lib"
40 make
41 make check
42
43 Building 64-bit binaries for mingw is achieved through the following
44 preparation, configure, and build commands:
45
46 PATH=/usr/local/mingw64/bin:/usr/x86_64-w64-mingw32/sys-root/mingw/bin:$PATH
47 export PATH
48 ./configure --host=x86_64-w64-mingw32 --prefix=/usr/local/mingw64 \
49 CC=x86_64-w64-mingw32-gcc \
50 CXX=x86_64-w64-mingw32-g++ \
51 CPPFLAGS="-I/usr/local/mingw64/include -Wall" \
52 LDFLAGS="-L/usr/local/mingw64/lib"
53 make
54 make check
55
56 Installation:
57
58 make install
59
60 ===============================================================================
61 2) Native binaries, built using the MS Visual C/C++ tool chain.
62
63 Note that binaries created with MSVC have a distribution constraint: They
64 depend on a closed-source library ('msvcr90.dll' for MSVC 9.0,
65 'vcruntime140.dll' for MSVC 14.0, and so on) which is not normally part of
66 a Windows installation.
67 You cannot distribute 'vcruntime*.dll' with the binaries - this would be a
68 violation of the GPL and of the Microsoft EULA.
69 You can distribute the binaries without including 'vcruntime*.dll'. Users
70 who don't have this library on their system will require to pull some files
71 (api-ms-win*.dll) through the Windows Update mechanism, see
72 https://support.microsoft.com/en-us/kb/2999226 .
73
74 This recipe requires MS Visual C/C++ 9.0 or newer.
75 You don't need the Visual Studio IDE, just the C/C++ tool chain.
76 As of 2016, you can install the MS Visual C/C++ 14.0 tool chain from
77 http://landinghub.visualstudio.com/visual-cpp-build-tools (it's the file
78 visualcppbuildtools_full.exe).
79
80 This recipe requires also a Cygwin environment (with 'bash', the common POSIX
81 commands, and 'make') as a build environment. Building with 'nmake' is not
82 supported.
83 For this, you need to install
84 * Cygwin (from https://cygwin.com/),
85 * some packages available from the Cygwin package installer:
86 make
87
88 You also need the scripts 'ar-lib' and 'compile' from
89 https://git.savannah.gnu.org/gitweb/?p=automake.git;a=blob_plain;f=lib/ar-lib;hb=HEAD
90 https://git.savannah.gnu.org/gitweb/?p=automake.git;a=blob_plain;f=lib/compile;hb=HEAD
91 respectively.
92 They may also be included in this package, in directory 'build-aux/'.
93 Save them; the instructions below assume that you stored them in $HOME/msvc/.
94 Make them executable:
95 chmod a+x ar-lib compile
96
97 Start a bash (from Cygwin).
98
99 Make sure that the MSVC tools ("cl" etc.) are found in PATH and the
100 environment variables INCLUDE and LIB are set appropriately.
101 In a typical MSVC 9.0 installation, it can be achieved by running
102 C:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\vsvars32.bat
103 In a typical MSVC 14.0 installation on Windows 10, it can be achieved
104 - for creating 32-bit binaries: through the following bash commands:
105
106 # Set environment variables for using MSVC 14,
107 # for creating native 32-bit Windows executables.
108
109 # Windows C library headers and libraries.
110 WindowsCrtIncludeDir='C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt'
111 WindowsCrtLibDir='C:\Program Files (x86)\Windows Kits\10\Lib\10.0.10240.0\ucrt\'
112 INCLUDE="${WindowsCrtIncludeDir};$INCLUDE"
113 LIB="${WindowsCrtLibDir}x86;$LIB"
114
115 # Windows API headers and libraries.
116 WindowsSdkIncludeDir='C:\Program Files (x86)\Windows Kits\8.1\Include\'
117 WindowsSdkLibDir='C:\Program Files (x86)\Windows Kits\8.1\Lib\winv6.3\um\'
118 INCLUDE="${WindowsSdkIncludeDir}um;${WindowsSdkIncludeDir}shared;$INCLUDE"
119 LIB="${WindowsSdkLibDir}x86;$LIB"
120
121 # Visual C++ tools, headers and libraries.
122 VSINSTALLDIR='C:\Program Files (x86)\Microsoft Visual Studio 14.0'
123 VCINSTALLDIR="${VSINSTALLDIR}"'\VC'
124 PATH=`cygpath -u "${VCINSTALLDIR}"`/bin:"$PATH"
125 INCLUDE="${VCINSTALLDIR}"'\include;'"${INCLUDE}"
126 LIB="${VCINSTALLDIR}"'\lib;'"${LIB}"
127
128 export INCLUDE LIB
129
130 - for creating 64-bit binaries: through the following bash commands:
131
132 # Set environment variables for using MSVC 14,
133 # for creating native 64-bit Windows executables.
134
135 # Windows C library headers and libraries.
136 WindowsCrtIncludeDir='C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt'
137 WindowsCrtLibDir='C:\Program Files (x86)\Windows Kits\10\Lib\10.0.10240.0\ucrt\'
138 INCLUDE="${WindowsCrtIncludeDir};$INCLUDE"
139 LIB="${WindowsCrtLibDir}x64;$LIB"
140
141 # Windows API headers and libraries.
142 WindowsSdkIncludeDir='C:\Program Files (x86)\Windows Kits\8.1\Include\'
143 WindowsSdkLibDir='C:\Program Files (x86)\Windows Kits\8.1\Lib\winv6.3\um\'
144 INCLUDE="${WindowsSdkIncludeDir}um;${WindowsSdkIncludeDir}shared;$INCLUDE"
145 LIB="${WindowsSdkLibDir}x64;$LIB"
146
147 # Visual C++ tools, headers and libraries.
148 VSINSTALLDIR='C:\Program Files (x86)\Microsoft Visual Studio 14.0'
149 VCINSTALLDIR="${VSINSTALLDIR}"'\VC'
150 PATH=`cygpath -u "${VCINSTALLDIR}"`/bin/amd64:"$PATH"
151 INCLUDE="${VCINSTALLDIR}"'\include;'"${INCLUDE}"
152 LIB="${VCINSTALLDIR}"'\lib\amd64;'"${LIB}"
153
154 export INCLUDE LIB
155
156 Building 32-bit binaries with MSVC is achieved through the following
157 preparation, configure, and build commands:
158
159 PATH=/usr/local/msvc32/bin:$PATH
160 export PATH
161
162 win32_target=_WIN32_WINNT_WINXP # for MSVC 9.0
163 win32_target=_WIN32_WINNT_VISTA # possibly for MSVC >= 10.0
164 win32_target=_WIN32_WINNT_WIN7 # possibly for MSVC >= 10.0
165 win32_target=_WIN32_WINNT_WIN8 # possibly for MSVC >= 10.0
166
167 ./configure --host=i686-w64-mingw32 --prefix=/usr/local/msvc32 \
168 CC="$HOME/msvc/compile cl -nologo" \
169 CFLAGS="-MD" \
170 CXX="$HOME/msvc/compile cl -nologo" \
171 CXXFLAGS="-MD" \
172 CPPFLAGS="-D_WIN32_WINNT=$win32_target -I/usr/local/msvc32/include" \
173 LDFLAGS="-L/usr/local/msvc32/lib" \
174 LD="link" \
175 NM="dumpbin -symbols" \
176 STRIP=":" \
177 AR="$HOME/msvc/ar-lib lib" \
178 RANLIB=":"
179 make
180 make check
181
182 Building 64-bit binaries with MSVC is achieved through the following
183 preparation, configure, and build commands:
184
185 PATH=/usr/local/msvc64/bin:$PATH
186 export PATH
187
188 win32_target=_WIN32_WINNT_WINXP # for MSVC 9.0
189 win32_target=_WIN32_WINNT_VISTA # possibly for MSVC >= 10.0
190 win32_target=_WIN32_WINNT_WIN7 # possibly for MSVC >= 10.0
191 win32_target=_WIN32_WINNT_WIN8 # possibly for MSVC >= 10.0
192
193 ./configure --host=x86_64-w64-mingw32 --prefix=/usr/local/msvc64 \
194 CC="$HOME/msvc/compile cl -nologo" \
195 CFLAGS="-MD" \
196 CXX="$HOME/msvc/compile cl -nologo" \
197 CXXFLAGS="-MD" \
198 CPPFLAGS="-D_WIN32_WINNT=$win32_target -I/usr/local/msvc64/include" \
199 LDFLAGS="-L/usr/local/msvc64/lib" \
200 LD="link" \
201 NM="dumpbin -symbols" \
202 STRIP=":" \
203 AR="$HOME/msvc/ar-lib lib" \
204 RANLIB=":"
205 make
206 make check
207
208 Installation:
209
210 make install
211
212 ===============================================================================
213 3) Binaries for the Cygwin environment.
214
215 The generic instructions in the INSTALL file apply. But here are more
216 specific ones.
217
218 You need to install
219 * Cygwin (from https://cygwin.com/),
220 * some packages available from the Cygwin package installer:
221 make
222 * the Cygwin [cross-]compilation tools package, available from
223 the Cygwin package installer (setup-x86_64.exe):
224 - for creating 32-bit binaries: packages
225 cygwin32-gcc-core,
226 cygwin32-gcc-g++,
227 cygwin32
228 - for creating 64-bit binaries: packages
229 gcc-core,
230 gcc-g++
231
232 Building 32-bit binaries for Cygwin is achieved through the following
233 preparation, configure, and build commands:
234
235 PATH=/usr/local/cygwin32/bin:/usr/i686-pc-cygwin/sys-root/usr/bin:$PATH
236 export PATH
237 ./configure --host=i686-pc-cygwin --prefix=/usr/local/cygwin32 \
238 CC=i686-pc-cygwin-gcc \
239 CXX=i686-pc-cygwin-g++ \
240 CPPFLAGS="-I/usr/local/cygwin32/include -Wall" \
241 LDFLAGS="-L/usr/local/cygwin32/lib"
242 make
243 make check
244
245 Building 64-bit binaries for Cygwin is achieved through the following
246 preparation, configure, and build commands:
247
248 PATH=/usr/local/cygwin64/bin:$PATH
249 export PATH
250 ./configure --host=x86_64-pc-cygwin --prefix=/usr/local/cygwin64 \
251 CC=x86_64-pc-cygwin-gcc \
252 CXX=x86_64-pc-cygwin-g++ \
253 CPPFLAGS="-I/usr/local/cygwin64/include -Wall" \
254 LDFLAGS="-L/usr/local/cygwin64/lib"
255 make
256 make check
257
258 Installation:
259
260 make install
261
262 ===============================================================================