Migrating a Hybrid App or Workflow to the new JavaScript API requires the developer to perform a few manual steps.
Reapply any custom changes made to API.js and Utils.js in the previous Hybrid App to the new Hybrid App.
Some methods used in previous versions may have been deprecated, renamed, removed, or relocated within the “hwc” global namespace. In your custom code, resolve any calls to these methods.
A new Custom.js file is automatically generated, but it will be empty. Move any functionality from the previous version of Custom.js to the new file, paying attention to any method name changes.
Move any custom CSS, JavaScript, image, or other files in the generated folder of the previous Hybrid App or Workflow to the generated folder for the new Hybrid App.
| Generated Folder Name | 2.1 ESD #3 (old) | Starting with 2.2 SP02, and 2.3 (new) |
|---|---|---|
| html/css | No changes | No changes |
| html/css/bb | No changes | No changes |
| html/css/bb/img | No changes | No changes |
| html/css/iphone | No changes | No changes |
| html/css/iphone/images | No changes | No changes |
| html/css/jquery | jquery.mobile-1.0.css (removed) | jquery.mobile-1.1.0.css (added) |
| html/css/jquery/images | ajax-loader.gif (added) | |
| html/js | json2.js (removed) |
datajs-1.0.3.js (new) hwc-api.js (new) hwc-comms.js (new) hwc.utils.js (new) HybridApp.js (replaces Workflow.js) PlatformIdentification.js (new) |
| html/js/android | Phonegap-1.4.1.javascript (removed) | cordova-2.0.0.javascript (added) |
| html/js/ios | Phonegap-1.4.1.javascript (removed) | cordova-2.0.0.javascript (added) |
| html/js/jquery |
jquery-1.6.4.js (removed) jquery.mobile-1.0.js (removed) |
jquery-1.7.1.js (added) jquery.mobile-1.1.0.js (added) |
| html/js/widgets | sy.ui.iphone.iscroll.js (removed) |
sy.ui.iphone.iscroll4Lite.js (added) sy.ui.iphone.picker.js (added) sy.ui.iphone.signature.js (added) sy.ui.iphone.util.js (added) sy.ui.js (added) |
| html/css/makit | N/A | New directory added for 2.2 SP02 |
| html/images/makit | N/A | New directory added for 2.2 SP02 |
| html/js/makit | N/A | New directory added for 2.2 SP02 |
| html/js/wm | N/A | New directory added for 2.2 SP02 |
| html/js/blackberry | N/A | New directory added for 2.2 SP02 |
During project and application generation, check for messages in the console; these messages provide valuable tips related to migrating your application.