Wiki

Clone wiki

AscensionUltra / Build Environment

Build Environment

To build the source code, you need the following prerequisites:

  • Orbiter 2010 P1
  • Orbitersound 3.5
  • UMmu 2.0
  • UCGO
  • Microsoft Visual C++ 2010 Express

Keep in mind that the Orbiter directory with DanSteph's addons alone is already ca. 360MB big. VC++ Express with the frameworks add another woopin' 2 GB. In addition, you need the appropriate source code version, of course. You can get this via ZIP archive from Bitbucket (http://bitbucket.org/face/ascensionultra/get/Visual%20C++%202010%20Express.zip), or - preferably - by means of cloning the source code repository and updating to the Visual C++ 2010 Express branch. To do this, you have to:

  1. install a Mercurial client (e.g. http://tortoisehg.bitbucket.org ),
  2. open a command shell (e.g. "cmd.exe"),
  3. navigate to the Orbiter installation directory (e.g. "cd C:\Users\myUser\Desktop\myOrbiter"),
  4. issue hg clone -U http://bitbucket.org/face/ascensionultra temp,
  5. wait for the download and update to complete,
  6. issue move temp\.hg . (mind the trailing period!),
  7. issue rmdir temp,
  8. issue hg update "Visual C++ 2010 Express" .

Once you have all the necessary elements installed, you can proceed to actually build the code. The best way to get to a debug environment (where you can simply F5 into the debugger build), is to:

  1. use Windows Explorer to navigate to the project source directory ( /Orbitersdk/samples/AscensionUltra/ ),
  2. double-click the file AscensionUltra.sln,
  3. wait for VC++ Express to open the solution,
  4. right-click on the project AscensionUltra in the solution explorer tab on the left side of VC++ and select Set as start project,
  5. right-click on the project AscensionUltra again and select Properties,
  6. on the tree view on the left side, click on Debugging,
  7. on the table view on the right side, click the Command row and enter ..\..\..\orbiter.exe,
  8. on the table view, also click the Working directory row and enter ..\..\..,
  9. press F5, a confirmation window should appear,
  10. click Yes, the build should run through, displaying a confirmation window for No debug information,
  11. click Ok, Orbiter's launch-pad should start now.

Updated