[building.md+README.md] Move building instructions+xb to building, make Quickstart link to wiki

Also update and remove outdated information.
This commit is contained in:
Margen67 2019-07-05 12:29:36 -07:00 committed by Win98
parent 483d5e8ff4
commit dd46e30be5
2 changed files with 68 additions and 49 deletions

View File

@ -7,15 +7,15 @@
<h1 align="center">Xenia - Xbox 360 Emulator</h1> <h1 align="center">Xenia - Xbox 360 Emulator</h1>
Xenia is an experimental emulator for the Xbox 360. For more information, see the Xenia is an experimental emulator for the Xbox 360. For more information, see the
[main xenia website](https://xenia.jp/). [main Xenia wiki](https://github.com/xenia-project/xenia/wiki).
**Interested in supporting the core contributors?** Visit **Interested in supporting the core contributors?** Visit
[Xenia Project on Patreon](https://www.patreon.com/xenia_project). [Xenia Project on Patreon](https://www.patreon.com/xenia_project).
Come chat with us about **emulator-related topics** on [Discord](https://discord.gg/Q9mxZf9). Come chat with us about **emulator-related topics** on [Discord](https://discord.gg/Q9mxZf9).
For developer chat join `#dev` but stay on topic. Lurking is not only fine, but encouraged! For developer chat join `#dev` but stay on topic. Lurking is not only fine, but encouraged!
Please check the [frequently asked questions](https://xenia.jp/faq/) page before Please check the [FAQ](https://github.com/xenia-project/xenia/wiki/FAQ) page before asking questions.
asking questions. We've got jobs/lives/etc, so don't expect instant answers. We've got jobs/lives/etc, so don't expect instant answers.
Discussing illegal activities will get you banned. Discussing illegal activities will get you banned.
@ -41,29 +41,7 @@ legally purchased devices and games and information made public on the internet
## Quickstart ## Quickstart
With Windows 8+, Python 3.4+, and [Visual Studio 2017 or 2019](https://www.visualstudio.com/downloads/) and the Windows SDKs installed: See the [Quickstart](https://github.com/xenia-project/xenia/wiki/Quickstart) page.
> git clone https://github.com/xenia-project/xenia.git
> cd xenia
> xb setup
# Pull latest changes, rebase, and update submodules and premake:
> xb pull
# Build on command line:
> xb build
# Run premake and open Visual Studio (run the 'xenia-app' project):
> xb devenv
# Run premake to update the sln/vcproj's:
> xb premake
# Format code to the style guide:
> xb format
When fetching updates use `xb pull` to automatically fetch everything and
run premake for project files/etc.
## Building ## Building
@ -91,8 +69,4 @@ something.
## FAQ ## FAQ
For more see the main [frequently asked questions](https://xenia.jp/faq/) page. See the [frequently asked questions](https://github.com/xenia-project/xenia/wiki/FAQ) page.
### Can I get an exe?
[Latest master revision at AppVeyor](https://ci.appveyor.com/api/projects/benvanik/xenia/artifacts/xenia-master.zip?branch=master&job=Configuration%3A%20Release&pr=false)

View File

@ -2,22 +2,73 @@
You must have a 64-bit machine for building and running the project. Always 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 run your system updater before building and make sure you have the latest
video drivers for your card. drivers.
## Setup ## Setup
### Windows ### Windows
* Windows 8 or later * Windows 7 or later
* [Visual Studio 2017 or Visual Studio 2019](https://www.visualstudio.com/downloads/) * [Visual Studio 2019 or Visual Studio 2017](https://www.visualstudio.com/downloads/)
* [Python 3.4+](https://www.python.org/downloads/) * [Python 3.4+](https://www.python.org/downloads/)
* You may also need the [Windows 8.1 SDK](https://msdn.microsoft.com/en-us/windows/desktop/bg162891) * Ensure Python is in PATH.
* (for VS2017 just click the Windows 8.1 SDK option in the Individual Components section in the Visual Studio Installer) * Windows 10 SDK
Ensure Python is in your PATH. ```
git clone https://github.com/xenia-project/xenia.git
cd xenia
xb setup
I recommend using [Cmder](https://cmder.net/) for git and command # Build on command line (add --config=release for release):
line usage. xb build
# Pull latest changes, rebase, update submodules, and run premake:
xb pull
# Run premake and open Visual Studio (run the 'xenia-app' project):
xb devenv
# Run premake to update the sln/vcproj's:
xb premake
# Format code to the style guide:
xb format
```
<!--
# Remove intermediate files and build outputs (doesn't work on Linux):
xb clean
# Check for lint errors with clang-format:
xb lint
# Run the style checker on all code:
xb style
# Remove all build/ output and do a hard git reset:
xb nuke
# Runs the clang-tidy checker on all code:
xb tidy
## Testing:
# Generate tests:
xb gentests
# Run tests:
xb test
# Run GPU tests:
xb gputest
## Other:
# Generate SPIR-V binaries and header files:
xb genspirv
-->
#### Debugging #### Debugging
@ -43,8 +94,7 @@ swappable right now.
[CodeLite](https://codelite.org) is the IDE of choice and `xb premake` will spit [CodeLite](https://codelite.org) is the IDE of choice and `xb premake` will spit
out files for that. Make also works via `xb build`. out files for that. Make also works via `xb build`.
To get the latest Clang on an ubuntu system: To get the latest Clang on an Ubuntu system:
``` ```
sudo -E apt-add-repository -y "ppa:ubuntu-toolchain-r/test" sudo -E apt-add-repository -y "ppa:ubuntu-toolchain-r/test"
curl -sSL "http://llvm.org/apt/llvm-snapshot.gpg.key" | sudo -E apt-key add - curl -sSL "http://llvm.org/apt/llvm-snapshot.gpg.key" | sudo -E apt-key add -
@ -53,39 +103,34 @@ sudo -E apt-get -yq update &>> ~/apt-get-update.log
sudo -E apt-get -yq --no-install-suggests --no-install-recommends --force-yes install clang-4.0 clang-format-4.0 sudo -E apt-get -yq --no-install-suggests --no-install-recommends --force-yes install clang-4.0 clang-format-4.0
``` ```
You will also need some development libraries. To get them on an ubuntu system: You will also need some development libraries. To get them on an Ubuntu system:
``` ```
sudo apt-get install libgtk-3-dev libpthread-stubs0-dev liblz4-dev libglew-dev libx11-dev libvulkan-dev libc++-dev libc++abi-dev sudo apt-get install libgtk-3-dev libpthread-stubs0-dev liblz4-dev libglew-dev libx11-dev libvulkan-dev libc++-dev libc++abi-dev
``` ```
In addition, you will need the latest OpenGL libraries and drivers for your hardware. Intel and the open source In addition, you will need the latest Vulkan libraries and drivers for your hardware.
drivers are not supported as they do not yet support OpenGL 4.5.
#### Linux NVIDIA Vulkan Drivers #### Linux NVIDIA Vulkan Drivers
You'll need to install the latest NVIDIA drivers to enable Vulkan support on Linux. You'll need to install the latest NVIDIA drivers to enable Vulkan support on Linux.
First, remove all existing NVIDIA drivers: First, remove all existing NVIDIA drivers:
``` ```
sudo apt-get purge nvidia* sudo apt-get purge nvidia*
``` ```
Add the graphics-drivers PPA to your system: Add the graphics-drivers PPA to your system:
``` ```
sudo add-apt-repository ppa:graphics-drivers sudo add-apt-repository ppa:graphics-drivers
sudo apt update sudo apt update
``` ```
Install the NVIDIA drivers (newer ones may be released after 387; check online): Install the NVIDIA drivers (newer ones may be released after 387; check online):
``` ```
sudo apt install nvidia-387 sudo apt install nvidia-387
``` ```
Either reboot the computer, or inject the NVIDIA drivers: Either restart the computer, or inject the NVIDIA drivers:
``` ```
sudo rmmod nouveau sudo rmmod nouveau
sudo modprobe nvidia sudo modprobe nvidia