O controle de versões permite que os desenvolvedores gerenciem várias versões de uma integração em diferentes estágios de desenvolvimento.
Na guia Desenvolver do Google Home Developer Console, as integrações são consideradas "sem versão". Depois de iniciar a fase de teste do desenvolvimento na guia Testar, as integrações passam a ter versões. Uma versão de integração é usada a partir desse momento para cada etapa restante no fluxo de trabalho, do teste ao lançamento.
Por exemplo, você pode ter uma versão de uma integração em processo de certificação para um lançamento iminente, enquanto uma versão mais recente da integração com funcionalidades diferentes está sendo testada para outro lançamento daqui a alguns meses.
Pré-requisitos
As versões de integração são um snapshot de uma integração sem versão. Isso significa que, ao criar um plano de teste para certificação e, portanto, uma versão de integração, todos os metadados de marca relacionados a essa integração precisam ser as informações que você quer usar para a integração lançada.
Antes de criar um plano de teste de certificação, faça o seguinte:- Crie um perfil da empresa.
- Insira o ID do fornecedor (VID) de produção da integração.
- Configure a configuração e a marca.
Se você não tiver concluído todas essas etapas para sua integração, uma versão de integração criada para testes de certificação não poderá ser certificada. Você terá que criar uma nova versão e começar de novo na etapa de teste.
Você também terá que criar uma nova versão e começar de novo se quiser atualizar sua marca antes que uma versão de integração seja certificada.
Criar uma versão
Ao criar um plano de teste para certificação, uma nova versão da integração é criada. Essa versão numerada é listada em todas as listas de integração no Developer Console a partir da guia "Testar".
Novas versões nunca são criadas a partir de outras versões numeradas. Por exemplo, o primeiro plano de teste que você criar para uma integração vai criar a versão v.1 para essa integração. A criação de outro plano de teste vai criar a versão v.2 para essa integração, mas essa versão não será baseada na v.1. Em vez disso, essa versão é baseada na instância sem versão da integração, assim como a v.1.
A versão N/A de uma integração representa a instância sem versão da integração, que é gerenciada na guia Desenvolver.
Em outras palavras, em Matter > Teste no Developer Console:
- Se você clicar em Testar para a versão N/A da integração, uma nova versão será criada. O número da versão será um número maior do que qualquer versão numerada existente.
- Se não houver versões numeradas, a versão v.1 será criada.
- Se a versão v.1 existir, a versão v.2 será criada. Se a versão v.2 existir, a versão v.3 será criada e assim por diante.
- Se você clicar em Testar para uma versão numerada da integração (por exemplo, v.1), uma nova versão não será criada. Em vez disso, a versão v.1 será testada novamente.
Metadados
Quando uma versão é criada, todos os metadados listados nos pré-requisitos que foram adicionados para a integração sem versão são anexados à versão. No entanto, os metadados anexados a uma versão não podem ser visualizados ou alterados.
Qualquer mudança nos metadados de uma integração não será refletida nas versões atuais. Uma nova versão precisa ser criada para que os metadados atualizados sejam usados para certificação e lançamento.
Excluir uma versão
As versões de integração não podem ser excluídas e não são projetadas para serem excluídas. Elas precisam ser atualizadas para refletir um estado da integração (novo plano de teste ou teste de campo) que possa ser certificado e lançado.
Uma versão de integração só é removida do Developer Console quando é lançada e substituída pelo lançamento de uma versão diferente.