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