Show TOC

Uploading and Deploying Hybrid AppsLocate this document in the navigation structure

If the selected hybrid app uses the AppUpdate plugin, activate the new version from this screen. If the hybrid app does not use the AppUpdate plugin, the application-specific settings are not applicable.


An application developer creates a hybrid app package that:
  • Contains the contents of the application's www folder and the project config.xml file, with a separate folder in the archive for each mobile platform (android/www and/or ios/www in all lower case). Format structure for hybrid apps:
    |- android 
    | |- config.xml
    | |- www
    |- iOS
  • Is compressed into a standard .zip file for upload.


  1. In Management Cockpit, select Start of the navigation path Applications Next navigation step App Specific Settings End of the navigation path.
  2. (Optional) If you imported a new application, skip this step. If you are updating the version, click Browse to upload another version of the application.
    1. In the dialog, navigate to the directory.
    2. Select the hybrid app package, and confirm.
    New version information appears for the uploaded Kapsel app for each mobile platform. You cannot change this information.
    Property Description
    Required Kapsel Version Identifies the Kapsel SDK version that was used to develop the Kapsel app, for example 3.0.0.
    Note This version attribute is informational only, and is not used by SAP Mobile Platform Server to determine whether device clients should receive the Web application update.
    State State of the Kapsel application version:
    • New – a newly uploaded version.

    • Staged – in testing. A user who is defined as a tester can download and test applications, see Managing Users.

      Once testing is complete, an administrator can promote a version to the Current state, so it becomes active. If testing fails, the administrator can change the state back to New.

    • Current – the version that is currently active.

    To move an application version between states:
    Beginning State Action Ending State
    New Click Stage Staged
    New Click Deploy Current
    Staged Click Remove New
    Staged Click Deploy Current

    For each platform, there can be an unlimited number of versions in the New state, but only one version in the Staged state, and one version in the Current state.

    Development Version Identifies the internal development version that was used to develop the Kapsel app.
    Description Describes the Kapsel app.
    Revision Identifies the production version revision. For a newly uploaded Kapsel app, this is blank.
    Note When the Kapsel app is deployed, the revision number is incremented.
  3. To deploy the application to a mobile platform, click Deploy and confirm.

    Deployed Kapsel app information appears as the current version and the revision number is incremented.

    For device application users:
    • When a device user with a default version (revision = 0) of the Kapsel app connects to the server, the server downloads the full Kapsel app.
    • When a device user with a version (revision = 1 or higher) of the Kapsel app connects to the server, the server calculates the difference between the user's version and the new version, and downloads a patch containing only the required changes.
    • If the application implements the AppUpdate plugin, the server checks for updates when the application starts-up or is resumed. If the developer has made changes, AppUpdate detects them using contents in the www folder (that is, the HTML based content), and not with native plugins or changes made outside of that folder. For changes made outside the www folder, the developer needs to post a new copy of the app to the application download site, or use Afaria to push the new app to all users.
  4. Remove application versions that have been imported, but not yet deployed:
    • To remove an application from one mobile platform, click Remove and confirm.
    • To remove an application from all available mobile platforms, click Remove All and confirm.