build/win32/vs10/README.txt

   1 Please do not compile this package (gobject-introspection) in paths that contain
   2 spaces in them-as strange problems may occur during compilation or during
   3 the use of the library.
   4
   5 Please refer to the following GNOME Live! page for more detailed
   6 instructions on building gobject-introsecption and its dependencies
   7 with Visual C++:
   8
   9 https://live.gnome.org/GTK%2B/Win32/MSVCCompilationOfGTKStack
  10
  11 This VS10 solution and the projects it includes are intented to be used
  12 in a gobject-introspection source tree unpacked from a tarball. In a git checkout you
  13 first need to use some Unix-like environment, which will do the work for you.
  14
  15 The required dependencies are Python 2.6 or later, GLib and LibFFI.  It is recommended
  16 that GLib is built with Visual C++ 2010 to avoid problems cause by usage of different CRTs
  17
  18 Please refer to the README.txt file in $(GLib_src_root)\build\win32\vs10 on how to build
  19 GLib using Visual C++ 2010
  20
  21 For LibFFI, please get version 3.0.10 or later, as Visual C++ build support
  22 was added in the 3.0.10 release series.  Please see the README file that
  23 comes with the LibFFI source package for more details on how to build LibFFI
  24 on Visual C++-please note that the mozilla-build package from Mozilla is needed
  25 in order to build LibFFI on Windows.
  26
  27 For Python, retrieving the official Windows binaries for 2.6 or later from
  28 http://www.python.org will do the job-be sure that the Python version that
  29 you downloaded matches the configuration of your build (win32 or x64/amd64).
  30
  31 For building the Regress test project, cairo (and possibly cairo-gobject support)
  32 is needed.
  33
  34 Set up the source tree as follows under some arbitrary top
  35 folder <root>:
  36
  37 <root>\<this-gobject-introspection-source-tree>
  38 <root>\vs10\<PlatformName>
  39
  40 *this* file you are now reading is thus located at
  41 <root>\<this-glib-source-tree>\build\win32\vs10\README.
  42
  43 <PlatformName> is either Win32 or x64, as in VS10 project files.
  44
  45 For LibFFI, one should also put the generated ffi.h and ffitarget.h
  46 into <root>\vs10\<PlatformName>\include\ and the compiled static libffi.lib
  47 (or copy libffi-convenience.lib into libffi.lib) into
  48 <root>\vs10\<PlatformName>\lib\.
  49
  50 The libintl.h that is used for building GLib needs to be in
  51 <root>\vs10\<PlatformName>\include, if not already done so
  52
  53 You will also need a working GCC/MinGW compiler installation
  54 in order to generate the .gir and .typelib files.  One may be
  55 obtained from the mingw or the mingw64 project.
  56
  57 A working pkg-config tool is also required-it may be obtained from
  58 http://www.gtk.org/download/win32.php [32-bit]
  59 http://www.gtk.org/download/win64.php [64-bit]
  60
  61 *** Note! ***
  62 Please note that due to numerous possible configurations on Python, some environmental
  63 variables need to be set before launching the gobject-introsection.sln solution file.
  64
  65 These variables are namely:
  66 PYTHONDIR: Root installation folder of your Python interpretor.
  67            It must match your build configuration (Win32 or x64/amd64)
  68 PKG_CONFIG_PATH: Location of the .pc (pkg-config) files, especially for the GLib .pc files.
  69 MINGWDIR: Root installation folder for your Windows GCC (such as MinGW).
  70 *** End of Note! ***
  71
  72 The "install" project will copy build results and headers into their
  73 appropriate location under <root>\vs10\<PlatformName>. For instance,
  74 built DLLs go into <root>\vs10\<PlatformName>\bin, built LIBs into
  75 <root>\vs10\<PlatformName>\lib and gobject-introspection headers into
  76 <root>\vs10\<PlatformName>\include\gobject-introsection-1.0.
  77
  78 The generated .gir files will end up in <root>\vs10\<PlatformName>\share\gir-1.0
  79 and .typelib files will end up in <root>\vs10\<PlatformName>\lib\girepository-1.0
  80
  81 This is then from where
  82 project files higher in the stack are supposed to look for them, not
  83 from a specific gobject-introspection source tree.
  84
  85 --Tor Lillqvist <tml@iki.fi>
  86 --Updated by Chun-wei Fan <fanc999@gmail.com>