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 Desarrollar de Google Home Developer Console, las integraciones se consideran "sin versiones". Una vez que comiences la fase de prueba del desarrollo en la pestaña Probar, las integraciones tendrán versiones. A partir de ese momento, se usa una versión de integración para cada paso restante del flujo de trabajo, desde la prueba hasta el lanzamiento.

Por ejemplo, es posible que tengas una versión de una integración que se somete a la certificación para un lanzamiento inminente, mientras que se prueba una versión más reciente de la integración con diferentes funciones para otro lanzamiento dentro de unos meses.

Requisitos previos

Las versiones de integración son una instantánea de una integración sin versiones. Esto significa que, cuando creas un plan de pruebas para la certificación y, por lo tanto, una versión de integración, todos los metadatos de marca relacionados con esa integración deben ser la información que deseas usar para la integración lanzada.

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

  1. Crear un perfil de empresa.
  2. Ingresar el ID de proveedor (VID) de producción para la integración.
  3. Establecer la configuración y el desarrollo de la marca.

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 comenzar si deseas actualizar tu marca antes de que se certifique una versión de integración.

Crear una nueva versión

Cuando creas un plan de pruebas 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 desde la pestaña Prueba en adelante.

Nunca se crean versiones nuevas a partir de otras versiones numeradas. Por ejemplo, el primer plan de pruebas que crees para una integración creará la versión v.1 para esa integración. Si creas otro plan de pruebas, se creará la versión v.2 para esa integración, pero esta versión no se basará en v.1. En cambio, esta versión se basa en la instancia sin versiones de la integración, al igual que 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 > Probar en el Developer Console:

  • Si haces clic en Probar para la versión N/A de la integración, se crea una versión nueva. El número de versión será uno más alto que 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 versión 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), no se crea una versión nueva. En cambio, se vuelve a probar la versión v.1.

Metadatos

Cuando se crea una versión, los metadatos que aparecen en los requisitos previos y 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.

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

Borrar una versión

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

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