Controle de versão de integração

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 Develop do Google Home Developer Console, as integrações são consideradas "sem versão". Quando você inicia a fase de teste de desenvolvimento na guia Test, as integrações recebem uma versão. Uma versão de integração é usada a partir desse ponto para todas as etapas restantes do fluxo de trabalho, do teste à 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 uma funcionalidade diferente está sendo testada para outro lançamento em 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, siga estas instruções: 1. Criou um perfil da empresa. 1. Digitou o ID do fornecedor (VID) de produção para a integração. 1. Configuração e marca configurados.

Se você não tiver concluído todos esses requisitos 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 "Teste".

Você também vai 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".

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 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 Develop.

Em outras palavras, em Matter > Test 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 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 para a integração não versionada são anexados à versão. No entanto, os metadados anexados a uma versão não podem ser visualizados nem alterados.

Qualquer mudança 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 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 isso. Elas precisam ser atualizadas 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 de integração só é removida do Developer Console quando é lançada e depois substituída pelo lançamento de uma versão diferente.