Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/ide_en/user_guide/migrate.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/ide_en/user_guide/migrate.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/ide_en/user_guide/migrate.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/ide_en/user_guide/migrate.html on line 8

Appendix: Migrating from Earlier Releases

In this appendix:

Introduction

Upgrading from 6.3.2 to 6.4.1 of the IDE involves two basic steps:

Step 1 — converting your development workspace to be compliant with the latest version of the IDE framework. The IDE performs this process automatically at startup when it detects an older workspace version.


Note: You can redirect the IDE to point at different workspaces by launching it with this command:

qde -data path_to_workspace


Optional Step 2 — converting your individual managed make projects. For more information, see Creating a make project.


Note: Upgrading from earlier versions to 6.3.2 requires that you upgrade your projects to IDE 4.0.1, and then follow the two step migration process (above) to upgrade to IDE 4.6. For additional information about migrating, see Migrating from 6.3.2 to 6.4.1 or Migrating from 6.4.0 (IDE 4.5) to 6.4.1 (IDE 4.6).”

Migration issues

When migrating to IDE 4.6, you might encounter the following issues:

Co-existence

The IDE has the following changes with respect to co-existence:

Compiler issues

The IDE includes the following changes to its compilers:

CDT impact on the IDE

In addition to the many fixes and enhancements to the QNX IDE plugins, this version of the QNX IDE Tool Suite includes the features from the Eclipse 3.4 and CDT 5.02 integration.

When creating projects, you no longer need to select between Standard and Managed C and C++ project. You simply select a C or C++ project, and the IDE launches the CDT new project wizard. In this wizard, you can pick between different project types. Makefile projects are almost the same as Standard Make projects. The main addition with Makefile projects is the ability to tell the CDT which tool chain you are using which will help the CDT with various tasks such as source navigation into system header files. All other project types are the same as make projects in IDE 4.6.


Note:

When upgrading your older IDE 4.0.1 projects to IDE 4.6, all 4.0.1 projects should successfully upgrade except for make projects. For your make projects, you'll receive an error message. For information about creating this type of project, see below.


Creating a make project

You can continue to create a typical make project using the C or C++ wizard.

  1. Select File-->New-->Project, select either C-->C Project or C++-->C++ Project, and click Next.
  2. In the Project name field, type a name for your project.
  3. In the Project Types area, expand Makefile and select Empty project.
  4. In the Toolchain list, select QNX QCC.
  5. Do one of the following:

    The result is an empty make project, which is similar to the Set QNX Environment action in earlier IDE releases.

To create a make file that can be launched outside the IDE:

For more information about using the CDT new project wizard, see Creating a C/C++ project, Creating a target project, Converting projects, and Importing projects.

For a list of new workbench features, see “What's New in 3.4” in the Workbench User Guide (Help-->Help Contents-->Workbench User Guide-->What's new).

For a list of new CDT features, see “What's new in the CDT?” in the C/C++ Development User Guide (Help-->Help Contents-->C/C++ Development User Guide-->What's new).

In addition to information about migrating your workspace and your projects, this section includes some issues that you might run into.

IDE location

Previously, the IDE was installed separately under C:/Program Files/QNX Software Systems. Now, the IDE is installed as part of the QNX Software Development Platform.

In 6.4.1, your workspace is located in home_directory/ide-4.6-workspace on Linux, and C:\ide-4.6-workspace on Windows. In 6.4.0 it was $HOME/QNX640/ide-4.5-workspace, and in 6.3.2 it was $HOME/QNX630/ide-4-workspace.

Old launch configurations don't switch perspectives automatically

Because of the internal data structure changes, launch configurations created with an older version of the IDE won't automatically switch to the Debug perspective when used as a debug configuration.

To fix this problem:

  1. Choose Run-->Debug… to open the Debug configuration dialog.
  2. Change any of the settings for this launch configuration, then click Apply to save the change.
  3. Change the setting back to the way you had it before, then click OK to revert your change and close the dialog.

Missing features in context menus

If you're missing new features in context menus, such as the ones available in the C/C++ Projects perspective, or if you're missing views, you need to reset your perspective.

To reset your perspective, follow the instructions in the Migrating your workspace section.

System Builder Console doesn't come to front

By default, the QNX System Builder perspective's Console view doesn't automatically switch to the front when building. In the new IDE, changed views change the style of the view title.

If you prefer the old behavior and want the Console view to automatically come to the front during a build:

  1. Choose Window-->Preferences to open the Preferences dialog.
  2. Expand the C/C++ entry in the list, then choose Build Console to display the console preferences.
  3. Check Bring console to top when building (if present), then click the OK button to save your changes and close the Preferences dialog.

Reverting to an older version of the IDE

When you load an existing project that was created with an older version of the IDE, the IDE updates the project to take advantage of the new features. This can cause problems if you try to load the project into an older version of the IDE.

If you plan to revert to an older version of the IDE, you need to make a backup copy of your workspace before using the new version of the IDE.


Note: Don't use cp to back up your workspace under Windows; use xcopy or an archiving/backup utility.

Importing into an older IDE

You can also import an existing project to an older version of the IDE:

  1. Make a backup copy of your workspace.
  2. Remove the .cdtproject and .project files from your project's directory.
  3. Import your project into the older version of the IDE. For information about importing a project into the IDE, see Importing projects for the version of the IDE that you want to use.

Migrating from 6.4.0 (IDE 4.5) to 6.4.1 (IDE 4.6)

When you migrate your workspace and projects from version 6.4.0 (IDE 4.5) to version 6.4.1 (IDE 4.6), there are two areas that require updating:

Migrating your workspace

Your workspace is automatically upgraded the first time you launch the new IDE. This process is entirely automated and cannot be prevented. If you need to revert to an older version of the IDE, be sure to read the Reverting to an older IDE section.

Note the following:

Migrating your projects

Your 6.4.0 projects are automatically upgraded to take advantage of the new IDE features, except for your managed make projects.


Note: If you want to use any of your existing managed make projects (created in earlier versions of the IDE) in QNX Momentics IDE version 4.6, these projects can't automatically be converted. You'll need to create a new managed make project in QNX Momentics IDE version 4.6 for each project you want to convert, and then copy the source code directly to the new project.

To complete the migration of your projects to the new IDE:

Migrating from 6.3.2 (IDE 4.0.1) to 6.4.1 (IDE 4.6)

When you migrate your workspace and projects from version 6.3.2 (IDE 4.0.1) to version 6.4.1 (IDE 4.6), there are two areas that require updating:

Migrating your workspace

Your workspace is automatically upgraded the first time you launch the new IDE. This process is entirely automated and cannot be prevented. If you need to revert to an older version of the IDE, be sure to read the Reverting to an older IDE section.

You might receive an error message during this process with the following text:

“Could not restore Workbench layout. Reason: Problems occurred restoring workbench.”

This message is caused by internal changes to many of the perspectives commonly used for C/C++ development. You can safely ignore this error.

To prevent this error from displaying when you load the IDE (and to prevent a similar error when you exit the IDE):

  1. Switch to the IDE workbench, if necessary.
  2. Choose Window-->Reset Perspective from the menu.
  3. Switch to each of your open perspectives, and repeat step 2.

Note: This error reappears later if you open a perspective that's currently closed, but that had been used at some point in the older IDE. Use this same process to remove the error message.

Resetting the existing perspectives also gives you full access to all of the new features available in views that were open in those perspectives.

Note the following:


Note: Many project options have changed from the QNX Momentics Development Suite version 6.3.x (and earlier) to QNX Momentics Software Development Platform version 6.4.1. Although the conversion process attempts to maintain configuration options, you should verify your individual project files to make sure any new settings have been initialized to the values you want.

Migrating your projects

Like your existing workspace, your projects are automatically upgraded to take advantage of the new IDE, except for managed make projects.


Note: If you want to use any of your existing managed make projects created in earlier versions of the IDE in QNX Momentics IDE version 4.6, these projects can't automatically be converted. You'll need to create a new managed make project in QNX Momentics IDE version 4.6 for each project you want to convert, and then copy the source code directly to the new project.

To complete the migration of your projects to the new IDE:


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/ide_en/user_guide/migrate.html on line 423

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/ide_en/user_guide/migrate.html on line 423