Debian Codegraph @

build-aux/win32/vs10/README.txt

raw
1 Note that all this is rather experimental.
2
3 A more detailed description on using Visual C++ to compile Clutter with
4 its dependencies can be found on the following GNOME Live! page:
5
6 https://wiki.gnome.org/GTK%2B/Win32/MSVCCompilationOfGTKStack
7
8 Please do not attempt to compile Clutter in a path that contains spaces
9 to avoid potential problems during compilation, linking or usage.
10
11 This VS10 solution and the projects it includes are intented to be used
12 in a Clutter source tree unpacked from a tarball. In a git checkout you
13 first need to use some Unix-like environment or manual work to expand
14 the files needed, like config.h.win32.in into config.h.win32 and the
15 .vcprojxin and .vcxproj.filtersin files here into corresponding actual
16 .vcxproj and .vcxproj.filters files.
17
18 You will need the parts from GNOME: Cogl, JSON-GLib, GDK-Pixbuf,
19 Pango*, atk and GLib. External dependencies are at least zlib, libpng,
20 gettext-runtime* and Cairo*, and glext.h from
21 http://www.opengl.org/registry/api/glext.h (which need to be in the GL folder
22 in your include directories or in <root>\vs10\<PlatformName>\include\GL).
23
24 Please see the README file in the root directory of this Clutter source package
25 for the versions of the dependencies required. See also
26 build-aux/win32/vs10/README.txt in the GLib source package for details
27 where to unpack them. It is recommended that at least the dependencies
28 from GNOME are also built with VS10 to avoid crashes caused by mixing different
29 CRTs-please see also the build-aux/win32/vs10/README.txt in those respective
30 packages.
31
32 The recommended build sequence of the dependencies are as follows (the non-GNOME
33 packages that are not downloaded as binaries from ftp://ftp.gnome.org have
34 makefiles and/or VS project files that can be used to compile with VS directly,
35 except the optional PCRE, which is built on VS using CMake; GLib & ATK have
36 VS10 project files in the latest stable versions, GDK-Pixbuf have VS10 project files
37 in the latest unstable version, and Cogl, JSON-GLib and Pango should have VS10 project
38 files in the next unstable release):
39 -Unzip the binary packages for gettext-runtime, freetype, expat and fontconfig
40 downloaded from ftp://ftp.gnome.org*
41 -zlib
42 -libpng
43 -(optional for GLib) PCRE (8.12 or later, building PCRE using CMake is
44 recommended-please see build-aux/win32/vs10/README.txt in the GLib source package)
45 -(for gdk-pixbuf, if GDI+ is not to be used) IJG JPEG
46 -(for gdk-pixbuf, if GDI+ is not to be used) jasper [JPEG-2000 library]
47 -(for gdk-pixbuf, if GDI+ is not to be used, requires zlib and IJG JPEG) libtiff
48 -GLib
49 -Cairo
50 -Pango
51 -ATK
52 -GDK-Pixbuf
53 -JSON-GLib
54 -Cogl
55 (Note that Pango, ATK, GDK-Pixbuf and JSON-GLib are not dependent on each
56 other, so building them in any order will do)
57
58 Note that a working PERL installation (such as ActiveState or Strawberry PERL)
59 is also required for compilation of Clutter, as the glib-mkenums PERL utility
60 script available from the GLib package will be used. Please ensure that the
61 PERL interpretor is in your PATH. If a glib-mkenums script is not available,
62 please extract glib-mkenums.in from the gobject subdirectory of the
63 GLib source package, and change the lines and save as glib-mkenums in
64 <root>\vs10\<PlatformName>\bin:
65
66 #! @PERL_PATH@ (circa line 1)
67 to
68 #! c:/perl/bin (or whereever your PERL interpretor executable is)
69
70 -and-
71
72 print "glib-mkenums version glib-@GLIB_VERSION@\n";
73 to
74 print "glib-mkenums version glib-<your GLib version>\n";
75
76 The "install" project will copy build results and headers into their
77 appropriate location under <root>\vs10\<PlatformName>. For instance,
78 built DLLs go into <root>\vs10\<PlatformName>\bin, built LIBs into
79 <root>\vs10\<PlatformName>\lib and Clutter headers into
80 <root>\vs10\<PlatformName>\include\clutter-1.0.
81
82 *There is no known official VS10 build support for fontconfig
83 (required for Pango and Pango at the moment-I will see whether this
84 requirement can be made optional for VS builds)
85 (along with freetype and expat) and gettext-runtime, so
86 please use the binaries from:
87
88 ftp://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32 bit)
89 ftp://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64 bit)
90
91 Note: If you see C4819 warnings and you are compiling Clutter on a DBCS
92 (Chinese/Korean/Japanese) version of Windows, you may need to switch
93 to an English locale in Control Panel->Region and Languages->System->
94 Change System Locale, reboot and rebuild to ensure Clutter and its
95 dependencies are built correctly. This is due to a bug in Visual C++
96 running on DBCS locales.
97
98 --Chun-wei Fan <[email protected]>
99 (Adopted from the GTK+ Win32 VS README.txt file originally by Tor Lillqvist)