Difference between revisions of "MG/Getting The Code"
(simplified clone) |
m (git clone --resursive is depricated) |
||
| (7 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
| − | [[MegaGlest]] has | + | [[MegaGlest]] has switched to git for managing the game's source code and data (the svn repo is no longer active). |
| − | == | + | ==Linux quick setup== |
| − | + | Do this ( download size is ~600MB ): | |
| − | ====Linux | + | sudo apt-get update && sudo apt-get -y install git |
| − | + | git clone --recurse-submodules https://github.com/MegaGlest/megaglest-source.git | |
| + | cd megaglest-source/mk/linux/ | ||
| + | sudo ./setupBuildDeps.sh | ||
| + | ./build-mg.sh | ||
| + | |||
| + | launch with: | ||
| + | ./megaglest | ||
| + | |||
| + | ==Choose and install a git client== | ||
| + | The MegaGlest source is stored in a Git repository (versions prior to 3.9.0 are in a different - SVN repository, however), and requires a Git client to download. Clients exist for all major operating systems. | ||
| + | |||
| + | ===Linux=== | ||
| + | On Debian GNU/Linux based distributions this is as easy as: | ||
sudo apt-get update && sudo apt-get install git | sudo apt-get update && sudo apt-get install git | ||
| − | On other distributions, the process will be quite similar but you will need to use the package management tools available there. | + | On other distributions, the process will be quite similar but you will need to use the package management tools available there and you should look for "git" or "git-core" package. |
| − | + | ===Windows=== | |
| − | Download [http://git-scm.com/ | + | Download [http://git-scm.com/download/win >>GIT<<] and install it ('''Important: '''On install-options choose "Run Git from Windows Command Prompt".), then run <tt>git-bash.bat</tt> in the installation folder to start the Git command line. |
| + | |||
| + | For those with a preference for a client with a graphical interface, then e.g. [http://code.google.com/p/tortoisegit/ TortoiseGit] exists for that. | ||
==Check out the source code== | ==Check out the source code== | ||
===Cloning the sources=== | ===Cloning the sources=== | ||
| − | + | '''''Prior to running these commands, you need to navigate to the directory (folder) you wish to place the MegaGlest source directory in.''''' | |
| − | + | ||
| − | git clone -- | + | git clone --recurse-submodules <nowiki>https://github.com/MegaGlest/megaglest-source.git</nowiki> |
| + | |||
| + | ===Popular mistakes=== | ||
| + | If you've not read this guide before clone then you probably made a quite popular mistake - "cloned repository without data (submodules)", then you should do this: | ||
cd megaglest-source | cd megaglest-source | ||
git submodule update --init --recursive | git submodule update --init --recursive | ||
| + | If you still are not sure that you have downloaded full working source then you can compare your source directory with the [[MG/Project Structure|Project Structure]]. | ||
| − | === | + | ===After the cloning=== |
| − | + | If you want start work on changes in data submodule (or any other) then '''before starting''' you should first checkout HEAD of desirable branch e.g. "develop". In most situations it does not apply to regular users/testers/gamers. | |
| − | |||
cd megaglest-source | cd megaglest-source | ||
| − | |||
| − | |||
cd data/glest_game | cd data/glest_game | ||
| − | git checkout | + | git checkout <branch> |
cd ../.. | cd ../.. | ||
| + | |||
| + | ==Update the source code== | ||
| + | When some time has elapsed after the "clone" and you again want to test the HEAD of the game then you should update the source code. | ||
| + | |||
| + | First choose the branch, e.g. "develop": | ||
| + | git checkout <branch> | ||
| + | If you’re not actively working on the source and submodules (you are a tester/gamer), then the simplest and most universal way to update is: | ||
| + | git pull && git submodule update --init --recursive | ||
| + | in the other case you should read more [https://github.com/MegaGlest/megaglest-source/wiki/Git-How-To advanced git tutorial] intended for developers. | ||
==Tags and branches== | ==Tags and branches== | ||
| − | + | Each release is 'tagged' and resides as '''tags''', so if you wanted an older release you would check out something below instead. Check [https://github.com/MegaGlest/megaglest-source/releases here] to see which ones are available. | |
| − | Branches are created | + | Branches are created for separate larger changes from active / stable development, so check with your [https://github.com/MegaGlest/megaglest-source/branches web browser] which ones are available if this is your intention. |
==See also== | ==See also== | ||
*[[MG/Project Structure|Project Structure]] | *[[MG/Project Structure|Project Structure]] | ||
| + | *[https://github.com/MegaGlest/megaglest-source/wiki/Git-How-To Git-How-To] | ||
| + | |||
[[Category:MG]] | [[Category:MG]] | ||
| + | [[Category:Development]] | ||
Latest revision as of 16:14, 11 October 2022
MegaGlest has switched to git for managing the game's source code and data (the svn repo is no longer active).
Linux quick setup[edit]
Do this ( download size is ~600MB ):
sudo apt-get update && sudo apt-get -y install git git clone --recurse-submodules https://github.com/MegaGlest/megaglest-source.git cd megaglest-source/mk/linux/ sudo ./setupBuildDeps.sh ./build-mg.sh
launch with:
./megaglest
Choose and install a git client[edit]
The MegaGlest source is stored in a Git repository (versions prior to 3.9.0 are in a different - SVN repository, however), and requires a Git client to download. Clients exist for all major operating systems.
Linux[edit]
On Debian GNU/Linux based distributions this is as easy as:
sudo apt-get update && sudo apt-get install git
On other distributions, the process will be quite similar but you will need to use the package management tools available there and you should look for "git" or "git-core" package.
Windows[edit]
Download >>GIT<< and install it (Important: On install-options choose "Run Git from Windows Command Prompt".), then run git-bash.bat in the installation folder to start the Git command line.
For those with a preference for a client with a graphical interface, then e.g. TortoiseGit exists for that.
Check out the source code[edit]
Cloning the sources[edit]
Prior to running these commands, you need to navigate to the directory (folder) you wish to place the MegaGlest source directory in.
git clone --recurse-submodules https://github.com/MegaGlest/megaglest-source.git
Popular mistakes[edit]
If you've not read this guide before clone then you probably made a quite popular mistake - "cloned repository without data (submodules)", then you should do this:
cd megaglest-source git submodule update --init --recursive
If you still are not sure that you have downloaded full working source then you can compare your source directory with the Project Structure.
After the cloning[edit]
If you want start work on changes in data submodule (or any other) then before starting you should first checkout HEAD of desirable branch e.g. "develop". In most situations it does not apply to regular users/testers/gamers.
cd megaglest-source cd data/glest_game git checkout <branch> cd ../..
Update the source code[edit]
When some time has elapsed after the "clone" and you again want to test the HEAD of the game then you should update the source code.
First choose the branch, e.g. "develop":
git checkout <branch>
If you’re not actively working on the source and submodules (you are a tester/gamer), then the simplest and most universal way to update is:
git pull && git submodule update --init --recursive
in the other case you should read more advanced git tutorial intended for developers.
Tags and branches[edit]
Each release is 'tagged' and resides as tags, so if you wanted an older release you would check out something below instead. Check here to see which ones are available.
Branches are created for separate larger changes from active / stable development, so check with your web browser which ones are available if this is your intention.