build.txt

   1 /** \r
   2 \page build Build instructions\r
   3 \r
   4 \section Introduction Introduction\r
   5 Compiling TortoiseGit is not very difficult, but it requires several steps\r
   6 to finish, at least the first time.\r
   7 \r
   8 Unlike other big open source projects, once you have built all the libraries\r
   9 TortoiseGit depends on, you can use the familiar VisualStudio IDE to build\r
  10 and debug the binaries. No need to run the build script for every little change.\r
  11 \r
  12 So don't give up if you read through the next section and all the requirements.\r
  13 You only have to do this once.\r
  14 \r
  15 \section Requirements Requirements\r
  16 \r
  17 \subsection Requirements1 First, you need to install the compiler package.\r
  18 \r
  19 -# You need VS2012 with Update 1 (or at least Visual Studio 2010) to allow\r
  20    building of the full TortoiseGit package. \r
  21    If you don't have the Update 1 installed for VS2012 you cannot build\r
  22    binaries which run on Windows XP.\r
  23    This is the recommended option, but it is not free :-(\r
  24    If you want to build the msi make sure the "Tools for Redistributing\r
  25    Applications" are installed.\r
  26 -# If you do not have access to VS.NET you can download the free\r
  27    Visual C++ 2012 Express Edition.\r
  28    This will allow you to build the subversion libraries and the\r
  29    TortoiseGitBlame, TortoiseGitUDiff, TortoiseGitIDiff, CrashRpt\r
  30    and ResText projects only. You can not build the main parts of\r
  31    TortoiseGit(shell extension, TortoiseGitProc, TGitCache, TortoiseGitMerge)\r
  32    with the Express Edition!\r
  33    - Install Visual C++ 2012 Express Edition.\r
  34      Download it from http://msdn.microsoft.com/vstudio/express/visualc/\r
  35    - Install MASM 6.15 from: http://win32assembly.online.fr/files/masm615.zip\r
  36      and add it to the PATH environment variable\r
  37    \note Do not bother to install WiX and Votive as you cannot build very much.\r
  38 \r
  39 \subsection Requirements2 Next you need to install some utilities/programs.\r
  40 - WiX3.7                   http://wix.codeplex.com/\r
  41 .\r
  42 \r
  43 \section get external source code\r
  44 git submodule update --init\r
  45 \r
  46 \section build Building the packages\r
  47 \r
  48 Open TortoiseGit.sln\r
  49 Build all projects.\r
  50 \r
  51 If you want to build the installer package, make sure you build the Win32 configuration before the x64 one.\r
  52 \r
  53 */\r