Support of Apple iOS 8 for IBM Mobile Foundation V5.0.6.x and 6.0.x; IBM Worklight V5.0.6.x, 6.0.x, and 6.1.x; and IBM Worklight Foundation V6.2.x

Answer

To address known issues, interim fixes are available for these products. After you apply these fixes, you must rebuild your applications. The interim fixes are available for download from IBM Fix Central.


Note: When you are applying an interim fix to Worklight Studio, verify that the interim fix is applied to all instances of Worklight Studio that are running on the same machine. Build resources are shared across Worklight Studio instances. Applying an interim fix to some instances and not others will cause inconsistencies. The fix might not be applied properly.

Note: The Mobile Test Workbench for Worklight (MTWW) V8.5.1.3 and earlier does not support iOS 8.

The interim fixes cover the following areas:

• Dojo Toolkit
  
  
• Application Center
  
  
• Worklight Application Framework (WAF)
  
  
• Known Issues

Interim fixes

Download the latest interim fix for your product and version:

• V5.0.6: IBM Worklight Consumer Edition, IBM Worklight Enterprise Edition, IBM Mobile Foundation Consumer Edition, IBM Mobile Foundation Enterprise Edition
  
  
• V6.0.x: IBM Worklight Consumer Edition, IBM Worklight Enterprise Edition, IBM Mobile Foundation Consumer Edition, IBM Mobile Foundation Enterprise Edition
  
  
• V6.1.x: IBM Worklight Consumer Edition, IBM Worklight Enterprise Edition
  
  
• V6.2.x: IBM Worklight Foundation Consumer Edition, IBM Worklight Foundation Enterprise Edition
  
  

Upgrading the Dojo Toolkit

• V6.0.x, 6.1.x, and 6.2.x:
1. Obtain the DojoLib193_iOS8_20140916.zip file from the interim fixes that you have downloaded.
   
   
2. In Worklight Studio, click File > Import > Existing project. Import the DojoLib193_iOS8_20140916.zip file. A new, or fixed, Dojo Library project named dojoLib_193 is created.
   
   
3. For each Worklight project that contains hybrid applications with Dojo:
1. Right-click the project and go to Properties > Dojo Toolkit.
   
   
2. Select dojoLib_193 from the Dojo Library Project drop-down list. See the following screen shot:
   
   
   
   
   
3. Click OK in Properties and click Yes when you are asked whether to resolve layer files. This process updates all the pre-built layers in your existing hybrid applications.
   
   
4. Build and test your application.
   
   
Note: For V6.0, you must clear the Provide Library Resources check box when you are building for the device that runs Apple iOS 8, and when deploying to the device.


For more details about IBM Worklight V6.0 Dojo library setup, see Worklight Dojo library project setup.


• V5.0.6.x:
1. Obtain the DojoLib186_iOS8_20140916.zip file from the interim fixes that you have downloaded.
   
   
2. In your V5.0.6 project, delete the content of the dojo folder, but make sure to keep the dojo folder itself in the project. See the following screen shot:
   
   
   
   
   
3. Import the DojoLib186_iOS8_20140916.zip file. Right-click the dojo folder in the project and select Import > Archive File.
   
   
4. Select the DojoLib186_iOS8_20140916.zip file that you downloaded, and make sure that the Into folder field is set to the dojo folder in your project. See the following screen shot:
   
   
   
   
   
5. Build and run your application.

Upgrading the Application Center

• V6.0.0.x, V6.1.x, V6.2:
1. Apply the Worklight Server and Worklight Studio files from interim fix that you downloaded from IBM Fix Central.
   
   
2. Increase the version number when you recompile and re-sign the application center client. The application is now seen as an upgrade of the old version.


• V5.0.6.x:
  You must upgrade to the V6.2 version of the Application Center and apply the interim fix to support iOS 8. You must have Application Center at V6.2 even if you are currently on Worklight V5.0.6.x. However, you can upgrade the Application Center component only. You do not need to upgrade your other Worklight Server components. The V6.2 Application Center coexists on the same server with other versions of the Worklight Server.
  
  To support iOS 8, upgrade your Application Center to the newest version with the following steps:
1. Download Worklight Server V6.2.0.0 from Passport Advantage. The base V6.2.0.0 server is required because the server interim fix is not a full installation.
   
   
2. Apply the Worklight Server and Worklight Studio files that you downloaded from IBM Fix Central for Worklight Server and Worklight Studio V6.2.0.0. The interim fix is required to build the V6.2.0.0 client.
   
   
3. Install the Application Center server component with Installation Manager, which upgrades the existing Application Center database as needed.
   
   
4. Build the Application Center client.

Upgrading Worklight Application Framework (WAF)

1. Apply the Dojo fix that is described earlier in this document.
   
   
2. To ensure that projects that are created in the future contain the fix, copy the waf-dojo-layer.js file that is contained in the interim fix into the wlFrameworkLib/layers/ directory.
   
   
3. Copy the waf-dojo-layer.js file to the /www/layers/ directory for each Worklight Application Framework-based application.
   
   
4. Rebuild and deploy your application.

Additional known items that are corrected with the interim fixes

• Push Notification Hybrid and Native Applications might not work using Xcode 6
  
  
• Worklight Application Center mobile client does not work on Apple iOS 8
  
  
• App layout might get corrupted if launched on iPad in landscape orientation on Apple iOS 8 when the app is built using Xcode 5
  
  
• Cordova geolocation does not work when built with Xcode 6
  
  
• After a backup and restore through Apple iTunes, Apple iOS hybrid applications are corrupted and need to be reinstalled
  
  
• Studio interim fix does not work if there are other unpatched instances of Worklight Studio executed on the same machine
  
  
• Apple rejected the publication of a Worklight application for Apple iOS 8

Workarounds