Known Limitations & Workarounds for the Cordova Workflow in IBM MobileFirst Platform Foundation 8.0 Beta

[UPDATE Apr. 9, 2016] There were several Cordova releases this past week that resolve the issues listed below. Get the latest releases to eliminate the need to use the workarounds.

  • Cordova Tools Release

    The latest Cordova Tools release includes:

    • cordova-lib@6.1.1
    • cordova@6.1.1
    • plugman@1.2.1

    If you have cordova installed:

          npm install -g cordova@latest
    

    If you have plugman installed:

          npm install -g plugman@latest
    
  • Cordova iOS 4.1.1 Release

    To upgrade:

      npm install -g cordova
      cd my_project
      cordova platform rm ios
      cordova platform add ios@4.1.1
    

    To add it explicitly:

      cordova platform add ios@4.1.1
    
  • Cordova Windows 4.3.2 Release

    To upgrade:

      npm install -g cordova
      cd my_project
      cordova platform update windows@4.3.2
    

    To add it explicitly:

      cordova platform add windows@4.3.2
    

The following lists the known limitations and workarounds of creating Cordova apps with IBM MobileFirst 8.0 Beta.

  • Use Cordova CLI v6.0.0, not v6.1.0

    There are known issues with v6.1.0 of Cordova CLI that prevents the iOS platform from being added in some instances as well as trying to add the Android platform from a path. Until v6.1.1 is released, use v6.0.0 of Cordova CLI.

            npm install -g cordova@6.0.0

  • A Cordova project created on Linux or Windows workstations that adds the iOS platform will need to remove and then re-add the iOS platform if that Cordova project is moved to an OSX workstation to run.

    After moving to an OSX workstation, in the Cordova project, run:

            cordova platform remove ios

            cordova platform add ios

    A fix is planned to be available in the next cordova-ios release.

  • A Cordova project created on workstations other than Windows 8 or Windows 10 that adds the Windows Universal platform will need to remove and then re-add the Windows Universal platform if that Cordova project is moved to a Windows 8 or Windows 10 workstation to run.

    After moving to Windows 8 or Windows 10 workstation, in the Cordova project, run:

            cordova platform remove windows

            cordova platform add windows

    A fix is planned to be available in the next cordova-windows release.

Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.
Last modified on April 14, 2016