Difference between revisions of "Fs2 open on Linux/Acquiring the Code"

From FreeSpace Wiki
Jump to: navigation, search
m (Stable branch clarifications)
 
(8 intermediate revisions by 8 users not shown)
Line 3: Line 3:
 
CurrentPage=Acquiring the Code|Acquiring the Code|
 
CurrentPage=Acquiring the Code|Acquiring the Code|
 
PrevPage=[[Fs2_open on Linux/Installing the Development Libraries|Installing the Development Libraries]]|
 
PrevPage=[[Fs2_open on Linux/Installing the Development Libraries|Installing the Development Libraries]]|
−
NextPage=[[Fs2_open on Linux/Checkout Script|Checkout Script]]}}
+
NextPage=[[Fs2 open on Linux/Pre-Compile Configuration|Pre-Compile Configuration]]}}
 
<p></p>
 
<p></p>
 
{{Note| This step is only for those who want the bleeding-edge source code to compile on their own. You can skip this if you intend to use a provided binary  
 
{{Note| This step is only for those who want the bleeding-edge source code to compile on their own. You can skip this if you intend to use a provided binary  
 
executable.}}
 
executable.}}
−
Before you begin, make sure you have write permissions on your current working directory. $HOME/$USER is a pretty safe bet. I recommend that you create a permanent /$HOME/$USER/src directory from which you run the CVS command, this way CVS will only update the files changed the next time you download the source and it's always nice to have things organized. Make sure you have CVS installed on your system. See the [[Fs2_open_on_Linux/Installing CVS|Installing CVS]] chapter on installing CVS.
 
  
−
Now get the source. Run from a terminal:
+
This guide will walk the user through on how to acquire and download the source code locally to their machine.
−
$ cvs -d:pserver:anonymous:[email protected]:/home/fs2source/cvsroot login
+
 
−
This tells the CVS tool to first use a password file for authentication (pserver), that you are user "anonymous" with the password "anonymous" who wants to access warpcore.org's CVS repository "/home/fs2source/cvsroot" and login.
+
<h1>For New Users</h1>
−
<br><br>
+
 
−
Next, get the code from the server we just connected to, either from the development branch:
+
This section of the code will explain on how to acquire the source code and download it to your system. For the sake of simplicity to new users, I am using Visual Studio Code to demonstrate on how to clone the source code.
−
  $ cvs -z3 -d:pserver:anonymous@warpcore.org:/home/fs2source/cvsroot co fs2_open
+
 
−
..or from the "stable branch":
+
<h2>📖 Prerequisites</h2>
−
  $ cvs -z3 -d:pserver:[email protected]:/home/fs2source/cvsroot co -r fs2_open_3_6_9 fs2_open
+
 
−
{{Note| For just playing the game it is usually best to get the code from the "stable branch", as it will generally be more.. stable.}}
+
The following accounts will be required to get started with acquiring and downloading the code.
−
Both of the last two commands tell the CVS server that we want to checkout (co) the CVS module "fs2_open". Either from the default branch (the development branch - HEAD) or from the branch determined by the "-r" option. In the latter checkout we specified the branch "fs2_open_3_6_9" (implying the release 3.6.9 of FS2 Open), but this naming is only due to "historical reasons" - release specific branches don't exist at the time being, we will get the most recent stable code available by using that checkout.  
+
 
−
<br>
+
<ol>
 +
<li>git program</li>
 +
<li>GitHub Account</li>
 +
<li>Visual Studio Code</li>
 +
</ol>
 +
 
 +
<h3>ℹ️ INFORMATION</h3>
 +
 
 +
You will need to sign in to the GitHub account within Visual Studio Code to download the code seamlessly.
 +
 
 +
<h2>✅ Forking And Downloading The Code</h2>
 +
 
 +
It is usually a good practice to fork the code locally to your GitHub account. This will help in opening Pull Requests (PRs). On the FreeSpace Open GitHub page, please fork the code by pressing the fork button and following the instructions on the page.
 +
 
 +
Once the code has been forked, open the Visual Studio Code editor. In the editor, open the command palette (CTRL + SHIFT + P) and type
 +
 
 +
  $ git clone (recursive)
 +
 
 +
A window shall pop up, asking where the files need to be cloned to. Please choose a location where the user has write access to, preferably under $HOME/$USER. For the sake of simplicity, I will be using
 +
 
 +
$HOME/$USER/Projects
 +
 
 +
The path to the FSO code should look like
 +
 
 +
  $HOME/$USER/Projects/fs2open.github.com
 +
 
 +
If everything is done correctly, you'll be able to see the files in the Explorer tab in Visual Studio Code.
 +
 
 +
<h1>For Advanced Users</h1>
 +
 
 +
This section is for users who are already familiar with the git commands.
 +
 
 +
<h2>✅ Download The Repository Using Git</h2>
 +
 
 +
This requires the user to have downloaded and configured git on their system. Please see [[Fs2_open_on_Linux/Installing Git|Installing Git]] in case git has not been downloaded and configured.
 +
 
 +
To download the repository using git, the following command needs to be entered in a terminal:
 +
 
 +
$ git clone --recurse-submodules https://github.com/scp-fs2open/fs2open.github.com.git
 +
 
 +
Please be advised that the repository needs to be cloned to a location with read and write access to the user. A good location would be in
 +
 
 +
$HOME/$USER
 +
 
 +
<hr>
 +
 
 +
<h1>⚠️ ATTENTION</h1>
 +
<ul>
 +
<li>Please clone the repository recursively. If not cloned recursively, the code may not compile on your machine.</li>
 +
<li>In case you have cloned the code non-recursively, please remove the project directory and clone it recursively.</li>
 +
</ul>
 +
 
 +
<BR>
 +
 
 +
Once done, congratulations! You have the source code ready to be built!
 +
 
 +
[[Category:FreeSpace Open on Linux|Acquiring the Code]]

Latest revision as of 06:05, 22 April 2025

« Installing the Development Libraries The fs2_open on Linux Guide
Acquiring the Code 		Pre-Compile Configuration »

Note: This step is only for those who want the bleeding-edge source code to compile on their own. You can skip this if you intend to use a provided binary executable.

This guide will walk the user through on how to acquire and download the source code locally to their machine.

For New Users

This section of the code will explain on how to acquire the source code and download it to your system. For the sake of simplicity to new users, I am using Visual Studio Code to demonstrate on how to clone the source code.

📖 Prerequisites

The following accounts will be required to get started with acquiring and downloading the code.

  1. git program
  2. GitHub Account
  3. Visual Studio Code

ℹ️ INFORMATION

You will need to sign in to the GitHub account within Visual Studio Code to download the code seamlessly.

✅ Forking And Downloading The Code

It is usually a good practice to fork the code locally to your GitHub account. This will help in opening Pull Requests (PRs). On the FreeSpace Open GitHub page, please fork the code by pressing the fork button and following the instructions on the page.

Once the code has been forked, open the Visual Studio Code editor. In the editor, open the command palette (CTRL + SHIFT + P) and type 

$ git clone (recursive)

A window shall pop up, asking where the files need to be cloned to. Please choose a location where the user has write access to, preferably under $HOME/$USER. For the sake of simplicity, I will be using 

$HOME/$USER/Projects

The path to the FSO code should look like 

$HOME/$USER/Projects/fs2open.github.com

If everything is done correctly, you'll be able to see the files in the Explorer tab in Visual Studio Code.

For Advanced Users

This section is for users who are already familiar with the git commands.

✅ Download The Repository Using Git

This requires the user to have downloaded and configured git on their system. Please see Installing Git in case git has not been downloaded and configured.

To download the repository using git, the following command needs to be entered in a terminal: 

$ git clone --recurse-submodules https://github.com/scp-fs2open/fs2open.github.com.git

Please be advised that the repository needs to be cloned to a location with read and write access to the user. A good location would be in 

$HOME/$USER

⚠️ ATTENTION

  • Please clone the repository recursively. If not cloned recursively, the code may not compile on your machine.
  • In case you have cloned the code non-recursively, please remove the project directory and clone it recursively.


Once done, congratulations! You have the source code ready to be built!

Retrieved from "https://wiki.hard-light.net/index.php?title=Fs2_open_on_Linux/Acquiring_the_Code&oldid=66122"