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 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 Test, 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, puedes tener 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 prueba para otro lanzamiento dentro de unos meses.

Requisitos previos

Las versiones de integración son un resumen de una integración sin 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 lanzada.

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

  1. Creaste un perfil de la empresa.
  2. Ingresaste el ID del proveedor de producción (VID) de la integración.
  3. Configuración y desarrollo de la marca establecidos.

Si no completaste todos estos pasos para tu integración, no se podrá 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 comenzar de nuevo si deseas actualizar el desarrollo de la 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 integraciones en el 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. Cuando se crea otro plan de prueba, se crea 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 Developer Console, haz lo siguiente:

  • 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 más alto 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 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), v.1 se creará una versión nueva. En cambio, se vuelve a probar la versión v.1.

Metadatos

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 y no están diseñadas para borrarse. Deben actualizarse para reflejar el estado de la integración (nuevo plan de prueba o prueba de campo) que se pueda 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.