App installation fails instantly when target version is lower than installed version (downgrade not supported)

Android

If an app installation fails immediately when you're trying to install a lower version than what's already on the device, this is due to Android's built-in protection against downgrading apps. This article explains why this happens and how to resolve it.

Why app installation fails when downgrading

Android's package manager enforces a strict version check: it will not install an app whose version code is lower than the version already installed on the device. This is an operating system–level restriction that applies to all Android devices and all MDM platforms.

For example, if a device has version 0.5.64 (514) installed and you try to push version 0.2.41 (241), the installation fails immediately because 241 is lower than 514.

Before you begin

Check the currently installed version code of the app on your device:

1. In the Esper Console, go to Devices & Groups → [Device Name] → Apps.
2. Find the app and note its version code.
3. Compare it to the version code of the app you're trying to install.
4. If the target version code is lower, follow the steps below.

How to downgrade an app

To install a lower version of an app, you must first uninstall the higher version, then install the lower version.

1. In the Esper Console, go to Devices & Groups → [Device Name] → Apps.
2. Locate the installed app and select Uninstall.
3. Wait for the uninstall to complete. The app should no longer appear as installed on the device.
4. Go to Apps → [Application Name] → [Target Version] and assign or install the lower version to the device or group.
5. Return to Devices & Groups → [Device Name] → Apps and confirm the lower version now appears as Installed with the correct version code.

If the uninstall doesn't complete

If the app remains installed after you select Uninstall, the app may be set as a Device Owner or System App. In this case, use ADB to uninstall it:

adb shell pm uninstall -k --user 0 <package.name>

Replace <package.name> with the actual package name (for example, com.example.myapp).

If the install still fails after uninstall

If the lower version fails to install even after confirmed uninstall, check that the uploaded APK matches the version you intend to install:

1. In the Esper Console, go to Apps → [Application Name].
2. Verify that the version code of the uploaded APK matches your target version.
3. The display label (for example, "GSS APP 241 V") may differ from the underlying versionCode. Always confirm the numeric version code, as that is what Android uses for comparison.

If you have a group-level app assignment

If the device is part of a group with a Blueprint or app assignment that enforces the higher version, the lower version may be uninstalled or overwritten after the next Blueprint sync. Before proceeding, do one of the following:

• Update the group-level app assignment to the target lower version, or
• Remove the device from the group temporarily while you downgrade the app.

Still need help?

If the issue persists across multiple devices or you're still unable to downgrade the app, contact Esper Support. include the device's AID, the app's package name, both version codes, and a device bug report.