For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.
Scanning existing MobileFirst native Android apps to prepare for MobileFirst version 8.0
The migration assistance tool helps you prepare your apps that were created with a previous version of IBM MobileFirst™ Platform Foundation for migration by scanning the sources of the native Android 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 Android 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 previous 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 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.
- Change to the directory where you downloaded the tool.
- 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 android
- 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.
Parent topic: Migrating existing native Android applications