Mises à niveau des extensions

Les développeurs d’extensions ajoutent constamment de nouvelles fonctionnalités à leurs extensions et corrigent fréquemment les bogues. Ces mises à jour sont incluses dans de nouvelles versions d’une extension et mises à disposition dans le catalogue sous forme de mises à niveau.

Catalogue d’extensions

Lorsqu’un développeur d’extensions a fourni une nouvelle version de l’extension, cette nouvelle version devient disponible dans le catalogue d’extensions. Le catalogue affiche uniquement la version la plus récente d’une extension. Vous ne pouvez pas installer une autre version d’extension que latest.

Lorsque vous installez une extension sur votre propriété, la version actuellement disponible est installée et votre propriété demeure avec cette version spécifique à partir de ce moment, même si des versions plus récentes sont ajoutées au catalogue.

Notifications de mise à niveau

Lorsque vous avez installé une extension sur votre propriété et qu’une nouvelle version est disponible dans le catalogue, un bouton Mettre à niveau s’affiche sur la carte d’extension lorsque vous affichez la page des extensions installées.

Vous remarquerez également un avertissement lorsque vous modifiez des ressources fournies par cette extension.

Les mises à niveau sont permanentes

Si vous souhaitez effectuer une mise à niveau vers une version plus récente disponible dans le catalogue, vous devez installer cette mise à niveau vous-même. Une mise à niveau est une « modification » qui doit être ajoutée à une bibliothèque, testée et publiée avant d’affecter vos balises déployées.

La mise à niveau ne doit pas être prise à la légère. Vous ne devez pas effectuer de mise à niveau, sauf si vous êtes prêt à tester la nouvelle extension et à la déployer. Une fois la mise à niveau ajoutée à votre propriété, elle doit être incluse dans toutes les bibliothèques. Toute bibliothèque qui n’inclut pas l’extension mise à niveau va échouer au moment de la génération.

Il n’existe actuellement aucune possibilité de rétrograder votre extension vers une version précédente. Une fois que vous avez effectué la mise à niveau (que vous ayez effectué une publication ou non), la nouvelle version de l’extension se trouve sur votre propriété pour y rester.

Processus de mise à niveau

L’installation d’une mise à niveau est presque identique à l’installation de l’extension pour la première fois.

La mise à niveau ne s’effectue réellement que lorsque vous appuyez sur Enregistrer. Avant cela, vous pouvez cliquer à tout moment sur Annuler et conserver la version installée. Un clic sur Enregistrer représente un point de non-retour.

Les mises à niveau d’extension ne sont pas autorisées si vous disposez d’une bibliothèque à l’état Approved ou Submitted. Cela s’explique par le fait que le build suivant doit contenir la nouvelle version de l’extension. Dans le cas d’une bibliothèque Approved ou Submitted, le prochain build est le build d’exploitation. Ce build échouerait, car il ne contiendrait pas la dernière version. Le workflow consiste donc à publier ou à rejeter les bibliothèques à l’état Approved ou Submittedavant la mise à niveau de l’extension.

Publication d’une mise à niveau

Une fois l’extension mise à niveau installée sur votre propriété, vous devez l’inclure dans toutes les bibliothèques. Un message d’échec de génération s’affiche pour toutes les bibliothèques qui ne l’incluent pas.

En outre, l’ajout de l’extension mise à niveau à votre bibliothèque est identique à l’ajout de toute autre modification à une bibliothèque.

Dans l’écran Modifier la bibliothèque, vous pouvez utiliser le bouton « Ajouter toutes les ressources modifiées » ou le bouton « Ajouter une ressource » et sélectionner uniquement l’extension mise à niveau.

Une fois que vous avez ajouté la mise à niveau de l’extension à votre bibliothèque, vous pouvez suivre la procédure décrite dans le flux de publication pour publier votre bibliothèque jusqu’en production.