Versionsverwaltung

Mit der Versionierung können Entwickler mehrere Versionen einer Integration in verschiedenen Entwicklungsphasen verwalten.

Auf dem Tab Entwickeln in der Google Home Developer Console werden Integrationen als „nicht versioniert“ betrachtet. Sobald Sie auf dem Tab Test mit der Testphase der Entwicklung beginnen, werden Integrationen versioniert. Ab diesem Zeitpunkt wird eine Integrationsversion für alle verbleibenden Schritte im Workflow verwendet, vom Test bis zur Einführung.

Beispielsweise wird eine Version einer Integration für die bevorstehende Markteinführung zertifiziert, während eine neuere Version der Integration mit anderen Funktionen für eine Markteinführung in einigen Monaten getestet wird.

Vorbereitung

Integrationsversionen sind ein Snapshot einer Integration ohne Version. Wenn Sie also einen Testplan für die Zertifizierung und damit eine Integrationsversion erstellen, müssen alle mit dieser Integration verbundenen Branding-Metadaten die Informationen sein, die Sie für die eingeführte Integration verwenden möchten.

Bevor Sie einen Zertifizierungstestplan erstellen, müssen Sie Folgendes tun: 1. Sie haben ein Unternehmensprofil erstellt. 1. Die Produktions-Anbieter-ID (VID) für die Integration wurde eingegeben. 1. Einrichtung und Branding konfiguriert

Wenn Sie nicht alle Schritte für Ihre Integration ausgeführt haben, kann die für die Zertifizierungstests erstellte Integrationsversion nicht zertifiziert werden. Sie müssen eine neue Version erstellen und mit dem Testschritt von vorn beginnen.

Außerdem müssen Sie eine neue Version erstellen und von vorn beginnen, wenn Sie Ihr Branding aktualisieren möchten, bevor eine Integrationsversion zertifiziert wird.

Neue Version erstellen

Wenn Sie einen Testplan für die Zertifizierung erstellen, wird eine neue Version der Integration erstellt. Diese nummerierte Version wird in allen Integrationslisten in der Developer Console ab dem Tab „Test“ aufgeführt.

Neue Versionen werden nie aus anderen nummerierten Versionen erstellt. Wenn Sie beispielsweise den ersten Testplan für eine Integration erstellen, wird Version v.1 für diese Integration erstellt. Wenn Sie einen weiteren Testplan erstellen, wird Version v.2 für diese Integration 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 steht für die nicht versionierte Instanz der Integration, die auf dem Tab Entwickeln verwaltet wird.

Das heißt, unter Matter > Test im Bereich Developer Console:

  • Wenn Sie für Version der Integration auf Testen klicken, wird eine neue Version erstellt. Die Versionsnummer ist eine Einheit höher als die aller vorhandenen 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 Testen klicken, wird keine neue Version erstellt. Stattdessen wird Version v.1 noch einmal getestet.

Metadaten

Wenn eine Version erstellt wird, werden alle Metadaten, die in den Voraussetzungen für die Integration ohne Version aufgeführt sind, der Version hinzugefügt. Die Metadaten, die einer Version zugeordnet sind, können jedoch nicht angezeigt oder geändert werden.

Änderungen an den Metadaten einer Integration werden nicht in vorhandenen Versionen übernommen. Es muss eine neue Version erstellt werden, damit die aktualisierten Metadaten für die Zertifizierung und Markteinführung verwendet werden können.

Version löschen

Integrationsversionen können nicht gelöscht werden und sind auch nicht dafür vorgesehen. Sie sollten aktualisiert werden, um den Status der Integration (neuer Testplan oder Field Trial) widerzuspiegeln, der zertifiziert und eingeführt werden kann.

Eine Integrationsversion wird nur dann aus der Developer Console entfernt, wenn sie veröffentlicht wurde und später durch die Veröffentlichung einer anderen Version ersetzt wird.