Version control allows you to manage changes to files over time. Workspace ONE UEM uses two different version values to manage version control of internal applications, the actual file version, which is the coded version of the application set by the developer of the application and the internal version of the application set by the Workspace ONE UEM console for management. When you upload an internal app version to the console, this number is identified as Latest Version, New Version, and Previous Version.

Workspace ONE UEM displays the version on the Details tab of the application record.
  • Latest Version - This identifier is usually the highest numbered version and it gets deployed to devices that enroll in the assigned group.
  • Previous Version - This identifier is usually a lower version than the latest version.
  • New Version - This identifier is the version you are uploading to the console. You can upload numbers lower than the latest version and higher than the previous version.

Sourcing the Actual File Version Value

Workspace ONE UEM gets the application version that displays in the actual file version field from various places depending on the platform. These values must increment to allow the application version to override the current version in Workspace ONE UEM.

Table 1. Location of File Version Value by Platform
Platform Parameter Found In
Android versionName displays actual file version but versionCode controls the ability to version .apk package

iOS

macOS

CFBundleVersion

CFBuildShortVersionString

info.plist
Windows Desktop Version="X.X.X.X" but Workspace ONE UEM only displays three decimal places AppManifest.xml
Windows Phone Version="X.X.X.X" but Workspace ONE UEM only displays three decimal places WMAppManifest.xml

Actual File Version and Incrementation

You can upload multiple versions of an application no matter the actual file version number, but for most platforms, the actual file version controls the application's deployment. Workspace ONE UEM manages the new version depending on its actual file version value.

Table 2. Actual File Version Incrementation Behaviors
Platform Actual File Version
Android versionCode must increment up because downgrading versions is not supported.

Workspace ONE UEM can accept applications with lower versionCode values. However, it manages the assignments based on the order of the actual file version.

For example, if you have deployed an actual file version 3.1 of an application, you have an older actual file version 1.1 still in the console, and you upload actual file version 2.1, Workspace ONE UEM manages the versions with these behaviors.
  • Migrates assignments from version 1.1 (previous version) to 2.1 (new version).
  • If devices have 2.1 and 3.1 assigned (and both are active), Workspace ONE UEM sends install commands for 3.1 (latest version) since that is the highest version that devices are eligible to receive.
  • When you select Retire Previous Version at the time of uploading 2.1, the console retires 1.1 (previous version) and not 3.1 (latest version).

iOS

macOS

BundleVersion or the BuildShortVersionString can increment up or down because downgrading versions is supported.
Note: macOS does not support downgrading to a lower version of an app.

You can upload a lower version of the application and push it as the available version.

Windows Desktop Actual file version="X.X.X", the first three decimals, must increment up because downgrading versions is not supported.
Workspace ONE UEM can accept applications with lower actual file version values. However, it manages the assignments based on the order of the actual file version.
  • Migrates assignments from the previous version to the new version (the one you are uploading).
  • If devices have the new version and the latest version assigned (and both are active), Workspace ONE UEM sends install commands for the latest file version since that is the highest version that devices are eligible to receive.
  • When you select Retire Previous Version at the time of uploading the new file version, the console retires the previous version and not the latest version.
Windows Phone Version="X.X.X", the first three decimals, must increment up because downgrading versions is not supported.
Workspace ONE UEM can accept applications with lower actual file version values. However, it manages the assignments based on the order of the actual file version.
  • Migrates assignments from the previous version to the new version (the one you are uploading).
  • If devices have the new version and the latest version assigned (and both are active), Workspace ONE UEM sends install commands for the latest file version since that is the highest version that devices are eligible to receive.
  • When you select Retire Previous Version at the time of uploading the new file version, the console retires the previous version and not the latest version.