Clarion Community Help

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
| **Navigation:**  [[common ide faqs.htm|IDE FAQs]] > Project System >====== Converting Topspeed Project Files to MSBuild projects ====== | [[project system quick start.htm|{{btn_prev_n.gif|Previous page}}]][[common ide faqs.htm|{{btn_home_n.gif|Return to chapter overview}}]][[clarion 7 faqs.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

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 [[http://msdn.microsoft.com/en-us/library/0k6kkbsd.aspx|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:

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

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

3.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**.

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

5.Change the project **Files of type** to //Legacy Clarion Project Files//.

6.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.