2013-02-24 19:44:10 +00:00
|
|
|
# Building
|
|
|
|
|
|
|
|
You must have a 64-bit machine for building and running the project. Always
|
|
|
|
run your system updater before building and make sure you have the latest
|
|
|
|
video drivers for your card.
|
|
|
|
|
|
|
|
## Setup
|
|
|
|
|
2013-10-18 06:35:54 +00:00
|
|
|
### Windows
|
|
|
|
|
2014-01-14 06:05:10 +00:00
|
|
|
* Windows 8 or 8.1
|
2015-02-06 02:16:55 +00:00
|
|
|
* Visual Studio 2015
|
2014-01-14 06:05:10 +00:00
|
|
|
* [Python 2.7](http://www.python.org/download/releases/2.7.6/)
|
|
|
|
* If you are on Windows 8, you will also need the [Windows 8.1 SDK](http://msdn.microsoft.com/en-us/windows/desktop/bg162891)
|
2013-10-18 06:35:54 +00:00
|
|
|
|
2013-11-16 09:15:17 +00:00
|
|
|
Ensure Python is in your PATH (`C:\Python27\`).
|
2013-10-18 06:35:54 +00:00
|
|
|
|
2014-10-25 18:42:54 +00:00
|
|
|
I recommend using [Cmder](http://bliker.github.io/cmder/) for git and command
|
|
|
|
line usage.
|
|
|
|
|
2013-10-18 06:35:54 +00:00
|
|
|
#### Debugging
|
|
|
|
|
2014-12-20 01:09:39 +00:00
|
|
|
VS behaves oddly with the debug paths. Open the xenia project properties
|
2013-10-18 06:35:54 +00:00
|
|
|
and set the 'Command' to `$(SolutionDir)$(TargetPath)` and the
|
|
|
|
'Working Directory' to `$(SolutionDir)..\..`. You can specify flags and
|
|
|
|
the file to run in the 'Command Arguments' field (or use `--flagfile=flags.txt`).
|
|
|
|
|
2015-08-30 01:06:30 +00:00
|
|
|
By default logs are written to a file with the name of the executable. You can
|
|
|
|
override this with `--log_file=log.txt`.
|
2013-02-24 19:44:10 +00:00
|
|
|
|
2015-09-21 04:31:05 +00:00
|
|
|
If running under Visual Studio and you want to look at the JIT'ed code
|
|
|
|
(available around 0xA0000000) you should pass `--emit_source_annotations` to
|
|
|
|
get helpful spacers/movs in the disassembly.
|
|
|
|
|
2015-08-18 21:18:00 +00:00
|
|
|
### Linux
|
|
|
|
|
|
|
|
Linux support is extremely experimental and incomplete.
|
|
|
|
|
|
|
|
Only tested with GCC 4.9 on Ubuntu 14. [CodeLite](http://codelite.org) is the
|
|
|
|
IDE of choice and `xb premake` will spit out files for that. Make also works via
|
|
|
|
`xb build`.
|
|
|
|
|
|
|
|
Currently building requires that CC == CXX == g++. If you know a way around this
|
|
|
|
(to force .c files to be built with g++) let me know.
|
|
|
|
|
2015-07-01 02:34:48 +00:00
|
|
|
## Running
|
2013-02-24 19:44:10 +00:00
|
|
|
|
2013-10-18 06:35:54 +00:00
|
|
|
To make life easier you can use `--flagfile=myflags.txt` to specify all
|
|
|
|
arguments, including using `--target=my.xex` to pick an executable.
|