OpenRA - A deep dive into its source-code

Information and discussion for custom maps and mods.
Post Reply
Ronald
Posts: 37
Joined: Fri Aug 30, 2019 9:05 pm

OpenRA - A deep dive into its source-code

Post by Ronald » Wed Oct 02, 2019 9:00 am

Good-morning OpenRA Developers and Coders
I want to take a closer look inside the heart of the OpenRA game-engine.( not moding any existing OpenRA MOD)
I do not have the budget to purchase any professional software-development-tools, so 'm looking for free tools and ways to do this.

I am busy making a shopping-list of all the things I need to:
- find / download / install on my (Windows 7 professional 64 bits) computer in order to load the entire project into an IDE.
- do in order to get going with my deep-dive endeavour.

So far i've started at the OpenRA Github Wiki and found this page:
- https://github.com/OpenRA/OpenRA/blob/bleed/INSTALL.md
On this page I see mentions of the following Microsoft related software:
1 - Windows PowerShell >= 4.0 (included by default in recent Windows 10 versions)
2 - .NET Framework 4.6.1 (Developer Pack) (or via Visual Studio 2017)
3 - .NET Core 2.2 SDK (or via Visual Studio 2017)


This page tells me something about what I need to have to compile the source_code:
- https://github.com/OpenRA/OpenRA/wiki/Compiling
Here i read mentions of the following Microsoft related software:
4 - Visual Studio 2013/2012 (Community/Express).

This page on Coding Standards tells me something about a tool called
- https://github.com/OpenRA/OpenRA/wiki/Coding-Standard
5 - StyleCop - https://github.com/StyleCop/StyleCop

Along the way I've also found this non-Microsoft free C# IDE called
6 - SharpDevelop - http://www.icsharpcode.net/OpenSource/SD/Default.aspx

As possible software development environment and IDE I have found - (inside the wiki)
7a "Microsoft Visual Studio" (without exact version number "VS2013" was the lowest version I could find)
- https://visualstudio.microsoft.com/

7b "MonoDevelop" (whitout exact version numbers)
- https://www.monodevelop.com/

Outside the OpenRA Wiki i stumbled upon this opensource free C# IDE:
7c "SharpDevelop"
-http://www.icsharpcode.net/OpenSource/SD/Default.aspx


This is the information I've found so far (02-Ocotber-2019) and might be updated in the future

UPDATE-1:
I found 2 websites where one can still download ISO images of previous Visual Studio versions :-)
- https://www.ryadel.com/en/visual-studio ... installer/
- https://offlinesoftwares.com/?s=visual+studio
Last edited by Ronald on Wed Oct 02, 2019 11:45 am, edited 1 time in total.

Ronald
Posts: 37
Joined: Fri Aug 30, 2019 9:05 pm

Re: OpenRA - A deep dive into its source-code

Post by Ronald » Wed Oct 02, 2019 9:19 am

Question to complete my shopping-list:
A - Inside the Microsoft Visual Studio context
A1 - What is the minimal Visual Studio version which one must install to get going ?
A2 - Can it be done with light "free / express / community versions" ? or
A3 - Must I install the full (professional / enterprise) version ?
A4 - Where can I download reliable official older version of Visual Studio
(since Microsoft is mostly only showing their latest version of their products)


B - Inside a MonoDeveloper context
B1 - What is the minimal version one must install to get going?
B2 - Can one get started when using a "30-day trail" MonoDeveloper version only?
B3 - Where can I download older version of this software?


C - Inside the SharpDevelop (or any other free C# IDE) contexts:
C1 - Are there any other C# which can be used to edit / compile the OpenRA sourcecode (on the Windows operating system)?

Thank you for all your hints, tips and tricks to get me started and to complete this shoppinglist.

abcdefg30
Posts: 343
Joined: Mon Aug 18, 2014 6:00 pm

Re: OpenRA - A deep dive into its source-code

Post by abcdefg30 » Wed Oct 02, 2019 10:12 am

To A2/A3: VS 2019 Community is free, you just need to log in with a Microsoft or Skype account after the thirty day trial period.
For C1: You could try using Visual Studio Code with C# extensions.

penev
Posts: 24
Joined: Tue Jan 20, 2015 4:09 pm

Re: OpenRA - A deep dive into its source-code

Post by penev » Wed Oct 02, 2019 10:13 am

As for VisualStudio - the Community versions work perfectly for you. Minimal is probably 2017 by now, but you should just get 2019 anyway. Both VS 2017 Community and VS 2019 Community are easily available on Microsoft's website. You can also find older versions, but not as easily.

You don't need MonoDevelop if you're on Windows, since you already have VisualStudio. (Feel free to try it and see which is better though).
Same for SharpDevelop (I believe abcdefg30 is using that?)

User avatar
dragunoff
Posts: 6
Joined: Tue Jul 24, 2018 10:00 am

Re: OpenRA - A deep dive into its source-code

Post by dragunoff » Wed Oct 02, 2019 11:11 am

VisualStudio Community 2019 is the easiest way to get started on Windows. The setup wizard gives a lot of options to install various tools and extensions but all you need (if I am not mistaken) is ".NET desktop development" (see attached screenshot).

OpenRA has launch configurations for VisualStudio so compiling/launching/debugging can be done with a click of a button. This of course can also be done from the command line (using the make command and launch scripts included with the engine).

You may need to update PowerShell as I'm not sure what version comes with Windows 7 (see here: https://docs.microsoft.com/en-us/powers ... wershell-6 )
Attachments
vs2019-setup-openra-development.png
vs2019-setup-openra-development.png (124.08 KiB) Viewed 175 times

Ronald
Posts: 37
Joined: Fri Aug 30, 2019 9:05 pm

Re: OpenRA - A deep dive into its source-code

Post by Ronald » Thu Oct 10, 2019 7:32 pm

Update on this thread:
I've just downloaded and installed VS2015 Community edition and am now ready to take a deep dive into the OpenRa source_code :-)
VS2015_community_edition_50.jpg
VS2015_community_edition_50.jpg (235.62 KiB) Viewed 78 times
.
Thanks everyone for your help to get me to this point

User avatar
Graion Dilach
Posts: 252
Joined: Fri May 15, 2015 5:57 pm

Re: OpenRA - A deep dive into its source-code

Post by Graion Dilach » Sat Oct 12, 2019 4:35 pm

VS2015 only supports .NET Core 1.X. You'll need to bump it in the foreseeable future to atleast 2017 though.

Post Reply