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

The migration assistance tool helps you prepare your apps that were created with earlier versions of IBM MobileFirst™ Platform Foundation for migration by scanning the sources of the native Windows app 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 Windows 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.

About this task

Apps that were created with earlier versions of IBM MobileFirst Platform Foundation are not supported in version 8.0 without some changes. The migration assistance tool simplifies the process by scanning the source files in the existing native Windows 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

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.
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
```
Scan the IBM MobileFirst Platform Foundation app by entering the following command:
```
mfpmigrate scan --in source_directory --out destination_directory
--type windows
```
source_directory

The current location of the 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.