Com o controle de versões, os desenvolvedores podem gerenciar várias versões de uma integração em diferentes estágios de desenvolvimento.
Na guia Desenvolver em Google Home Developer Console, as integrações são consideradas "sem versão". Depois de iniciar a fase de teste do desenvolvimento na guia Teste, as integrações passam a ter controle de versões. A partir desse ponto, uma versão de integração é usada em todas as etapas restantes do fluxo de trabalho, desde o teste até o lançamento.
Por exemplo, é possível que uma versão de uma integração esteja sendo certificada para um lançamento iminente, enquanto uma versão mais recente da integração com funcionalidades diferentes está sendo testada para outro lançamento alguns meses dela.
Pré-requisitos
As versões de integração são um snapshot de uma integração sem controle de 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 iniciada.
Antes de criar um plano de teste de certificação, faça o seguinte:
- Criar um perfil da empresa.
- Inseriu o ID do fornecedor (VID, na sigla em inglês) de produção para a integração.
- Definiu a configuração e o branding.
Se você não tiver concluído tudo isso para sua integração, uma versão de integração criada para testes de certificação não poderá ser certificada. Será necessário criar uma nova versão e recomeçar a partir da etapa de teste.
Também será necessário criar uma nova versão e recomeçar 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 está listada em todas as listas de integração em Developer Console, a partir da guia "Teste".
Novas versões nunca são criadas a partir de outras versões numeradas. Por exemplo, o primeiro plano de teste criado para uma integração criará a versão v.1 dela. A criação de outro plano de teste criará a versão v.2 para essa integração, mas essa versão não será baseada na v.1. Ela é baseada na instância sem versão da integração, igual à 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 na versão N/A da integração, uma nova versão será
criada. O número da versão será um maior do que qualquer versão numerada atual.
- 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 v.1 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 que foram adicionados para a integração sem versão são anexados a ela. No entanto, os metadados anexados a uma versão não podem ser visualizados ou alterados.
Qualquer alteração 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 foram projetadas para serem excluídas. Eles precisam ser atualizados para refletir um estado de 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 ele é iniciado e posteriormente substituída pelo lançamento de uma versão diferente.