La gestion des versions permet aux développeurs de gérer plusieurs versions d'une intégration à différentes étapes du développement.
Dans l'onglet Développer du Google Home Developer Console, les intégrations sont considérées comme "non versionnées". Une fois que vous avez commencé la phase de test du développement dans l'onglet Test, les intégrations sont versionnées. Une version d'intégration est utilisée à partir de ce moment pour chaque étape restante du workflow, de "Tester" à "Lancer".
Par exemple, vous pouvez avoir une version d'une intégration en cours de certification pour un lancement imminent, tandis qu'une version plus récente de l'intégration avec des fonctionnalités différentes est testée pour un autre lancement dans quelques mois.
Prérequis
Les versions d'intégration sont un instantané d'une intégration sans version. Cela signifie que lorsque vous créez un plan de test pour la certification, et donc une version d'intégration, toutes les métadonnées de branding liées à cette intégration doivent correspondre aux informations que vous souhaitez utiliser pour l'intégration lancée.
Avant de créer un plan de test de certification, assurez-vous d'avoir effectué les opérations suivantes :- Vous avez créé un profil d'entreprise.
- Vous avez saisi l'ID de fournisseur (VID) de production pour l'intégration.
- Configuration et branding configurés.
Si vous n'avez pas effectué toutes ces étapes pour votre intégration, une version d'intégration créée pour les tests de certification ne peut pas être certifiée. Vous devrez créer une version et recommencer à partir de l'étape de test.
Vous devrez également créer une version et recommencer si vous souhaitez mettre à jour votre identité visuelle avant la certification d'une version de l'intégration.
Créer une version
Lorsque vous créez un plan de test pour la certification, une nouvelle version de l'intégration est créée. Cette version numérotée est listée dans toutes les listes d'intégration de l'onglet Developer Console à partir de l'onglet "Test".
Les nouvelles versions ne sont jamais créées à partir d'autres versions numérotées. Par exemple, le premier plan de test que vous créez pour une intégration génère la version v.1 de cette intégration. Si vous créez un autre plan de test, la version v.2 sera créée pour cette intégration, mais elle ne sera pas basée sur la version v.1. Cette version est basée sur l'instance sans version de l'intégration, comme la v.1.
La version N/A d'une intégration représente l'instance sans version de l'intégration, qui est gérée dans l'onglet Développer.
En d'autres termes, dans Matter > Test de Developer Console :
- Si vous cliquez sur Tester pour la version N/A de l'intégration, une nouvelle version est créée. Le numéro de version sera supérieur de un à celui des versions numérotées existantes.
- Si aucune version numérotée n'existe, la version v.1 est créée.
- Si la version v.1 existe, la version v.2 est créée. Si la version v.2 existe, la version v.3 est créée, et ainsi de suite.
- Si vous cliquez sur Tester pour une version numérotée de l'intégration (par exemple, v.1), aucune nouvelle version n'est créée. La version v.1 est alors testée à nouveau.
Métadonnées
Lorsqu'une version est créée, toutes les métadonnées listées dans les prerequisites qui ont été ajoutées pour l'intégration sans version sont associées à la version. Toutefois, les métadonnées associées à une version ne peuvent pas être consultées ni modifiées.
Toute modification apportée aux métadonnées d'une intégration ne sera pas répercutée dans les versions existantes. Vous devez créer une version pour que les métadonnées mises à jour soient utilisées pour la certification et le lancement.
Supprimer une version
Les versions d'intégration ne peuvent pas être supprimées et ne sont pas conçues pour l'être. Ils doivent être mis à jour pour refléter un état de l'intégration (nouveau plan de test ou essai de champ) qui peut être certifié et lancé.
Une version d'intégration n'est supprimée de Developer Console que lorsqu'elle a été lancée et qu'elle est ensuite remplacée par le lancement d'une autre version.