November 17, 2016 at 8:56 pm #5169
This post will contain various information about contributing to Monkey 2, with various subjects such as:
- downloading from source
- building it from source
- download latest changes from git
Enter this link to one of the git clients: https://github.com/blitz-research/monkey2.git
- Github Desktop
(See Nerobot’s notes below for more information)
- Alternatively, just download the zip repository from github without any client.
- Let’s assume you have downloaded the repository somewhere e.g. D:\Programming\monkey2\ .
- Now make sure you have connected the g++ compiler to Monkey2, there are various alternative ways to do that, however since you are involved directly with source (git will track any changes you do) is recommended not to mutate the monkey2 files.
- Have the g++.exe accessible from the PATH environment variable. If you are on Windows and you want to use MinGW make sure you get the specific recommended toolchain mentioned here. http://monkeycoder.co.nz/monkey2-files
- Now once you are set you can type g++ in command prompt and see compiler output. Head over to monkey2\scripts and run this shell file: rebuildted2go.bat (or .sh for mac or linux) and wait about 25 minutes to let everything built from scratch which includes: transpiler (the compiler 🙂 ), modules, ide, etc…
Download Latest Changes From git
November 19, 2016 at 6:00 am #5230
- Github Desktop
Having selected the branch you are interested in, hit Fetch Origin and wait a few seconds to let it download.
For more information: https://services.github.com/on-demand/github-desktop/push-with-github-desktop
Press the pull button from the main toolbar
(see Nerobot’s notes for more details)
I use SourceTree for git. I prefer gui instead of command line. 🙂
May post short ‘howto’ if someone is interested in.November 19, 2016 at 7:45 pm #5252
It will be a good idea, won’t hurt to post it. Can you make a huge image (i.e. 1500×1500) that explains it?
Generally I use “gihub for windows” but I consider switching to sourcetree, lots of people like this one.November 20, 2016 at 9:57 pm #5282November 23, 2016 at 10:01 am #5374
There is a short article “How to use SourceTree app for managing git repository”.
Install & Account
Install app from here: https://www.sourcetreeapp.com
Enter your git account info to get access to github (there is a prompt for first start).
Start app and press Clone/Add (see st-1.png).
In clone dialog (see st-2.png):
- paste monkey2 repository url,
- select folder to copy into (if folder exists it must be empty),
- enter name for repo (it’s bookmark for soursetree),
- and press Clone button.
- wait loading
After loading you will stay on default branch – master.
To use develop or any other branch, you need to checkout it.
- Look at Remotes list below master branch.
- Right-click on remotes::origin::develop and choose “Checkout origin/develop…” and press Ok.
- Ok, now you stay on develop branch (bold font).
To change local branch simply double-click on one of them.
To grab new stuff – just press Pull button on main toolbar.
Pull and run rebuildall script if needed.
Any questions? 🙂
Attachments:November 27, 2016 at 12:47 pm #5457
Nice one, thanks.November 28, 2017 at 7:50 am #12010
There is a cool feature in SourceTree App named “Log selected” – it shows us all changes for selected files.
For example, I want to inspect latest changes in MainWindow.monkey2 file.
Look at screenshots.
Attachments:January 13, 2018 at 12:32 pm #12846
I did an update to the original first post to get rid of the directions regarding the raw git command set, since GUI applications are much more useful and the process of working repositories is streamlined. Also the title of the post is renamed to include various tips and tricks generally regarding to building and contributing to monkey2.
One upcoming post would be to mention ways about compiling monkey2 with MSVC2017, if anyone has tried it can do a post here. 🙂
Another one is to clone and sync the repository from github-to-github (without involving your client).
You must be logged in to reply to this topic.