Appendix: Migrating from Earlier Releases

In this appendix:

• Introduction
• Migration issues
• Migrating from 6.4.0 (IDE 4.5) to 6.4.1 (IDE 4.6)
• Migrating from 6.3.2 (IDE 4.0.1) to 6.4.1 (IDE 4.6)

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.

---

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

---

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
• Compiler issues
• CDT impact on the IDE
• IDE location
• Old launch configurations don't switch perspectives automatically
• Missing features in context menus
• System Builder Console doesn't come to front
• Reverting to an older version of the IDE

Co-existence

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

• You can have a QNX Software Development Platform version 6.4.1 installed on the same machine as QNX Momentics 6.4.0, 6.3.x and 6.2.x; however, the IDE installed with version 6.4.1 does not necessarily work with the tool chains from these earlier releases.
• On Windows hosts, because of co-existence issues, you can't use the configuration program (QWinCfg) that lets you change versions of the QNX Momentics Tool Suite for the IDE.

Compiler issues

The IDE includes the following changes to its compilers:

• We've discontinued the Intel 8.1 compiler, icc.
• We've updated gcc to version 4.3, and we no longer ship versions 2.95.3 or 3.3.5.

  After you import a project from IDE 4.0.1, if the compiler is not 4.3, the IDE will detect it and automatically change it for you.

• The same C++ ABI change between gcc 2.95.3 and 3.3.5 exists between 2.95.3 and 4.3. Older C++ binaries linked against libcpp.so.3 and libstc++.so.5 will continue to work because we ship those legacy C++ libraries in 6.4.1. You can't link old C++ libraries into new C++ programs.
• Since gcc handles the way in which it handles its runtime support routines, we've had to change the version number of libc.so to 3 to be able to support old (pre-6.4.1) binaries on a 6.4.1 system. Binaries created with QNX Momentics 6.3.x should be compatible with 6.4.1, but note the version number of libc.so was incremented to 3, in order to support older binaries; consequently, you'll need to update your buildfiles.

  To use the new version of libc.so, you'll need to update your buildfiles to use libc.so.3 instead of libc.so.2. For additional information, see the Release Notes.

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.

---

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:
   • Click Finish.
   • Click Next, click Advanced settings, then select your C/C++ Build and build target properties, and any other options. Click Finish when complete.

   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:

• In the Target Navigator view, select a project, right-click and select Properties.
• On the left, select C/C++ Build.
• On the right, verify that the Generate Makefiles automatically and the options Expand Env. Variable Refs in Makefiles in the group Makefile generation are selected.
• On the left, expand C/C++ Build, and select Tool chain editor.
• In the Current builder list, select the external make builder.
• Specify any other desirable options for properties on the other panels.
• Click OK.

  As a result, the IDE generates a number of .mk files, and a top level make file for each processed configuration (the last one in the configuration folder). This make file can be processed from the command line using the make utility:

  make -f [configuration]/makefile [target]

• Every time any configuration is changed, updated, or deleted, you need to refresh the make infrastructure either by regenerating the make files, or changing the existing files manually.

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.

---

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:

• your workspace (done automatically by the IDE)
• Migrating your projects (done automatically by the IDE, except for make projects)

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:

• By default, the IDE offers to put your workspace in home_directory/ide-4.6-workspace on Linux, and C:\ide-4.6-workspace on Windows, whereas in 6.4.0 it was ide-4.5-workspace, and earlier the default was workspace, so now there's less chance of accidentally migrating your old workspace.
• When you import existing projects, you now have the option of making a copy of it in your workspace. This is preferable because it leaves the original untouched as a backup. See “Importing projects” in the Common Wizards Reference chapter.

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.

---

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:

• If your project is a QNX C/C++ project:
  1. Select QNX C/C++ Project in the list on the left, then the Make Builder tab to display the Make Builder settings:
  2. Check the Clean box in the Workbench Build Behavior group, and enter clean in the text field.
  3. Click Apply to save your settings, or OK to save your settings and close the dialog.
  4. Repeat this process for each of your projects.
• If your project was a Make C/C++ project:
  1. Follow the instructions in “Creating a make project”.
  2. Import your project data into the newly created project.
  3. Follow these steps for each make project.

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:

• your workspace (done automatically by the IDE)
• Migrating your projects (done automatically by the IDE, except for managed make projects)

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.

---

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:

• By default, the IDE offers to put your workspace in home_directory/ide-4.6-workspace on Linux, and C:\ide-4.6-workspace on Windows, whereas in 6.4.0 it was ide-4.5-workspace, in 6.3.2 it was ide-4-workspace, and earlier the default was workspace, so now there's less chance of accidentally migrating your old workspace.
• When you import existing projects, you now have the option of making a copy of it in your workspace. This is preferable because it leaves the original untouched as a backup. See “Importing projects” in the Common Wizards Reference chapter.

---

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.

---

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:

• If your project is a QNX C/C++ project:
  1. Select QNX C/C++ Project in the list on the left, then the Make Builder tab to display the Make Builder settings:
  2. Check the Clean box in the Workbench Build Behavior group, and enter clean in the text field.
  3. Click Apply to save your settings, or OK to save your settings and close the dialog.
  4. Repeat this process for each of your projects.
• If your project was a Make C/C++ project:
  1. Follow the instructions in “Creating a make project”.
  2. Import your project data into the newly created project.
  3. Follow these steps for each make project.