For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Scanning existing MobileFirst native iOS apps to prepare for MobileFirst version 8.0

The migration assistance tool helps you prepare your apps that were created with previous versions of IBM MobileFirst™ Platform Foundation for migration by scanning the sources of the native iOS apps that were developed by using Swift or Objective-C and generating a report of APIs that are deprecated or discontinued in version 8.0.

Before you begin

The following information is important to know before you use the migration assistance tool:

• You must have an existing IBM MobileFirst Platform Foundation native iOS application.
• You must have internet access.
• You must have node.js version 4.0.0 or later installed.
• Review and understand the limitations of the migration process. For more information, see Migrating apps from earlier releases.

Apps that were created with earlier versions of IBM MobileFirst Platform Foundation are not supported in IBM MobileFirst Platform Foundation version 8.0 without some changes. The migration assistance tool simplifies the process by scanning the source files in the existing version app and identifies APIs that are deprecated, no longer supported, or modified in version 8.0.

The migration assistance tool does not modify or move any developer code or comments of your app.

Procedure

1. Download the migration assistance tool by using one of the following methods:
   • Download the .tgz file from the Jazzhub repository.
   • Download the Developer Kit, which contains the migration assistance tool as a file named mfpmigrate-cli.tgz, from the Download page. For more information about the Developer Kit, see The IBM MobileFirst Platform Foundation Developer Kit.
   • Download the tool by using the instructions that are provided in Opening the MobileFirst Operations Console.

2. Install the migration assistance tool.
   1. Change to the directory where you downloaded the tool.
   2. Use NPM to install the tool by entering the following command:

      npm install -g

3. Scan the IBM MobileFirst Platform Foundation app by entering the following command:

   mfpmigrate scan --in source_directory --out destination_directory
   --type ios

   source_directory

   The current location of the version project.

   destination_directory

   The directory where the report is created.

   When it is used with the scan command, the migration assistance tool identifies APIs in the existing IBM MobileFirst Platform Foundation app that are removed, deprecated, or changed in version 8.0 and saves them in the identified destination directory.

Parent topic: Migrating existing native iOS applications