Versionsverwaltung

Die Versionsverwaltung ermöglicht es Entwicklern, mehrere Versionen einer Integration in verschiedenen Entwicklungsphasen zu verwalten.

Auf dem Tab Develop im Google Home Developer Console werden Integrationen als „nicht versioniert“ betrachtet. Sobald Sie die Testphase der Entwicklung auf dem Tab Test starten, werden die Integrationen versioniert. Ab diesem Zeitpunkt wird für jeden verbleibenden Schritt im Workflow – vom Testen bis zur Markteinführung – eine Integrationsversion verwendet.

Beispielsweise kann es sein, dass eine Version einer Integration für eine bevorstehende Einführung zertifiziert wird, während eine neuere Version der Integration mit anderen Funktionen für eine weitere Einführung in einigen Monaten getestet wird.

Voraussetzungen

Integrationsversionen sind eine Momentaufnahme einer nicht versionierten Integration. Wenn du also einen Testplan für die Zertifizierung und somit eine Integrationsversion erstellst, müssen alle Brandingmetadaten, die sich auf diese Integration beziehen, den Informationen entsprechen, die du für die gestartete Integration verwenden möchtest.

Bevor du einen Zertifizierungstestplan erstellst, musst du Folgendes tun:

  1. Sie haben ein Unternehmensprofil erstellt.
  2. Die Produktionsanbieter-ID (VID) für die Integration wurde eingegeben.
  3. Konfigurierte Einrichtung und Branding

Wenn du nicht alle diese Schritte für deine Integration ausgeführt hast, kann eine Integrationsversion, die für Zertifizierungstests erstellt wurde, nicht zertifiziert werden. Sie müssen eine neue Version erstellen und mit dem Schritt „Test“ von vorn beginnen.

Du musst außerdem eine neue Version erstellen und von vorn 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“ unter Developer Console in allen Integrationslisten aufgeführt.

Neue Versionen werden niemals aus anderen nummerierten Versionen erstellt. Durch den ersten Testplan, den du für eine Integration erstellst, wird beispielsweise Version v.1 für diese Integration erstellt. Wenn Sie einen weiteren Testplan erstellen, wird Version v.2 für diese Integration erstellt, aber diese Version basiert nicht auf v.1. Stattdessen basiert diese Version wie in v.1 auf der nicht versionierten Instanz der Integration.

Die Version – einer Integration steht für die nicht versionierte Instanz der Integration, die auf dem Tab Entwickeln verwaltet wird.

Mit anderen Worten: Unter Matter > Test in Developer Console:

  • Wenn du bei Version – der Integration auf Testen klickst, wird eine neue Version erstellt. Die Versionsnummer ist eins höher als alle 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 existiert, wird Version v.3 erstellt usw.
  • Wenn Sie für eine nummerierte Version der Integration auf Testen klicken, z. B. v.1, wird v.1 neue Version erstellt. Stattdessen wird Version v.1 noch einmal getestet.

Metadaten

Beim Erstellen einer Version werden alle Metadaten, die in den Voraussetzungen aufgeführt sind, 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 nicht angezeigt oder geändert werden.

Änderungen an den Metadaten einer Integration wirken sich nicht auf bestehende Versionen aus. Damit die aktualisierten Metadaten für die Zertifizierung und die 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 widerzuspiegeln (neuer Testplan oder Field Trial), der zertifiziert und eingeführt werden kann.

Eine Integrationsversion wird erst dann aus Developer Console entfernt, wenn sie gestartet wurde, und später durch die Einführung einer anderen Version ersetzt.