Run the Plugin

In the last article, we configured the plugin to integrate with AirWatch admin console. We will now run the job to see the plugin in action. We will first upload version 1.0.1 to the console and install it on the enrolled iOS device. After that, we will upload a new version 1.0.2, while deleting the old version (1.0.1). We will validate this update on our enrolled device.

1. Build the app

  1. Click on Build Now
  2. The job may take a few minutes to complete.  After the job is completed you should see a Blue status, indicating success.
    NOTE - The page will auto refresh while you are waiting for the job to complete, so no need to manually refresh.  Please wait while the build finishes.

2. Validate the app upload on AirWatch console

  1. Click on the AirWatch tab to open the console.
  2. Click on Apps & Books.
  3. Expand Applications.
  4. Click on List View
  5. Click on Internal.
  6. Validate that you are now seeing the application App Lifecycle with version as 1.0.1

3. Install the internal app on your enrolled device

  1. Depending on if your device is supervised or not, you will get an App Installation prompt for the app App Lifecycle.
  2. Click on Install
  3. Confirm that the app is installed on the enrolled device.

4. Enable the App Catalog

To validate that we are receiving the correct AppLifecycle version on our iOS devices, we are going to enable the App Catalog in the AirWatch Console.

  1. Click Groups & Settings.
  2. Click All Settings.

4.2. Override the AirWatch Catalog Publishing Settings

  1. Click Apps.
  2. Expand Workspace ONE.
  3. Expand AirWatch Catalog.
  4. Click General.
  5. Click the Publishing tab.
  6. Select Override for the Current Setting.

4.3. Enable the iOS Platform Catalog

  1. Scroll down to the Platforms section.
  2. Select Enabled for iOS.
  3. Select Enabled for Full Screen.

4.4. Save the Catalog Changes

  1. Scroll to the bottom of the page.
  2. Click Save.

4.5. Close Settings

  1. Ensure the Saved Successfully prompt is displayed.
  2. Click Close.

5. Confirm the app version from catalog

We will now use the App Catalog we published to our iOS Device to confirm the AppLifecycle app version is correct.

5.1. Open the Catalog App

Tap the Catalog app.

5.2. Confirm the App Lifecycle Version

Find the App Lifecycle app and confirm that the version is listed as 1.0.1.

6. Run the plugin to update the internal app

  1. Click on the tab to switch to Jenkins dashboard.
  2. Click on Configure.

7. Upload the new version and delete the old version

In this step, we will run the same Jenkins job again but targeting the version 1.0.2 of the same app. This will update the existing app in the console from version 1.0.1 and 1.0.2. At the same time, we will delete the previous version (1.0.1) in the same step. So, in one run, we are not only updating the app on the device but also retiring the old versions which are no longer needed.

NOTE - Retiring / deleting previous versions is an optional step. You can still update the app to a new version, while keeping the old versions in the console.

  1. Click on Post-build Actions.
  2. Change the File Path - change only the file name in the end from AppLifecycle_101.ipa to AppLifecycle_102.ipa.
  3. Click on Get Available Version(s)
  4. Ensure that you see version 1.0.1 in Delete Previous Versions.  If it does not display, enter "1.0.1" for this field.
  5. Click Save

8. Run the job version 1.0.2

Click on Build Now.  Confirm that Build #2 under Build History completes.

9. Validate in AirWatch Console

  1. Click on the AirWatch console tab to switch.
  2. Click Apps & Books.
  3. Expand Applications.
  4. Click List View.
  5. Click the Internal tab.
  6. Validate that you now see the version 1.0.2 for App LIfecycle.

10. Validate on the device

The app might update too quickly to notice but as soon as the upgrade is completed, you will see a blue dot before the name, indicating that the app is just updated to a new version.

11. Confirm the app version from catalog

We will now use the App Catalog we published to our iOS Device to confirm the AppLifecycle app version is correct.

11.1. Open the Catalog App

Tap the Catalog app.

11.2. Confirm the AppLifecycle Version

Find the App Lifecycle app and confirm that the version is listed as 1.0.2.