Send a patch
After releasing a new version of an app, use this option to send updates to a small subset of an app's entities to any or all clients on a previous version. This is similar to Push updates, but reduces the surface area, bringing only selected changes rather than upgrading clients to an entirely new app version.
To send a patch of the app:
-
On the Manage Apps screen details pane menu, select the version that is the source of the updated content — the parent version — and then click Send patch.
Restriction: Send patch is disabled for the oldest version of an app because the goal is to create patches from a version to impact on previous installed versions. -
On the Patch Details section, enter a Patch name, and optionally, a description. Click Save and continue.
-
On the Items section, make a selection from the Category selected and then the Entity selected dropdown. Select the Add
for each configuration entity to add to the app. As you add entities, they appear in the Items tab.
Restriction: Patches only have the content of their parent version. Explicit and implicit entities are allowed. Patches can only update up to 5 items and their dependencies. -
Open the Dependencies tab to calculate the additional configuration entities that are included in your app. These additional entities are required by the entities that you selected.
If adding new entities while the Dependencies section is already open, click Update Dependencies to recalculate the list.
-
If you have completed language Translations for any of the entities you selected, use the Advanced tab to select the translated languages to include in the patch.
-
When you are done working in the patch, click Save and continue. This automatically sends you to the Destination section.
-
The Destination section shows all the instances that have a version installed that is prior to the parent version. Select which of the instances to which you want to push this patch, then click Continue.
-
Confirm the patch by clicking Continue.
Preparing the update takes a few minutes. You are redirected to the Manage Apps screen.
-
On the Manage apps screen, the Patches tab of the app details pane shows the status of the update for each client as well as details about previous attempts, if any occurred. While the update status is Pending or In Progress, you may select the client and click Stop update to cancel the update.
-
When the status is ReadyUpgrade, click Apply patch.
-
Confirm the patch by clicking Apply patch. The patching process may take a few minutes.
To see all patches that for a released version, select the release version and click the Patches tab on the app details pane.
Click View details to see additional information about completed patches. Click Installation details for more information about the installation process.
