Getting the source
- 1 Installing Git
- 2 Downloading the source
- 3 Keeping your copy of the source up-to-date
- 4 Compiling
If you already have Git installed, you can skip this step.
Mac OS X
Apple has included Git with Xcode since version 4. You may download Xcode from Apple's developer website. Please note that while XCode 4 was available for a very brief time for 32-bit and Snow Leopard users for a small price ($5 from the Mac App Store), this is no longer the case; it is now free, but available only to 64-bit Lion users. Snow Leopard (10.6) users and prior may now only use XCode 3, which does not include Git. If you are one of these users, you may acquire a copy of Git from its site. A selection of GUIs for Git is also available.
Debian & Ubuntu
Install Git using the package manager:
$ sudo apt-get install git
The ebuilds for Unvanquished (games-fps/unvanquished) and the assets (games-fps/unvanquished-data) are available from the hasufell overlay. If you don't have layman installed, you can install it with
$ emerge layman
Then, adding the overlay and installing should be trivial.
$ layman -a hasufell $ emerge unvanquished
See the entry on bugs.gentoo.org for additional comments about the ebuilds.
Downloading the source
The following commands will work on any platform.
$ git clone https://github.com/Unvanquished/Unvanquished.git
This will create a directory called Unvanquished.
$ git checkout v0.37.0
To see the list of tags available to check out,
$ git tag
will produce a list.
Please see the command line instructions.
Mac OS X
Open a Terminal (
/Applications/Utilities/Terminal) and follow the command line instructions.
- Start Xcode.
- Open the Organizer window (Window → Organizer or ShiftCommand ⌘2)
- Hit the "Repositories" button on the top bar.
- Hit the "+" button in the lower-left corner, and choose "Checkout or Clone Repository…".
- In the rollout sheet that appears, enter
https://github.com/Unvanquished/Unvanquished.gitinto the "Location" field, and hit "Next".
- Enter "Unvanquished" into the "Name" field, ensure that the "Type" combo box is set to "Git", and hit "Clone".
- You will be prompted where to save the repository. Choose a location and hit "Clone".
- Make and enter a new folder to store the source code in
- Right click the inside of the folder → Git Clone...
- In the Url textbox enter:
- Hit OK.
Open the MsysGit terminal and and follow the command line instructions.
Keeping your copy of the source up-to-date
For more information on using git, an excellent resource is the official git book, available to read online for free.
- Right-click somewhere in the source directory, and choose "Git Sync".
Command-line (All platforms)
To pull (i.e., fetch and merge) changes made since you checked out the source—that is, to update your working copy to match the current state of the official repository—you (typically) need only run one command:
$ git pull origin master
After getting the source code, you can compile it.