build.txt

   1 Build instructions\r
   2 ==================\r
   3 \r
   4 Compiling TortoiseGit is not very difficult, but it requires several steps\r
   5 to finish, at least the first time.\r
   6 \r
   7 Unlike other big open source projects, once you have built all the libraries\r
   8 TortoiseGit depends on, you can use the familiar Visual Studio IDE to build\r
   9 and debug the binaries. No need to run the build script for every little change.\r
  10 \r
  11 So don't give up if you read through the next section and all the requirements.\r
  12 You only have to do this once.\r
  13 \r
  14 Requirements\r
  15 ------------\r
  16 \r
  17 First, you need to install the compiler package:\r
  18 \r
  19 *  You need VS2012 Professional with Update 4 to allow\r
  20    building of the full TortoiseGit package. \r
  21    If you don't have the Update 3 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 Professional you can download the free\r
  27    Visual Studio Express 2012 for Windows Desktop.\r
  28    This will allow you to build the git libraries and the\r
  29    TortoiseGitUDiff, TortoiseGitIDiff, and ResText projects only.\r
  30    You can not build the main parts of TortoiseGit(shell extension, TortoiseGitProc,\r
  31    TGitCache, TortoiseGitMerge, and TortoiseGitBlame)\r
  32    with the Express Edition!\r
  33    - Install Visual Studio Express 2012 for Windows Desktop.\r
  34      Download it from http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-for-windows-desktop\r
  35      Do not bother to install WiX as you cannot build very much.\r
  36 \r
  37 Next you might need to install some utilities/programs:\r
  38 *  If you want to build the MSI installer you need WiX3.8 (http://wix.codeplex.com/)\r
  39 *  For building the docs you need NAnt (http://nant.sourceforge.net/) and\r
  40    http://code.google.com/p/tortoisesvn/downloads/detail?name=Tools-1.8.0.7z\r
  41 \r
  42 Get external source code\r
  43 ------------------------\r
  44 \r
  45 TortoiseGit comes with all required code in its repository included or linked as submodules:\r
  46 \r
  47 Run\r
  48 \r
  49 git submodule update --init\r
  50 \r
  51 to download all linked repositories (submodules) automatically.\r
  52 Alternatively, you can download submodules when cloning the main project with single command.\r
  53 \r
  54 git clone --recursive https://code.google.com/p/tortoisegit/\r
  55 \r
  56 Building the packages\r
  57 ---------------------\r
  58 \r
  59 Open TortoiseGit.sln in Visual Studio.\r
  60 Build all projects.\r
  61 \r
  62 You can also build TortoiseGit via command line by calling MSBuild 4.0.\r
  63 Open Developer Command Prompt for VS2012\r
  64 MSBuild TortoiseGit.sln /p:Configuration=Release;Platform=Win32\r
  65 MSBuild TortoiseGit.sln /p:Configuration=Release;Platform=x64\r
  66 \r
  67 If you want to build the installer package, make sure you build the Win32 configuration before the x64 one\r
  68 Also, build the docs before before the installer packages.\r