Ingredients

  • Visual Studio is essential.
  • Git has been built into visual studio IDE from 2013 update 1. So not necessary to install git independently. But it is necessary to have some basic understanding of git.
  • Github account to clone the repository to local machines. Github is a great platform that host all the repository for many projects. Happy Git and Github for the useR maybe a good starting point to learn how to use git and github, although it is a bit R-centered.

How to clone the ApsimX repository

  1. Copy the repoitory address from the Github repository page.

  1. Open Visual Studio and click the Clone or check out code tab on the welcome panel.

  1. Paste the repository address to the Repository location and modify the Local path if needed.

How to build

  1. Once the repository has been cloned to the local storage. Double click on the bold text located under the Local Git Repositories.

  1. The folder will have a .sln file to compile the downloaded APSIM Next Generation. Double click on ApsimX.sln to open the solution.

  1. The shortcut key to build the solution is F6. Alternatively, the command can be found under the Build tag.

Easy as that.

PS:

There are some situations that we might need to access a previous version of APSIM next generation. The strategy here is use git reset/rebase to go back in time. It can be troublesome becasue some older versions require the support from the APSIM.Shared. To compile APSIM.Shared, the same logic applied.