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 Testen mit der Testphase der Entwicklung beginnen, werden Integrationen versioniert. Ab diesem Zeitpunkt wird für jeden verbleibenden Schritt im Workflow von „Testen“ bis „Starten“ eine Integrationsversion verwendet.
Beispielsweise kann eine Version einer Integration für einen bevorstehenden Start zertifiziert werden, während eine neuere Version der Integration mit anderen Funktionen für einen anderen Start in einigen Monaten getestet wird.
Vorbereitung
Integrationsversionen sind ein Snapshot einer nicht versionierten Integration. Wenn Sie also einen Testplan für die Zertifizierung und damit eine Integrationsversion erstellen, müssen alle Branding-Metadaten im Zusammenhang mit dieser Integration die Informationen sein, die Sie für die gestartete Integration verwenden möchten.
Bevor Sie einen Zertifizierungstestplan erstellen, müssen Sie Folgendes getan haben:- Ein Unternehmensprofil erstellt.
- Die Produktions-Anbieter-ID (VID) für die Integration eingegeben.
- Einrichtung und Branding konfiguriert.
Wenn Sie nicht alle diese Schritte für Ihre Integration ausgeführt haben, kann eine für die Zertifizierung erstellte Integrationsversion nicht zertifiziert werden. Sie müssen eine neue Version erstellen und mit dem Schritt „Testen“ neu beginnen.
Sie müssen auch eine neue Version erstellen und neu beginnen, wenn Sie Ihr Branding aktualisieren möchten, bevor eine Integrationsversion zertifiziert wird.
Neue Version erstellen
Wenn Sie einen Testplan erstellen für die Zertifizierung, wird eine neue Version der Integration erstellt. Diese nummerierte Version wird in allen Integrationslisten in der Developer Console ab dem Tab „Testen“ aufgeführt.
Neue Versionen werden nie aus anderen nummerierten Versionen erstellt. Wenn Sie beispielsweise den ersten Testplan für eine Integration erstellen, wird die Version v.1 für diese Integration erstellt. Wenn Sie einen weiteren Testplan erstellen, wird die 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 N/A einer Integration stellt die nicht versionierte Instanz der Integration dar, die auf dem Tab Entwickeln verwaltet wird.
Anders ausgedrückt: In der Developer Console unter Matter > Test:
- Wenn Sie für die Version N/A der Integration auf Testen klicken, wird eine neue Version erstellt. Die Versionsnummer ist um eins höher als die aller vorhandenen nummerierten Versionen.
- Wenn keine nummerierten Versionen vorhanden sind, wird die Version v.1 erstellt.
- Wenn die Version v.1 vorhanden ist, wird die Version v.2 erstellt. Wenn die Version v.2 vorhanden ist, wird die 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 die Version v.1 noch einmal getestet.
Metadaten
Wenn eine Version erstellt wird, 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 nicht angezeigt oder geändert werden.
Änderungen an den Metadaten einer Integration werden nicht in vorhandenen Versionen berücksichtigt. Es muss eine neue Version erstellt werden, damit die aktualisierten Metadaten für die Zertifizierung und den Start verwendet werden können.
Version löschen
Integrationsversionen können nicht gelöscht werden und sind nicht für das Löschen vorgesehen. Sie sollten aktualisiert werden, um einen Status der Integration widerzuspiegeln (neuer Testplan oder Field Trial), der zertifiziert und gestartet werden kann.
Eine Integrationsversion wird erst dann aus der Developer Console entfernt, wenn sie gestartet wurde und später durch den Start einer anderen Version ersetzt wird.