Control de versiones de integración

El control de versiones permite a los desarrolladores administrar varias versiones de una integración en diferentes etapas de desarrollo.

En la pestaña Develop, en Google Home Developer Console, las integraciones se consideran “sin versiones”. Una vez que comiences la fase de prueba del desarrollo en la pestaña Prueba, se controlarán las versiones de las integraciones. A partir de ese momento, se usa una versión de integración para cada paso restante en el flujo de trabajo, desde la prueba hasta el lanzamiento.

Por ejemplo, es posible que tengas una versión de una integración en proceso de certificación para un lanzamiento inminente, mientras que una versión más reciente de la integración con diferentes funcionalidades se está probando para otro lanzamiento unos meses después.

Requisitos previos

Las versiones de integración son un resumen de una integración sin control de versiones. Esto significa que, cuando creas un plan de prueba para la certificación y, por lo tanto, una versión de integración, todos los metadatos de desarrollo de la marca relacionados con esa integración deben ser la información que deseas usar para la integración que se lanzó.

Antes de crear un plan de prueba de certificación, asegúrate de haber hecho lo siguiente:

  1. Crear un perfil de la empresa
  2. Ingresa el ID del proveedor (VID) de producción para la integración.
  3. Configuración y desarrollo de la marca configurados

Si no completaste todos estos pasos para tu integración, no se puede certificar una versión de integración creada para las pruebas de certificación. Deberás crear una versión nueva y volver a comenzar desde el paso de prueba.

También deberás crear una versión nueva y volver a empezar si quieres actualizar tu marca antes de que se certifique una versión de integración.

Crear una nueva versión

Cuando creas un plan de prueba para la certificación, se crea una versión nueva de la integración. Esta versión numerada aparece en todas las listas de integración de Developer Console a partir de la pestaña Prueba.

Las versiones nuevas nunca se crean a partir de otras versiones numeradas. Por ejemplo, el primer plan de prueba que crees para una integración creará la versión v.1 para esa integración. Si creas otro plan de prueba, se creará la versión v.2 para esa integración, pero esta no se basará en la v.1. En cambio, esta versión se basa en la instancia sin versión de la integración, al igual que la v.1.

La versión N/A de una integración representa la instancia sin versiones de la integración, que se administra en la pestaña Desarrollar.

En otras palabras, en Matter > Test en el Developer Console:

  • Si haces clic en Probar para la versión N/A de la integración, se creará una versión nueva. El número de versión será uno mayor que el de cualquier versión numerada existente.
    • Si no existen versiones numeradas, se crea la versión v.1.
    • Si existe la versión v.1, se crea la v.2. Si existe la versión v.2, se crea la versión v.3 y así sucesivamente.
  • Si haces clic en Probar para una versión numerada de la integración (por ejemplo, v.1), v.1 se creará una versión nueva. En su lugar, se vuelve a probar la versión v.1.

Metadata

Cuando se crea una versión, todos los metadatos enumerados en los requisitos previos que se agregaron para la integración sin versiones se adjuntan a la versión. Sin embargo, los metadatos adjuntos a una versión no se pueden ver ni cambiar.

Cualquier cambio en los metadatos de una integración no se reflejará en las versiones existentes. Se debe crear una versión nueva para que los metadatos actualizados se usen en la certificación y el lanzamiento.

Borrar una versión

Las versiones de integración no se pueden borrar ni están diseñadas para borrarse. Se deben actualizar para reflejar un estado de la integración (nuevo plan de prueba o prueba de campo) que se puede certificar y lanzar.

Una versión de integración solo se quita de Developer Console cuando se inicia y, luego, se reemplaza por el lanzamiento de una versión diferente.