Almost all changes you make to your app will be to code inside your app's web app. For example, tweaking the look of a web panel, adding a configuration option or catching a previously unhandled exception can all be done by writing and deploying new code to your servers. Users see these changes as soon as you update your web app.
In many cases (e.g., catching an exception or adding a configuration option) there isn't an immediate reason why end users should be aware of the change. When you change your descriptor file, we automatically update your version and build number in the Marketplace.
We automatically detect updates to Atlassian Connect apps with a polling service. We poll the app descriptor URL that you included when you submitted your listing every minute. When we detect a change, we automatically update your app in the Atlassian Marketplace with a new version. The way we increment your version number depends on the changes made to your descriptor.
We poll and update your app so that you can easily release fixes and new features, without having to manually create new version entries on Marketplace. We want to ensure that customers get the latest version of your app with as little delay as possible — Connect apps should seem like web services, not versioned software.
When you change your app descriptor, these changes are automatically deployed to customer instances within a few hours--unless they require manual customer approval. Here's how it works:
Updates are published to the Marketplace within a few minutes of detecting changes from your Atlassian Connect descriptor. Customers automatically receive updates via the UPM within six hours. Any change to your service that does not alter your app descriptor will be immediately available to users and will not result in a new version on Marketplace.
We automatically increment the version for your app as follows:
If the changes do not require manual customer approval, they are automatically deployed to all customer instances within 10 hours:
Even though your app is automatically updated in the Marketplace, certain scenarios require customers to manually approve your app's update in the UPM. These changes correspond to minor version updates in the table above. In these cases, we automatically send emails to the product administrator so they can approve and update the app.
These scenarios require manual customer approval:
Before the approval, those customers continue to use the older version of your descriptor. If you can plan ahead, it's a good idea to isolate those changes from any other changes in functionality.
If the new version of your app is backward compatible (if it is able to handle requests from instances who have an older version of the descriptor) the upgrade will be transparent. All customer instances will be upgraded over a period of up to 10 hours.
However, if the new version of your app is not backward compatible, you should make sure that your solution caters to supporting both the old and the new version of the app:
You can view apps in the Marketplace the same way you manage other app versions: