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 VS2008 with SP1 (or at least Visual C++ 2008) to allow\r
  20    building of the full TortoiseGitpackage. \r
  21    If you don't have the SP1 installed for VS2008, you will also need the\r
  22    MFC feature pack for VS2008 which is available from here: \r
  23    http://www.microsoft.com/downloads/details.aspx?FamilyId=D466226B-8DAB-445F-A7B4-448B326C48E7&displaylang=en\r
  24    This is the recommended option, but it is not free :-(\r
  25    If you want to build the msi make sure the "Tools for Redistributing\r
  26    Applications" are installed.\r
  27 -# If you do not have access to VS.NET you can download the free\r
  28    Visual C++ 2008 Express Edition.\r
  29    This will allow you to build the subversion libraries and the\r
  30    SubWCRev, TortoiseBlame, TortoiseUDiff, TortoiseIDiff, CrashRpt\r
  31    and ResText projects only. You can not build the main parts of\r
  32    TortoiseGit(shell extension, TortoiseProc, TGitCache, TortoiseMerge)\r
  33    with the Express Edition!\r
  34    - Install Visual C++ 2008 Express Edition.\r
  35      Download it from http://msdn.microsoft.com/vstudio/express/visualc/\r
  36    - Install MASM 6.15 from: http://win32assembly.online.fr/files/masm615.zip\r
  37      and add it to the PATH environment variable\r
  38    \note Do not bother to install WiX and Votive as you cannot build very much.\r
  39 -# If you plan to build 64 bit packages, install the package \r
  40    - "Language Tools" -> "Visual C++" -> "X64 Compilers and Tools" \r
  41      available in the VS.NET2008 Professional and higher. \r
  42      This will provide you with a cross-compiler and a suitable \r
  43      command shell. On XP64, there will also be a native compiler.\r
  44 -# \b Install Microsoft SDK for Windows 7\r
  45    - http://www.microsoft.com/downloads/en/details.aspx?FamilyID=35aeda01-421d-4ba5-b44b-543dc8c33a20.\r
  46    - Open "Microsoft Windows SDK", "Visual Studio Registration", "Integrate Windows SDK with Visual Studio 2008"\r
  47      to make sure Visual Studio uses the latest SDK headers and libraries\r
  48      (for 2008 SP1 see: http://blogs.msdn.com/b/windowssdk/archive/2008/10/06/how-to-get-the-winsdk-configuration-tool-to-work.aspx).\r
  49 -# \b Optional: Install the MSDN Library (documentation) from\r
  50    http://www.microsoft.com/downloads/details.aspx?familyid=B8704100-0127-4D88-9B5D-896B9B388313\r
  51    You can always access it online at http://msdn2.microsoft.com/en-us/Library\r
  52 \r
  53 \subsection Requirements2 Next you need to install some utilities/programs.\r
  54 - WiX(\b 1)                   http://wix.sourceforge.net\r
  55 .\r
  56 (\b 1) Above 3.5 version\r
  57 \r
  58 \section get external source code\r
  59 git submodule update --init\r
  60 \r
  61 \section build Building the packages\r
  62 \r
  63 Open TortoiseGit.sln\r
  64 Build all projects.\r
  65 \r
  66 If you want to build the installer package, make sure you build the Win32 configuration before the x64 one.\r
  67 \r
  68 */\r