Управление версиями интеграций

Управление версиями позволяет разработчикам управлять несколькими версиями интеграции на разных этапах разработки.

На вкладке Разработка в Google Home Developer Console интеграции считаются не имеющими версий. Когда вы начнете тестирование на вкладке Тестирование, интеграции будут разделены по версиям. С этого момента версия интеграции используется для каждого оставшегося шага в рабочем процессе, от тестирования до запуска.

Например, у вас может быть одна версия интеграции, которая проходит сертификацию для скорого запуска, и более новая версия с другими функциями, которая тестируется для запуска через несколько месяцев.

Требования

Версии интеграции – это снимок интеграции без версии. Это означает, что при создании плана тестирования для сертификации и, следовательно, версии интеграции все метаданные брендинга, связанные с этой интеграцией, должны быть информацией, которую вы хотите использовать для запущенной интеграции.

Прежде чем создавать план сертификационного тестирования, убедитесь, что вы выполнили следующие действия:

  1. Создан профиль компании.
  2. Указали идентификатор поставщика (VID) для интеграции.
  3. Настройка и брендинг.

Если вы не выполнили все эти действия, версия интеграции, созданная для сертификационного тестирования, не может быть сертифицирована. Вам придется создать новую версию и начать заново с этапа тестирования.

Вам также придется создать новую версию и начать заново, если вы захотите обновить брендинг до сертификации версии интеграции.

Создать новую версию

Когда вы создаете план тестирования для сертификации, создается новая версия интеграции. Эта пронумерованная версия указана во всех списках интеграции в Developer Console, начиная с вкладки "Тестирование".

Новые версии никогда не создаются на основе других пронумерованных версий. Например, первый план тестирования, который вы создадите для интеграции, будет иметь версию v.1. Если вы создадите ещё один план тестирования, то для этой интеграции будет создана версия v.2, но она не будет основана на версии v.1. Вместо этого она основана на экземпляре интеграции без версии, как и v.1.

Версия — представляет собой экземпляр интеграции без версии, управление которым осуществляется на вкладке Разработка.

Другими словами, в Developer Console выберите Matter > Тестирование.

  • Если вы нажмете Протестировать для версии —, будет создана новая версия. Номер версии будет на единицу больше, чем у любой существующей нумерованной версии.
    • Если пронумерованных версий нет, создается версия v.1.
    • Если версия v.1 существует, создается версия v.2. Если версия v.2 уже существует, будет создана версия v.3 и т. д.
  • Если вы нажмете Протестировать для пронумерованной версии интеграции (например, v.1), новая версия не будет создана. Вместо этого снова тестируется версия v.1.

Метаданные

При создании версии все метаданные, перечисленные в разделе Предварительные требования и добавленные для интеграции без версии, прикрепляются к версии. Однако метаданные, прикрепленные к версии, нельзя просматривать или изменять.

Изменения в метаданных интеграции не отражаются в существующих версиях. Чтобы обновленные метаданные использовались для сертификации и запуска, необходимо создать новую версию.

Как удалить версию

Версии интеграции нельзя удалить. Их нужно обновить, чтобы они отражали состояние интеграции (новый план тестирования или полевое испытание), которое можно сертифицировать и запустить.

Версия интеграции удаляется из Developer Console, только если она была запущена, а затем заменена другой версией.