[[PageOutline]]

= !MapGuide Maestro Source Code =
This page contains instructions for downloading and compiling [wiki:maestro MapGuide Maestro].

== Prerequisites ==
The code will only compile with Microsoft Visual Studio 2005 or newer. The reason for this is the use of the System.Windows.Forms components, which are supported by Mono, but only at run time. In turn this means it can only compile on Windows. You can grab a free-of-charge copy of Visual Studio for C# by visiting [http://www.microsoft.com/express/vcsharp/ this link].

You will also need a subversion (SVN) client. I recommend the [http://tortoisesvn.net/downloads TortoiseSVN plugin] for Windows, as well as the [http://ankhsvn.open.collab.net/ AnkhSVN plugin] for Visual Studio.

== Downloading the code ==
After installing TortoisSVN, complete these steps in order:

 1. Create a new folder, called Maestro
 2. Right click the folder, and select SVN Checkout
 3. As the Repository Url, enter: http://svn.osgeo.org/mapguide/trunk/Tools/Maestro
 4. Click OK

The repository should allow anonymous checkouts, if not try using your [http://www.osgeo.org/osgeo_userid/ OSGeo ID] credentials.
If you use a command line based SVN agent, this line should do the same:
{{{
svn co http://svn.osgeo.org/mapguide/trunk/Tools/Maestro Maestro
}}}

== Compiling the code ==
Enter the folder Maestro/Maestro, and double click the file "Update DEBUG environment.bat". This will copy required files into the bin/Debug folder. Then doubleclick the solution file "OSGeo.!MapGuide.Maestro.sln". Once loaded, press F5 to run the application in debug mode.

== Getting code updates ==
From time to time, you can check for updates, by right clicking the folder and choosing SVN Update. The TortoiseSVN context menu also gives access to code change history.

== Understanding the code ==
There is documentation for the API part of the application on the [wiki:maestro/MaestroAPI MaestroAPI] page. There is currently no documents describing the !MapGuide Maestro GUI.