909283fdbb1b0147ad1498b2f44b5e48e2f72e6e
[platform/upstream/glib.git] / build / win32 / vs10 / README.txt
1 Note that all this is rather experimental.\r
2 \r
3 This VS10 solution and the projects it includes are intented to be used\r
4 in a GLib source tree unpacked from a tarball. In a git checkout you\r
5 first need to use some Unix-like environment or manual work to expand\r
6 the .in files needed, mainly config.h.win32.in into config.h.win32 and\r
7 glibconfig.h.win32.in into glibconfig.h.win32. You will also need to\r
8 expand the .vcprojin files here into .vcproj files.\r
9 \r
10 The required dependencies are zlib, proxy-libintl and LibFFI. Fetch the latest\r
11 proxy-libintl-dev and zlib-dev zipfiles from\r
12 http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ for 32-bit\r
13 builds, and correspondingly\r
14 http://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ for 64-bit\r
15 builds.\r
16 \r
17 One may wish to build his/her own ZLib-It is recommended that ZLib is\r
18 built using the win32/Makefile.msc makefile with VS10 with the ASM routines\r
19 to avoid linking problems-see win32/Makefile.msc in ZLib for more details.\r
20 \r
21 For LibFFI, please get version 3.0.10rc8 or later, as Visual C++ build support\r
22 was added in the 3.0.10(rc) release series.  Please see the README file that\r
23 comes with the LibFFI source package for more details on how to build LibFFI\r
24 on Visual C++-please note that the mozilla-build package from Mozilla is needed\r
25 in order to build LibFFI on Windows.\r
26 \r
27 One may optionally use his/her own PCRE installation by selecting the\r
28 (BuildType)_ExtPCRE configuration, but please note the PCRE must be built\r
29 with VS10 with unicode support using the /MD (release) or /MDd (debug)\r
30 runtime option which corresponds to your GLib build flavour (release, debug).\r
31 (These are the defaults set by CMAKE, which is used in recent versions of PCRE.)\r
32 Not doing so will most probably result in unexpected crashes in \r
33 your programs due to the use of different CRTs.  If using a static PCRE\r
34 build, add PCRE_STATIC to the "preprocessor definitions".\r
35 Note that one may still continue to build with the bundled PCRE by selecting\r
36 the (BuildType) configuration.\r
37 \r
38 Set up the source tree as follows under some arbitrary top\r
39 folder <root>:\r
40 \r
41 <root>\<this-glib-source-tree>\r
42 <root>\vs10\<PlatformName>\r
43 \r
44 *this* file you are now reading is thus located at\r
45 <root>\<this-glib-source-tree>\build\win32\vs10\README.\r
46 \r
47 <PlatformName> is either Win32 or x64, as in VS10 project files.\r
48 \r
49 You should unpack the proxy-libintl-dev zip file into\r
50 <root>\vs10\<PlatformName>, so that for instance libintl.h end up at\r
51 <root>\vs10\<PlatformName>\include\libintl.h.\r
52 \r
53 For LibFFI, one should also put the generated ffi.h and ffitarget.h\r
54 into <root>\vs10\<PlatformName>\include\ and the compiled static libffi.lib\r
55 (or copy libffi-convenience.lib into libffi.lib) into \r
56 <root>\vs10\<PlatformName>\lib\.\r
57 \r
58 The "install" project will copy build results and headers into their\r
59 appropriate location under <root>\vs10\<PlatformName>. For instance,\r
60 built DLLs go into <root>\vs10\<PlatformName>\bin, built LIBs into\r
61 <root>\vs10\<PlatformName>\lib and GLib headers into\r
62 <root>\vs10\<PlatformName>\include\glib-2.0. This is then from where\r
63 project files higher in the stack are supposed to look for them, not\r
64 from a specific GLib source tree.\r
65 \r
66 --Tor Lillqvist <tml@iki.fi>\r
67 --Updated by Chun-wei Fan <fanc999@gmail.com>\r