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 no 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 versões. Uma versão de integração é usada a partir desse ponto 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 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ê já:- Criou um perfil da empresa.
- Inseriu o ID do fornecedor (VID) de produção para a integração.
- Configuração e branding.
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ê vai precisar criar uma nova versão e recomeçar da 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 no Developer Console a partir da guia "Teste".
As 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 criar a versão v.1 para essa integração. A criação de outro plano de teste vai gerar 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 > Test 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 em 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 que foram adicionados à 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 alteração nos metadados de uma integração não será refletida nas versões existentes. 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
As versões de integração não podem ser excluídas e 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 possa ser certificado e lançado.
Uma versão de integração só é removida do Developer Console quando é lançada e depois substituída pelo lançamento de uma versão diferente.