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 Develop (Développer) de Google Home Developer Console, les intégrations sont considérées comme "sans version". Une fois que vous commencez la phase de test du développement dans l'onglet Test, les intégrations sont gérées par version. Une version d'intégration est alors utilisée pour chaque étape restante du workflow, du 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 d'autres fonctionnalités est en cours de test pour un autre lancement quelques mois plus tard.
Conditions préalables
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 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:
- Créer un profil d'entreprise
- Saisissez l'ID du fournisseur (VID) de production pour l'intégration.
- Configurer la configuration et le branding :
Si vous n'avez pas suivi 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 devez créer une version et recommencer depuis l'étape de test.
Vous devrez également créer une nouvelle version et recommencer depuis le début 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égration dans le Developer Console, à partir de l'onglet "Test".
De 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. Si vous créez un autre plan de test, la version v.2 sera créée pour cette intégration, mais cette version ne sera pas basée sur la version v.1. Au lieu de cela, cette version est basée sur l'instance sans version de l'intégration, comme l'était 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 Develop (Développer).
En d'autres termes, sur Matter > Test dans Developer Console:
- Si vous cliquez sur Tester pour afficher la version N/A de l'intégration, une nouvelle version est créée. Le numéro de version sera supérieur d'un an à celui des versions numérotées existantes.
- S'il n'existe aucune version numérotée, 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 version n'est v.1. À la place, la version v.1 est testée à nouveau.
Métadonnées
Lorsqu'une version est créée, toutes les métadonnées répertoriées dans les conditions préalables qui ont été ajoutées pour l'intégration sans gestion des versions 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 répercuté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 être supprimées. Elles doivent être mises à jour pour refléter l'état de l'intégration (nouveau plan de test ou test en conditions réelles) pouvant être certifié et lancé.
Une version d'intégration n'est supprimée de Developer Console que lorsqu'elle a été lancée, puis est remplacée par le lancement d'une autre version.