Getting the source code

From ArcEmu-Wiki
(Difference between revisions)
Jump to: navigation, search
(Step 1: Installing a Subversion client: adding kde client)
 
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== ArcEmu SVN repository information ==
+
{{LanguageLinks|Getting_the_source_code|EN}}
 +
{{TocRight}}
 +
Arcemu uses a Source Control Management system called [http://git-scm.com/about GIT].<br>
 +
The role of source control management is to maintain records about the changes in the controlled/tracked files. So that we know who changed what and when, and if needed we can go back to earlier versions.<br>
 +
NOTE: This is very different from a simple file storage, therefore when you get the Arcemu source code, you don't just download some files, actually you download all versions of all files we have in our repository.
  
{{SVNADDRESS}}
 
  
 +
== ArcEmu GIT repository information ==
  
== '''Step 1:''' Installing a Subversion client ==
+
You can clone the Arcemu GIT repository using the following address git://github.com/arcemu/arcemu.git
  
To checkout (download) the source code you must first have a SVN client. Install one of the following:
 
* [http://tortoisesvn.net/ TortoiseSVN] is a GUI client for Windows. Recommended for Windows users. It integrates into Windows Explorer, however, will not do so on any server edition. It's recommended to use one of the below clients instead.
 
* [http://www.rabbitvcs.org/ RabbitVCS] is a GUI exactly like TortiseSVN but for linux Gnome desktop environments. Highly recommended if using Gnome.
 
* [http://kdesvn.alwins-world.de/ KDESVN] is a SVN GUI for KDE linux desktop environments. Suitably integrated into KDE and recommended if you are using KDE.
 
  
 +
== '''Step 1:''' Installing a GIT client ==
  
<source lang="bash">
+
On Windows you will have to work with [http://code.google.com/p/msysgit/ msysgit], read the Article about [[Installing_msysgit|installing it]].
  
/* For Ubuntu users */
+
On other platforms read the individual wiki articles about the platform you are on.
sudo apt-get install -y rabbitvcs-cli rabbitvcs-gedit rabbitvcs-nautilus rabbitvcs-core
+
  
</source>
 
Or use your package manager to install these four packages.
 
  
 +
== '''Step 2:''' Checking out (getting the source code) ==
  
* [http://scplugin.tigris.org/ SCPlugin] is a GUI client similar to TortoiseSVN for Mac OS X. Recommended for Mac OS X users.
+
Follow the instructions in [[Getting_Arcemu_with_GIT|Getting Arcemu with GIT]]
* [http://subversion.apache.org/ Subversion] Recommended for people who know how to use a console.
+
{{Note|If you copy over source code checked out on a Windows machine to any other machine running a different operating system, you will have to change line endings. Look up the package TOFRODOS or google how to do this for your operating system.}}
+
  
== '''Step 2:''' Checking out ==
 
{{Collapse|TSVNRVCS|TortoiseSVN/RabbitVCS users|
 
==== TortoiseSVN/RabbitVCS ====
 
Create a new folder, enter it then right click empty space inside and choose Checkout. Enter {{SVNADDRESS}} and leave the revision box blank (unless you want to download an older version). Press OK to checkout the source code.
 
  
[[File:TortiseSVN.jpg|Getting sourcecode via TortiseSVN|left|thumb]][[File:RabbitVCS-checkout.jpg|Getting sourcecode via RabbitVCS|right|thumb]]
+
== Next step ==
  
 
+
You're now ready to move on to the [[CMake|CMake Build System]]
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
}}
+
 
+
{{Collapse|SCP|SCPlugin users|
+
==== SCPlugin ====
+
 
+
Create a new folder wherever you want. Enter the folder, right click, select subversion then check out in a manner similar to that of TortoiseSVN.
+
}}
+
 
+
 
+
{{Collapse|SVNUSER|Default Subversion Client users|
+
==== Subversion ====
+
 
+
Use the following command and parameters:
+
svn checkout --username anonymous <repository URL from above>
+
If you are prompted for a password, simply press enter.
+
 
+
'''Subversion 1.6.5:''' You may ignore the ''--username <user-name>'' directive when attempting to anonymously log into the ArcEMU repository. When the ''--username'' directive is not used, Subversion assumes anonymous access is requested.
+
 
+
Assuming that a user wanted to get all of the code from ''{{SVNADDRESS}}'', the user would enter the following at the command prompt:
+
 
+
'''svn co {{SVNADDRESS}}'''
+
 
+
In addition, the following is also acceptable:
+
 
+
'''svn checkout {{SVNADDRESS}}'''
+
 
+
''' NO YOU DO NOT NEED THE LOCK ICONS IN THE COMMAND, THEY ARE RESULTS OF LINKING LOCKED LINKS IN MEDIAWIKI.'''
+
 
+
''Please ONLY check out of the TRUNK directory, unless you need a tag or branch.''
+
}}
+
 
+
 
+
 
+
== Additional reading ==
+
 
+
If you're having trouble performing certain actions with subversion, please read the [http://svnbook.red-bean.com/ SVN Manual] to learn how subversion works and how to use it.
+
 
+
{{Collapse|UPDATING|Updating the sourcecode|
+
== Updating the SVN ==
+
 
+
 
+
==== TortoiseSVN/RabbitVCS ====
+
 
+
Right-click your ''arcemu'' folder and click on SVN Update. When it says "At Revision: (Current revision.)" it is done updating. Click OK. After updating the SVN, you need to recompile in order to stay up-to-date. If you have any errors during this process, scrap the current folder and re-download the source (Unless you have made edits, then you are on your own!)
+
 
+
 
+
==== Command Line Interface ====
+
 
+
Change working directory to the targeted SVN folder, type '''svn update''' & recompile.
+
 
+
}}
+
 
+
== Conclusion ==
+
 
+
You're now ready to move on to Compiling: [[Compiling: Windows|Windows]], [[Compiling: Linux|Linux]], [[Compiling: FreeBSD|FreeBSD]], or [[Compiling: Mac OS X|Mac OS X]]
+
  
  
 
[[Category:Installation]]
 
[[Category:Installation]]

Latest revision as of 16:31, 15 November 2011

+/-
Main Page                   Other languages:   English  •   German   •   FrenchArcEmu Website     ArcEmu Forum     Bug Tracker

Contents


Arcemu uses a Source Control Management system called GIT.
The role of source control management is to maintain records about the changes in the controlled/tracked files. So that we know who changed what and when, and if needed we can go back to earlier versions.
NOTE: This is very different from a simple file storage, therefore when you get the Arcemu source code, you don't just download some files, actually you download all versions of all files we have in our repository.


ArcEmu GIT repository information

You can clone the Arcemu GIT repository using the following address git://github.com/arcemu/arcemu.git


Step 1: Installing a GIT client

On Windows you will have to work with msysgit, read the Article about installing it.

On other platforms read the individual wiki articles about the platform you are on.


Step 2: Checking out (getting the source code)

Follow the instructions in Getting Arcemu with GIT


Next step

You're now ready to move on to the CMake Build System

Personal tools