El control de versiones permite a los desarrolladores administrar varias versiones de una integración en diferentes etapas del desarrollo.
En la pestaña Desarrollo de Google Home Developer Console, las integraciones se consideran "sin versiones". Una vez que comiences la fase de desarrollo de prueba en la pestaña Prueba, se realizará el control de versiones de las integraciones. Se usa una versión de integración a partir de ese momento para cada paso restante del flujo de trabajo, desde la prueba hasta el lanzamiento.
Por ejemplo, puedes tener una versión de una integración sometida a la certificación de un lanzamiento inminente, mientras que una versión más reciente de la integración con diferentes funcionalidades se está probando para otro lanzamiento dentro de unos meses.
Requisitos previos
Las versiones de integración son un resumen de una integración sin versión. 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:
- Crear un perfil de la empresa.
- Ingresado el ID del proveedor de producción (VID) de la integración.
- Configuración de marca y configuración.
Si no completaste todos estos procesos en tu integración, no podrá certificarse 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 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 en la Developer Console desde la pestaña Prueba en adelante.
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 versión no se basará en v.1. En cambio, 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 versión de la integración, que se administra en la pestaña Desarrollo.
En otras palabras, en Matter > Probar en Developer Console:
- Si haces clic en Probar para ver la versión N/A de la integración, se creará una nueva. El número de versión será superior a cualquier versión numerada existente.
- Si no existen versiones numeradas, se creará la versión v.1.
- Si existe la versión v.1, se creará la versión v.2. Si existe la versión v.2, se creará la versión v.3, y así sucesivamente.
- Si haces clic en Probar para ver una versión numerada de la integración (por ejemplo, v.1), no se creará una nueva. En su lugar, 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 versión 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 a fin de 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. Deben actualizarse para reflejar un 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.