Getting the source

From Unvanquished
Revision as of 19:11, 27 May 2012 by Velociostrich (Talk | contribs) (Mac OS X: Add instruction to acquire git if XCode 4 is not available)

Jump to: navigation, search

Overview

Installing Git

If you already have Git installed, you can skip this step.

Windows

Windows users can acquire git from the MSysGit project. If you would prefer a graphical front-end, there is TortoiseGit, but regardless MSysGit must be installed.

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 their site. A selection of GUIs for git is also available.

Linux

Debian & Ubuntu

Install git using the package manager:

$ sudo apt-get install git

Downloading the source

The Unvanquished source code is hosted on GitHub. You can either download a snapshot of the source code using the "ZIP" link, or you can use git to clone the repository.

Linux

Use git on the command line:

$ git clone https://github.com/Unvanquished/Unvanquished.git

This will create a directory called Unvanquished in your home folder.

Mac OS X

Command Line

Acquiring the source code using the command line is the same as on Linux. Just open a Terminal (/Applications/Utilities/Terminal) window and clone the source code like so:

$ git clone https://github.com/Unvanquished/Unvanquished.git

Xcode 4

  1. Start Xcode.
  2. Open the Organizer window (Window → Organizer or Shift+Command ⌘+2)
  3. Click the "Repositories" button on the top bar.
  4. Click the "+" button in the lower-left corner, and choose "Checkout or Clone Repository…".
  5. In the rollout sheet that appears, enter https://github.com/Unvanquished/Unvanquished.git into the "Location" field, and click "Next".
  6. Enter "Unvanquished" into the "Name" field, ensure that the "Type" combo box is set to "Git", and click "Clone".
  7. You will be prompted where to save the repository. Choose a location and click "Clone".

Windows

TortoiseGIT

  1. Make and enter a new folder to store the source code in
  2. Right click the inside of the folder → Git Clone...
  3. In the Url textbox enter: https://github.com/Unvanquished/Unvanquished.git
  4. Click ok.

Command Line

Open the MsysGit terminal and type:

$ git clone https://github.com/Unvanquished/Unvanquished.git

Compiling

After getting the source code, you can compile it.