Migrating Mobile Application Projects

Migrate mobile application projects from prior versions of Unwired WorkSpace.

Prerequisites
You must first import the connection profiles and mobile application projects into the current version of Unwired WorkSpace.
Task

Before you can work within mobile application projects created in prior releases of Unwired WorkSpace, you must migrate them to the current version of Unwired WorkSpace. Migration happens automatically when you first open an imported mobile application project in the current version of Unwired WorkSpace.

  1. From WorkSpace Navigator, right-click the project and select Open in Diagram Editor.
    If the project needs to migrate to the current release of Unwired WorkSpace, a Migrate dialog appears.
  2. Click Yes in the Migrate dialog.

    Status displays in the Migrating Results dialog, identifying the MBO and other relevant information, including any errors. Open the Problems view to isolate and correct any errors. Click OK to open the project in the Mobile Application Diagram and fix any errors. If the migration does not complete successfully, you may need to run it again (by opening the project) after correcting any errors.

    Migration errors can occur if connection profile information changed or the profiles were not imported. To view the connection profiles referenced by the migrated project, expand the Data Source References subfolder within the mobile application project folder.

    Note: If you disable the displaying of the dialog box in Mobile Development > Miscellaneous preferences, migration occurs without prompting.
  3. Redeploy the mobile application project.
    If previous versions of the mobile application project are deployed to Unwired Server, redeploy the project and overwrite the existing project, making sure you map logical to physical roles and configure server connection mappings, since deployment profile settings are not retained after migration.
  4. Generate code for device applications.
    Replace any previously generated Object API code in the mobile application project.

    For guidance in resolving issues that remain after migrating mobile application projects, see Migration Guidelines and Limitations.

    If there is a version 1.2 Unwired WorkSpace project open in the Mobile Application Diagram and you exit Unwired WorkSpace, the migration confirmation dialog displays the next time you open Unwired WorkSpace. For example:
    1. Import an Unwired Workspace version 1.2 project.
    2. Right-click the project and select Open in diagram editor.
    3. The migration dialog displays. Click Yes to confirm migration, do not select Do not show this dialog again. The project's connection profile is unavailable.
    4. Leave the project open in the Mobile Application Diagram and exit Unwired WorkSpace.
    5. Restart Unwired WorkSpace. The migration dialog displays when Unwired WorkSpace is in the process of opening. This is normal Eclipse behavior.
Related tasks
Exporting Connection Profiles
Exporting Mobile Application Projects
Importing Connection Profiles
Importing Mobile Application Projects
Related reference
Migration Guidelines and Limitations