Updating a customized version of an App or Discovery Accelerator

Note: With every software release, UiPath will provide you with a link to download the UiPath Process Mining files.

Introduction

When a new version of an app (for example AppOne) or discovery accelerator is released you should update your customized version of this app or discovery accelerator to the new version. Normally, when updating, you would lose any custom adaptations you have made to the app or discovery accelerator. This guide describes how you can update to the new version of an app or discovery accelerator, without losing your customizations.

Prerequisites

It is assumed that you have:

made local modifications to the .mvp file of the app or discovery accelerator that are committed to the branch;
the following files available on your computer:
- a released version of the app or discovery accelerator of the same release your modified version is based on (the Base app), for example UiPathProcessMining_v20.10.2.mvtag;
- a released version of the app or discovery accelerator of the release you want to update to, for example UiPathProcessMining_v21.4.1.mvtag.

Versions

To avoid errors, it is strongly recommended to update the app or discovery accelerator by at most one major release. While you can update the app or accelerator by more than one major release at a time, it is recommended to keep your app or discovery accelerator updated when new versions come out to avoid having to update more than one major release at a time.

Uploading the App or Discovery Accelerator files

Before you can upgrade your customized version of the app or discovery accelerator the following files must be uploaded to the Releases tab:

the released version of the app or discovery accelerator of the same release your modified version is based on;
the new version of the app or discovery accelerator.

Follow these steps to upload the released versions of the app or discovery accelerator.

Step	Action
1	Go to the Superadmin Releases tab of your developer environment.
2	Click on the Releases menu and select Upload a release to this server....
3	Upload the `.mvtag` file of the version of the app or discovery accelerator on which your modified version is based. For example `UiPathProcessMining_v20.10.2.mvtag`
4	Click on the Releases menu and select Upload a release to this server....
5	Upload the `.mvtag` file of the version of the app or discovery accelerator to which you want to upgrade your app or discovery accelerator. For example `UiPathProcessMining_v21.1.mvtag`

Updating your customized version of an App or Discovery Accelerator

Follow these steps to update your modified version of an app or discovery accelerator to the newest version of the app or discovery accelerator.

Step	Action
1	Go to the Workspaces tab and select the workspace that contains the `[application].mvp` file of your customized version of the app or discovery accelerator.
2	If your workspace contains any local modifications, click on the Workspace menu and select Commit....
3	Click on the Workspace menu and select Upgrade....
4	The version of the app or discovery accelerator on which your modified version is based is displayed in the Base app field in the Upgrade App dialog: • select the version of the app or discovery accelerator to which you want to upgrade from the New app drop-down list. • click on UPGRADE. See the illustration below for an example.
5	Open your customized app and check whether it was successfully upgraded.
6	Click on the Workspace menu and select Commit....