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 no Google Home Developer Console, as integrações são consideradas "sem controle de versão". Depois de iniciar a fase de teste de desenvolvimento na guia Testar, as integrações passam a ter controle de versão. A partir desse ponto, uma versão de integração é usada para todas as etapas restantes no fluxo de trabalho, do teste ao lançamento.
Por exemplo, é possível 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 funcionalidade diferente, está sendo testada para outro lançamento alguns meses depois.
Pré-requisitos
As versões de integração são um resumo 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 lançada.
Antes de criar um plano de teste de certificação, faça o seguinte:
- Criou um perfil da empresa.
- O ID do fornecedor (VID, na sigla em inglês) de produção da integração foi inserido.
- Configuração e branding definidos.
Se você não tiver concluído todas essas etapas para sua integração, uma versão de integração criada para teste de certificação não poderá ser certificada. Será necessário criar uma nova versão e começar de novo a partir da etapa de teste.
Também será necessário criar uma nova versão e começar de novo se você quiser atualizar seu branding antes de uma versão de integração ser 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".
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 criará a versão v.1 para ela. 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á maior que qualquer versão numerada
existente.
- Se não houver versões numeradas, será criada a versão v.1.
- Se a versão v.1 existir, será criada a v.2. 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 controle de versão são anexados a ela. No entanto, os metadados anexados a uma versão não podem ser visualizados ou alterados.
Alterações 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
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 da integração (novo plano ou teste de campo) que pode ser certificado e lançado.
Uma versão de integração só é removida do Developer Console quando ela é iniciada e, mais tarde, substituída pelo lançamento de uma versão diferente.