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

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

На вкладке Разработка в 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, только если она была запущена, а затем заменена другой версией.