Converting Topspeed Project Files to MSBuild projects

Top  Previous  Next

The Clarion Win32/Clarion# project system has been updated and upgraded to use the MSBuild project engine. MSBuild is the new extensible, XML-based build engine that ships with the .NET Framework 2.0 and higher. MSBuild simplifies the process of creating and maintaining build scripts, and formalizes the steps required to institute a formal build process.

Legacy (Topspeed) Projects can be accessed (opened) by the C7 Project System, and are auto-converted to the MS-Build project format.

The project file auto-converter cannot convert all TopSpeed project commands into MSBuild project commands. If you want to convert complex project files, some manual conversion may be necessary.

The first step is a basic knowledge of MSBuild project files.

See MS-Build Documentation Web Site for complete documentation on MSBuild.

In many cases, a project file may not need to be converted. You can include a legacy project file via the "Projects to include" option in the C7 Project System.

To do this:


From the Start Page, select the Projects option and then click on the New Project button.


In the New Project window, select the New Project Category to be Clarion for Windows and use the Win32 DLL Quick Start.


Set the Location to the location of your Topspeed prj file and the project name to the appropriate target name, and uncheck Auto create project subdir.


From the Project Tree, right-click on Projects to include and select Add Project to Include.


Change the project Files of type to Legacy Clarion Project Files.


Select the target Topspeed project file.

Now you will have a C7 project that uses your special project file.

To include any needed sources into the project, you will have to add the *.CLW files manually, and for each file set the properties of the file so that the Build action is set to None.

Many legacy project file commands are supported, but one command in the legacy project files is not supported in the C7 project system. This statement is #prompt.

All #prompt project statements can be replaced with the following:


#file adderrors <message>


These messages will then be reported as errors and appear as errors in the error pad within the IDE or as error messages on the command line if using MSBuild.exe or in the appropriate error place if using any other MSBuild compliant tool to build the project.