Convert a Mobile App to a Web PWA

To be able to use your mobile apps beyond 2024 (when they reach End of Life), you must convert your existing mobile app to a web app and deploy it as a PWA.

  1. Open the visual application containing your existing mobile application, then export the application to download it as a ZIP archive to your local file system.

    Note:

    Create a backup of the application's ZIP archive, so you have a copy you can use in case you run into issues.
  2. Extract the contents of the archive. You should see something similar to this directory structure:
    businessObjects/
    mobileApps/
    settings/
    .gitignore
    Gruntfile.js
    package.json
    Readme.md
    visual-application.json
  3. Create a new webApps directory (take note of the capitalization) in the extracted folder.
  4. Copy the contents of your mobileApps directory into the webApps directory. For example, if your mobileApps directory contains a hrmobileapp folder, copy the hrmobileapp folder to the webApps directory.
  5. Go to the mobile app directory you copied into the webApps directory (hrmobileapp for example) and remove these files:
    • manifest.json
    • settings/appShellCache.json
    • settings/build-configurations.json
    • settings/mobile-build.json
    • mobile-build-templates/* (if it exists)
  6. Compress the webApps directory into a new archive (for example, webApps.zip).

    Tip:

    If you're working on a Mac, use these steps to create an archive:
    % cd <Visual Application Directory>
    % find . -name '.DS_Store' -type f -delete
    % zip -r webApps.zip webApps
  7. With your mobile application open in the Designer, import the webApps archive you created. Don't select the Delete existing files and resources option:

    Your new web app should now show up in the Web Apps pane.
  8. Enable PWA support for your new web app:
    1. Select the app's <app name> node in the Web Apps pane, then click Settings and PWA.
    2. Click the Enable Progressive Web App (PWA) toggle to disable and re-enable PWA support.
    3. Review PWA settings for your web app. You might want to change the Manifest Settings and create an Offline Fallback Page.
  9. Now share your application to test and make sure everything works as expected.

    Your new web PWA should work the same way as your original mobile PWA. When your PWA-enabled web app opens in a browser:

    1. Use the device toolbar in the browser's Developer tools to debug your app in a simulated mobile environment:

    2. Use the install icon in the app's address bar to install your web app:

    3. Use the share icon in the app's address bar to generate a QR code that will allow users to quickly open the web app on a mobile device via its camera:

      If the icon doesn't show in the address bar, select Cast, save, and share from the browser's customization menu, then Create QR code.

    After you've confirmed that your app works as expected, you can choose to delete the mobile app from your visual application.

    Note:

    If your mobile app leveraged the Oracle JET Offline Persistence Toolkit to provide offline capabilities, you need to deploy your application using Grunt commands.