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". Quando você iniciar a fase de teste do desenvolvimento na guia Teste, as integrações vão receber versões. Uma versão de integração é usada daquele ponto em diante para cada etapa restante no fluxo de trabalho, de Teste a Lançamento.
Por exemplo, você pode ter uma versão de uma integração passando por 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 branding 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, verifique se você fez o seguinte:- Criou um Perfil da Empresa.
- Inseriu o ID do fornecedor (VID) de produção para a integração.
- Configuração e branding configurados.
Se você não tiver concluído todos esses itens para sua integração, uma versão criada para testes de certificação não poderá ser certificada. Você vai precisar criar uma nova versão e começar de novo na etapa de teste.
Você também precisará 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
Quando você cria 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 na Developer Console a partir da guia "Teste".
Novas versões nunca são criadas com base em outras versões numeradas. Por exemplo, o primeiro plano de teste criado para uma integração vai gerar a versão v.1 dessa integração. Criar outro plano de teste vai gerar a versão v.2 dessa integração, mas ela não será baseada na v.1. Em vez disso, esta 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 é testada novamente.
Metadados
Quando uma versão é criada, todos os metadados listados nos pré-requisitos adicionados à integração sem versão são anexados a ela. No entanto, os metadados anexados a uma versão não podem ser visualizados nem alterados.
As mudanças nos metadados de uma integração não serão refletidas nas versões atuais. Uma nova versão precisa ser criada para que os metadados atualizados sejam usados na certificação e no lançamento.
Excluir uma versão
Não é possível excluir versões de integração, e elas não foram projetadas para isso. Eles precisam ser atualizados para refletir um estado da integração (novo plano de teste ou teste de campo) que pode ser certificado e lançado.
Uma versão da integração só é removida do Developer Console quando é lançada e depois substituída pelo lançamento de uma versão diferente.