Introduction to MigrationCheck

The MigrationCheck tool is a command line tool that allows you to check which Symbian OS APIs need to be migrated from one version to another, when upgrading your program to work on a later release of Symbian OS.

The tool checks the linked libraries in your program binaries against a Migration Guide Index, which lists all the APIs that need to be migrated when upgrading from particular Symbian OS versions (for example Symbian OS v6.1 to 7.0s, or Symbian OS v7.0s - 8.0a etc).

NOTE: Currently there are four Migration Guide Indices available - one for 6.1-7.0s, two for 7.0s-8.0a and one for 8.1b - 9.2.

When checking the libraries, the MigrationCheck tool only analyses exported functions (not virtuals, data members, constants, etc.).

A report is then produced, showing all the APIs found to be in need of migration. The migration information itself can be found by following the links next to the APIs listed in the resulting report. These point to relevant sections in the Migration Guide (within the Symbian OS Library).

The MigrationCheck tool is available on Symbian OS Development Kits and Customization Kits, in the <EPOCROOT>\epoc32\tools\ directory.

The recommended workflow process when using the MigrationCheck tool is as follows:

• Generate a list of ordinal numbers and function name mappings for all libraries within the whole of the Symbian OS version you are migrating from, using a tool called GenerateLibDB.

• Define the input for the MigrationCheck tool, such as the output of GenerateLibDB, the Migration Guide Index for the Symbian OS version you are migrating to, and the Symbian OS Library.

• Run the MigrationCheck tool, from command line, on your program binaries.

• View the results in HTML format.

• Read the relevant migration information in the Symbian OS Library.

• Perform the migration.

• How to use GenerateLibDB

• How to use MigrationCheck