Porting Classic DSC Project to Eclipse Project

The CodeWarrior Classic Project Importer feature in Eclipse helps automate the conversion of a legacy DSC project to an Eclipse CDT project.

This feature lets you:

select the classic CodeWarrior project,
set targets to import,
configure source trees and shielded folders,
edit access paths for each target,
list files that are not found in the previous settings,
specify the new Eclipse project name and location,
list warning or errors in the conversion process, and
open the newly created Eclipse project.

Note: Before starting the process ensure that the CodeWarrior DSC project you want to import has all of its files, such as the source, linker command, and settings file.

To port a classic DSC project, perform these steps.

Select File > Import from the Workbench menu bar.
The Import dialog box appears.
Expand the CodeWarrior tree control and select CodeWarrior Classic Project.
Figure 1. Import Dialog Box
Click Next.
The first page of the CodeWarrior Classic Project importer wizard appears.
Enter the path and name of the classic CodeWarrior project file to import in the Project file text box. Alternatively, click Browse and use the Select The CodeWarrior Project File to Import dialog box to select the project file to import.
Tip: The project file has an extension of .mcp. Select the .mcp file.

Figure 2. Select The CodeWarrior Project File to Import Dialog Box

The path of the project file to import appears in the Project file text box.

Figure 3. Path of CodeWarrior Project File to Import
Click Next.
The Options page of the CodeWarrior Classic Project Importer wizard appears.
Select the build target that uses the DSC toolchain you want the generated Eclipse project to use, from the Toolchain Target list box.
Note: The toolchain target linker in the classic project defines the project type of the generated Eclipse project, including the toolchain and build settings.

The build targets table displays all the targets discovered in the project file and is used to generate equivalent Eclipse build configurations.
You can import each build target in the classic CodeWarrior project based upon predefined configurations of the toolchain.
If you want to import sub-projects included in the classic CodeWarrior project, check the Recursively Import Sub-Projects checkbox.
The CodeWarrior Classic Project wizard imports the sub-projects with the main project.

Note: The CodeWarrior Classic Project wizard will copy only those files that are displayed in the CodeWarrior Projects view. The wizard will not import a file if it is not displayed or does not include project information.
Click Advanced.
The Advanced Options dialog box appears.

WARNING: Checking the Copy files into the new project checkbox may cause build errors.
Check the Copy files into the new project checkbox.
Click OK to close the dialog box.

Click Next.

The Globals page of the CodeWarrior Classic Project wizard appears. This page lets you edit global settings that can effect how the project's build options are imported.

The table below lists the options on the CodeWarrior Classic Project Importer - Globals page.

Table 1. CodeWarrior Project Importer - Globals Page Options
Options	Description
Shielded Folder List	Lists the concealed contents of folders from the IDE's search operations during a build. This was done by placing special characters in the directory name. For example, sample code was concealed in a (CodeWarrior Examples) folder. The Shielded Folder List table lists these options: \(.\) CVS .[ _]Data You use the Add, Delete, and Clear buttons to modify the information in this list. The table below lists these buttons with their descriptions.
Sources	Specifies the location of the source trees. If an access path is defined relative to a source tree, the source tree should be listed in this table. The {Project} source tree is defined automatically. The Sources Trees table lists these options: Name - Lists the source name. For example: Compiler. Compiler - Lists the path source name. For example: `<CW Install>/MCU.` You use the Add, Delete, and Clear buttons to modify the information in this list. The table below lists these buttons with their descriptions.

Table 2. CodeWarrior Project Importer - Globals Page Buttons
Button	Description
Add	Add a new entry to the list.
Delete	Deletes the selected item.
Clear	Clears the entire list.

To add a new expression to the Shielded Folder List table, perform these steps.
1. Click Add.
  (regular_expression) appears in the shielded folder list.
2. Double-click (regular_expression) and type the required expression.
  The new expression appears in shielded folder list.
To delete an existing expression from the Shielded Folder List table, select the expression and click Delete.
The selected expression is deleted from the shielded folder list.
To remove all the existing expressions from the Shielded Folder List table, click Clear.
All the expressions are deleted from the shielded folder list.
To add a new source to the Source Trees table, perform these steps.
1. Click Add.
  SourceName appears in the source trees list.
2. Double-click SourceName.
  The Edit Table Values dialog box appears.
3. In the Name text box, enter the source name.
4. In the Path text box, enter the path of the new source. Alternatively, click Browse and use the Browse For Folder dialog box and navigate to the required source.
5. Click OK.
  The new source appears in Source Trees list.

Click Next.

The CodeWarrior Project Importer - Access Paths page appears.

Note: Access paths are directory paths the CodeWarrior tools use to search for libraries, runtime support files, and other object files.

The table below lists the options on the CodeWarrior Project Importer - Access Paths page.

Table 3. CodeWarrior Project Importer - Access Paths Page
Option	Description
Target	Lets you select the build target whose access paths you want to modify.
Access Path Table	Lists the access paths used by the build target selected in the Build Target list box. Each row lists: Path - Directory path. Recursive - Whether the path is searched recursively. For example: `false` or `true.` Type - Specify path to be searched. For example: `user` or `system.` Error - Unresolved access paths, marked as "X", if any. You use the Add, Delete, and Clear buttons to modify the information in this list. The table below lists these buttons with their descriptions.

Table 4. CodeWarrior Project Importer - Access Paths Page Buttons
Button	Description
Add	Add a new directory path to the list.
Delete	Deletes the selected directory path from the list.
Clear	Clears the entire list.

To add a new directory path to list, perform these steps.
1. Click Add.
  (C:\SourcePath) appears in the Path list.
2. Double-click (C:\SourcePath).
  The Edit Table Values dialog box appears.
3. In the Path text box, enter the directory path. Alternatively, click Browse and use the Browse For Folder dialog box and navigate to the required source.
4. From the Recursive list box, select false or true.
5. From the Type list box, select user or system.
6. Click OK.
  The new access path appears in table.
Click Next.
The CodeWarrior Project Importer - Problems page appears. This page displays the project files that the wizard could not locate. You can use the Build Target list box to select another build target and view the missing files.
To locate the missing files, perform these steps.
1. Click Back to adjust the settings in the Globals and Access Paths pages so that the wizard can locate the missing files.
2. Repeat till you narrow down the number of missing files.
  Note: Some old files do not work with the <target> implementation, there will be some files missing.
Click Next .
The CodeWarrior Project Importer - Project Name page appears. This page lets you specify the name and select a location for the newly imported project.
To specify a name and location to the imported project, perform these steps.
1. Enter a name for the converted Eclipse project, in the New Project Name text box. By default, the old project name is specified.
2. Check Use default location to save the project to the default Eclipse workspace. By default, the location of the project is the directory of the classic project and not the default Eclipse workspace.
  Tip: If you want to save the converted project to a location other than the default Eclipse workspace, click Browse and select the desired location from the Browse For Folder dialog box and click OK. Ensure that you append the path with the name of the project to create a new location for your project. Alternatively, In the Location text box, enter the full path of the directory in which you want to save your project including the project name.
Click Finish .
The CodeWarrior Classic Project wizard translates the classic CodeWarrior project and the new Eclipse project appears in the CodeWarrior Project view of the Workbench window.