Member Controls

F.A.Q. > Getting the SimPE Source
quaxiLink to postposted: Sun Sep 24, 2006 9:42 am
Avator for quaxi

Member since:
 2006-04-28
Posts:
 3154
This small Tutorial is explaining what you have to do in order to download the complete SimPE sourcecode.

The most recent source is available from a SVN repository hosted on Sourceforge. SVN is something like CVS, but more sophisticated. The latest SimPE is stored at https://simpe.svn.sourceforge.net/svnroot/simpe/trunk/fullsimpe . The following Instructions explain how to get the sources from this location using TortoiseSVN

1. Getting an SVN Client.
First you need to have an SVN Client installed on your. I am using Tortoise SVN, as it simply hooks into the Windows Explorer, extending it's context menus with SVN specific commands.

You can download Tortoise SVN from http://tortoisesvn.net/downloads . Just get theoffered msi file and install it like any other Windows application.

2. Creating a folder for the local copy of the repository

This is a very simple step, as you just need to create a folder somewhere on your harddrive. This folder will contain all Files needed to compile SimPE after you did check out  the files from the SVN repository.

3. Checking out the sources
The last step is to get a local copy of the source files from the repository (aka. checking out the files Smiley).

The checkout dialog The checkout dialog

To do that, right click on the folder you just created. If Tortoise SVN was installed correct, you will notice that you have some new items in the poped up context menu. Select the Option SVN Checkout... to get your local copy. This will open the checkout Dialog.

The Tortoise SVN context menu The Tortoise SVN context menu

The URL of the latest  SimPE sources is (as stated above) https://simpe.svn.sourceforge.net/svnroot/simpe/trunk/fullsimpe/ , but you can download different versions (like the .NET 1.1 branch from the SVN too. Just have a look at the online repository at http://svn.sourceforge.net/viewvc/simpe/ to get the folders leading to the version you'd like to check out.

Most people certainly want to get the latest sources, so please put https://simpe.svn.sourceforge.net/svnroot/simpe/trunk/fullsimpe/ into the URL of repository textbox.

The text in the Checkout Directory textbox should point to the folder you just right clicked on, which is the one, where the sources will get downloaded to. Most of the time you should not touch this setting or any others (besides the URL of repository of course).

If you click on OK, the download of the sources will start.

4. Compile for the first time
After you downloaded the complete source, you can start compiling SimPE. You need to have the free Development Tool Visual Studio 2005 C# Express or the regular Visual Studio 2005 installed on your System to compile SimPE.

You may get some errors stating that referenced dlls were not found. All that are needed are available from any SimPE binary installation, and should also be available in the main Folder of the repository (the one you created in the second step).
You can solve the problems by deleting the missing reference from the references Section in the Project Explorer in VS 2005 (They are usually marked with an exclamation mark). Then right click on the References section of the project and select the Add... menu item.

In the Dialog that pops up now, select the Browse tab, and find the dll (either in a SimPE instalation folder, in the root folder (as created in Step 2) of the repository, or it's __Release Subfolder). Then simply hit OK, and VS 2005 knows the location of the dll on your system.

5. Getting Updates
You probably want to keep the checkedout sources (or parts of it) up to date. That means, if I checked in bugfixes or new code, you probably want to have that in your local copy to.
Simply right click on the root repository folder or any folder/file inside the repository, and select SVN update... from the context menu. That should start another download, updating the selected folders/and files with the versions stored in the repository.


That's it for the moment, hope this get's everyone started with the SimPE sources.
quaxiLink to postposted: Wed Nov 01, 2006 11:51 am
Avator for quaxi

Member since:
 2006-04-28
Posts:
 3154
When you try to start SimPE from within Visual Studio 2005, you might get the following Error:

A project with an Output Type of Class Library cannot be started directly.

In order to debug this project, add an executable project to this solutuion which references the library project. Set the executable project as the startup project.


This means, you have to set the correct startup project. In order to do so, open up the Project explorer, and find the SimPE Main project.
Right click on it, and select "Set as Start Project". The name of the project should now show up in bold. When you run the solution from Visual Studio, the SimPE Gui will be started.
quaxiLink to postposted: Thu Nov 30, 2006 9:42 am
Avator for quaxi

Member since:
 2006-04-28
Posts:
 3154
We were having problems with different language installations of the .NET Framework and SimPE. Thos problems manifest by an error like
Invalid Resx File. The Value Strg is not known.

This is why I switch my Framework over to the english Version, which means, that compiling it with the German localized Version of .NET results in a similar Error now.

The only solution I know of, is deinstalling the German .NET Localization from "Control panel/Software".
XanathonLink to postposted: Thu Nov 30, 2006 10:08 am

Member since:
 2005-03-06
Posts:
 813
What possible impact will that have on other applications running under .NET 2.0 on computers running a german Win XP?
quaxiLink to postposted: Thu Nov 30, 2006 10:52 am
Avator for quaxi

Member since:
 2006-04-28
Posts:
 3154
None at all. This problem is only there when you compile the sources. Not on Runtime.

The problem is not the german Version of Windows, it is the localized Version of .NET. When you install .NET in germany, you automatically get a second software installed, which contains the german strings for the frameworks messages and stuff. This additional software has to be deinstalled in order to compile (not run) SimPE, becuase MS choos to translate the names of some Enums too (Strg vs. Ctrl), and the english Version does not recognize the german Strings in the resx files, while the german version does not recognize Ctrl.


viewthread, 0, 0, Getting-the-SimPE-Source