Mit der Versionsverwaltung können Entwickler mehrere Versionen einer Integration in verschiedenen Entwicklungsphasen verwalten.
Auf dem Tab Entwickeln im Google Home Developer Console werden Integrationen als „nicht versioniert“ betrachtet. Sobald Sie die Testphase der Entwicklung auf dem Tab Test beginnen, werden die Integrationen versioniert. Ab diesem Zeitpunkt wird für jeden verbleibenden Schritt im Workflow eine Integrationsversion verwendet, vom Test bis zur Einführung.
Beispielsweise kann es sein, dass eine Version einer Integration für einen bevorstehenden Start zertifiziert wird, während eine neuere Version der Integration mit anderen Funktionen einige Monate im Voraus für eine andere Markteinführung getestet wird.
Voraussetzungen
Integrationsversionen sind Momentaufnahmen einer nicht versionierten Integration. Wenn du also einen Testplan für die Zertifizierung und somit eine Integrationsversion erstellst, müssen alle Branding-Metadaten im Zusammenhang mit dieser Integration die Informationen sein, die du für die gestartete Integration verwenden möchtest.
Bevor du einen Zertifizierungstestplan erstellst, musst du Folgendes tun:
- Ein Unternehmensprofil wurde erstellt.
- Eingabe der Produktionsanbieter-ID (VID) für die Integration.
- Konfigurierte Einrichtung und Branding:
Wenn du nicht alle diese Schritte für deine Integration abgeschlossen hast, kann eine für den Zertifizierungstest erstellte Integrationsversion nicht zertifiziert werden. Sie müssen eine neue Version erstellen und mit dem Testschritt neu beginnen.
Außerdem musst du eine neue Version erstellen und neu beginnen, wenn du dein Branding aktualisieren möchtest, bevor eine Integrationsversion zertifiziert wird.
Neue Version erstellen
Wenn du einen Testplan für die Zertifizierung erstellst, wird eine neue Version der Integration erstellt. Diese nummerierte Version ist ab dem Tab „Test“ in allen Integrationslisten in Developer Console aufgeführt.
Neue Versionen werden nie aus anderen nummerierten Versionen erstellt. Beispielsweise wird im ersten Testplan, den du für eine Integration erstellst, Version v.1 für diese Integration erstellt. Wenn Sie einen weiteren Testplan erstellen, wird für diese Integration Version v.2 erstellt. Diese Version basiert jedoch nicht auf v.1. Stattdessen basiert diese Version auf der nicht versionierten Instanz der Integration, genau wie v.1.
Die Version – einer Integration stellt die nicht versionierte Instanz der Integration dar, die auf dem Tab Entwickeln verwaltet wird.
Mit anderen Worten, unter Matter > Test in Developer Console:
- Wenn Sie auf Test für Version – der Integration klicken, wird eine neue Version erstellt. Die Versionsnummer ist um 1 höher als die aller vorhandenen nummerierten Versionen.
- Wenn keine nummerierten Versionen vorhanden sind, wird Version v.1 erstellt.
- Wenn Version v.1 vorhanden ist, wird Version v.2 erstellt. Wenn Version v.2 vorhanden ist, wird Version v.3 erstellt usw.
- Wenn Sie für eine nummerierte Version der Integration (z. B. v.1) auf Test klicken, wird keine neue Version erstellt. Stattdessen wird Version v.1 noch einmal getestet.
Metadaten
Beim Erstellen einer Version werden alle in den Voraussetzungen aufgeführten Metadaten, die für die nicht versionierte Integration hinzugefügt wurden, an die Version angehängt. Die an eine Version angehängten Metadaten können jedoch weder angezeigt noch geändert werden.
Änderungen an den Metadaten einer Integration werden in vorhandenen Versionen nicht übernommen. Damit die aktualisierten Metadaten für Zertifizierung und Einführung verwendet werden können, muss eine neue Version erstellt werden.
Version löschen
Integrationsversionen können nicht gelöscht werden und sind nicht zum Löschen vorgesehen. Sie sollten aktualisiert werden, um den Status der Integration (neuer Testplan oder Feldtest) wiederzugeben, der zertifiziert und eingeführt werden kann.
Eine Integrationsversion wird erst dann aus dem Developer Console entfernt, wenn sie gestartet wurde, und wird später durch die Einführung einer anderen Version ersetzt.