La gestion des versions permet aux développeurs de gérer plusieurs versions d'une intégration à différentes étapes de développement.
Dans l'onglet Develop (Développer) de la Google Home Developer Console, les intégrations sont considérées "non versionnées". Une fois que vous passez à la phase de test du développement dans l'onglet Test (Tester), 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 la phase de test au lancement.
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 non versionnée. 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 associé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 :- Créer un profil d'entreprise.
- Saisir 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 branding avant qu'une version d'intégration ne soit certifiée.
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 répertoriée dans toutes les listes d'intégrations de la 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 crée la version v.1 pour cette intégration. La création d'un autre plan de test crée la version v.2 pour cette intégration, mais cette version ne sera pas basée sur v.1. Au lieu de cela, cette version est basée sur l'instance non versionnée de l'intégration, comme v.1.
La version N/A d'une intégration représente l'instance non versionnée de l'intégration, qui est gérée dans l'onglet Develop (Développer).
En d'autres termes, dans Matter > Test de la Developer Console :
- Si vous cliquez sur Test (Tester) pour la version N/A de l'intégration, une nouvelle version est créée. Le numéro de version sera supérieur à celui de toutes les 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 Test (Tester) pour une version numérotée de l'intégration (par exemple, v.1), aucune nouvelle version n'est créée. Au lieu de cela, la version v.1 est testée à nouveau.
Métadonnées
Lorsqu'une version est créée, toutes les métadonnées listées dans les prérequis qui ont été ajoutées pour l'intégration non versionnée sont associées à la version. Toutefois, les métadonnées associées à une version ne peuvent pas être affichées ni modifiées.
Toute modification apportée aux métadonnées d'une intégration ne sera pas reflétée dans les versions existantes. Une nouvelle version doit être créée 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. Elles doivent être mises à jour pour refléter un état de l'intégration (nouveau plan de test ou essai sur le terrain) qui peut être certifié et lancé.
Une version d'intégration n'est supprimée de la Developer Console que lorsqu'elle a été lancée et qu'elle est ensuite remplacée par le lancement d'une autre version.