win32/vs10/README.txt

   1 Please do not build this package in a path that contains spaces to avoid\r
   2 possible problems during the build or during the usage of the library.\r
   3 \r
   4 Please refer to the following GNOME Live! page for more detailed\r
   5 instructions on building ATK and its dependencies with Visual C++:\r
   6 \r
   7 https://live.gnome.org/GTK%2B/Win32/MSVCCompilationOfGTKStack\r
   8 \r
   9 This VS10 solution and the projects it includes are intented to be used\r
  10 in a ATK source tree unpacked from a tarball. In a git checkout you\r
  11 first need to use some Unix-like environment or manual work to expand\r
  12 the .in files needed, mainly config.h.win32.in into config.h.win32.\r
  13 You will also need to expand atk.vcxprojin and atk.vcxproj.filtersin here\r
  14 into atk.vcxproj and atk.vcxproj.filters respectively.\r
  15 \r
  16 The dependencies for this package are gettext-runtime (libintl), GLib*\r
  17 and ZLib.\r
  18 \r
  19 You will also need a Python 2.7.x or 3.x installation, as Python will be\r
  20 used to run glib-genmarshal, which was converted into a Python script from\r
  21 a compiled C program, in addition to generating the atk.pc pkg-config\r
  22 file for the build.  See PythonDir (32-bit builds) or PythonDirX64 (x64\r
  23 builds) in atk-version-paths.props to see that they point to the correct paths.\r
  24 \r
  25 \r
  26 a) look for all of the dependencies (except GLib*) under\r
  27 \r
  28    http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32-bit) -OR-\r
  29    http://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64-bit)\r
  30 \r
  31    Please use the latest versions of these libraries that are available there,\r
  32    these are packaged by Tor Lillqvist, which are built with MinGW/GCC.\r
  33    Please see b) below regarding the build of  GLib*\r
  34 \r
  35 -OR-\r
  36 \r
  37 b) Build them yourself with VS10 (but you may most probably wish to get\r
  38    gettext-runtime from the URL(s) mentioned in a)).  Use the latest\r
  39    stable versions for them (you may need to get the latest unstable version of\r
  40    GLib if you are using an unstable version of ATK):\r
  41 \r
  42    GLib*:   Grab the latest sources from http://www.gtk.org under "Download"\r
  43             (stable only-please make a search for the latest unstable versions)\r
  44    ZLib:   http://www.zlib.net\r
  45 \r
  46    The above 2 packages all have supported mechanisms (Makefiles and/or Project\r
  47    Files) for building under VS10 (upgrade the Project Files from earlier VS\r
  48    versions will do for these, when applicable)\r
  49 \r
  50 * This GLib refers to a build that is built by VS10\r
  51 \r
  52 Set up the source tree as follows under some arbitrary top\r
  53 folder <root>:\r
  54 \r
  55 <root>\atk\<this-atk-source-tree>\r
  56 <root>\vs10\<PlatformName>\r
  57 \r
  58 *this* file you are now reading is thus located at\r
  59 <root>\atk\<this-atk-source-tree>\win32\vs10\README.\r
  60 \r
  61 <PlatformName> is either Win32 or x64, as in VS10 project files.\r
  62 \r
  63 You should unpack the <dependent-package>-dev and <dependent-packge> (runtime)\r
  64 into <root>\vs10\<PlatformName>, if you download any of the packages from\r
  65 \r
  66 http://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32-bit) -OR-\r
  67 http://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64-bit)\r
  68 \r
  69 so that for instance libintl.h end up at \r
  70 <root>\vs10\<PlatformName>\include\libintl.h.\r
  71 \r
  72 If you build any of the dependencies yourselves, copy the: \r
  73 -DLLs and EXEs into <root>\vs10\<PlatformName>\bin\r
  74 -headers into <root>\vs10\<PlatformName>\include\\r
  75 -LIBs into <root>\vs10\<PlatformName>\lib\r
  76 \r
  77 If you have not built GLib with VS10 and placed the LIBs and headers in a\r
  78 place where VS10 can find them automatically, you should also uncompress\r
  79 your GLib sources in <root>\ and build it from there, following the\r
  80 instructions in <root>\glib<-version>\win32\vs10, so that the required\r
  81 headers, EXEs, DLLs and LIBs will end up in\r
  82 <root>\vs10\<PlatformName>\include\glib-2.0 (headers)\r
  83 <root>\vs10\<PlatformName>\lib (LIBs, also glib-2.0/include/glibocnfig.h)\r
  84 <root>\vs10\<PlatformName>\bin (EXEs/DLLs)\r
  85 respectively.\r
  86 \r
  87 After the build of ATK, the "install" project will copy build results\r
  88 and headers into their appropriate location under <root>\vs10\<PlatformName>.\r
  89 For instance, built DLLs go into <root>\vs10\<PlatformName>\bin, built LIBs into\r
  90 <root>\vs10\<PlatformName>\lib and atk headers into\r
  91 <root>\vs10\<PlatformName>\include\atk-1.0. This is then from where\r
  92 project files higher in the stack are supposed to look for them, not\r
  93 from a specific ATK source tree.\r
  94 \r
  95 --Chun-wei Fan <fanc999@yahoo.com.tw>\r
  96 --(adapted from the GLib VS9 README.txt file originally written by Tor Lillqvist)\r