O Google Home Developer Console fornece uma página Teste em que é possível configurar e executar testes na integração do Matter usando o Google Home Test Suite. O Test Suite é um aplicativo separado integrado ao Developer Console que processa todos os testes de integração.
Os dispositivos para os IDs de fornecedor e de produto da integração precisam ser comissionados e disponíveis em Google Home app (GHA) para a conta que está sendo usada com Developer Console para serem testados. Consulte Parear um dispositivo Matter para saber mais.
O Test Suite pode ser executado em um conjunto de dispositivos que pertencem a uma configuração de projeto Matter específica. É muito importante executar o Test Suite nas suas integrações para garantir que tudo esteja funcionando corretamente.
Na página Teste, as integrações Matter concluídas e prontas para teste são listadas na seção Pronto para testar.
As integrações Matter que foram testadas estão listadas na seção Testadas.
Tipo de plano de teste
Existem dois tipos de plano de teste:
Os planos de teste de desenvolvimento são usados para testar dispositivos de controle usando Matter. Eles são editáveis, mas não podem ser enviados para a certificação Matter.
Os planos de teste da certificação são destinados apenas à certificação Matter e não são editáveis. Selecionar essa opção cria uma nova versão da integração com o Matter.
Versões de integraçã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 criará a versão v.1 para ela. 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. Em vez disso, essa versão é baseada na instância sem controle de versão da integração, como na v.1.
A versão N/A de uma integração representa a instância sem controle de 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 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, 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.
Para mais informações, consulte Controle de versão de integração.
Criar um plano de teste
As versões de integração são um resumo de uma integração sem controle de versão. Isso significa que, quando você cria um plano de teste para certificação e, portanto, uma versão de integração, todos os metadados 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 para certificação, faça o seguinte:
- Criou um perfil da empresa.
- O ID do fornecedor (VID, na sigla em inglês) de produção foi inserido 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 teste de certificação não poderá ser certificada. Será necessário criar uma nova versão, o que significa refazer as etapas de teste, teste em campo e certificação.
Também será necessário criar uma nova versão e começar do zero se você quiser atualizar o branding antes que uma versão de integração seja certificada.
Para criar um plano de teste, faça o seguinte:
Na lista de projetos, clique em Abrir ao lado do projeto em que você quer trabalhar.
No menu de navegação no lado esquerdo da página, acesse Matter > Testar.
Clique em Testar para a versão N/A da integração que você quer testar. Esta ação cria uma nova versão de integração.
Selecione um tipo de teste: Teste de desenvolvimento ou Teste de certificação.
- Selecione Teste de certificação se você estiver se preparando para receber a certificação no ecossistema do Google.
- Não é possível usar testes de desenvolvimento para certificação.
Clique em Testar. Se você receber uma tela de erro Nenhum dispositivo encontrado, isso significa que um dispositivo para essa integração ainda não foi comissionado no ecossistema. Consulte Solução de problemas de pareamento para mais informações.
Na tela Configure your test, forneça um nome para seu teste e selecione os dispositivos que você quer testar na lista.
Clique no botão Próximo: plano de teste.
Na página Criar um plano de teste, na seção Pacotes de teste, selecione os conjuntos de testes que você quer executar.
Se você quiser sair do Test Suite, clique em Voltar ao Centro para Desenvolvedores.
Executar o plano de teste
No Test Suite, na página Criar um plano de teste, clique em Executar teste. A página Ambiente de teste será exibida, com o status e os registros de todos os testes.
Os resultados do teste serão exibidos após a conclusão. O status de cada execução do pacote de testes é exibido ao lado dele (Aprovado, Com falha).
O painel Registros mostra o status de cada execução de teste.
Para testar um plano de teste novamente na página Ambiente de teste, clique em Teste novamente na parte de cima após a conclusão da execução do teste.
Quando terminar:
- Clique em Concluído para acessar a página Histórico de testes.
- Clique em Enviar para enviar os resultados do teste para certificação.
Ver e interpretar os resultados do seu teste
Na página Histórico de testes em Test Suite, é possível ver resultados de testes anteriores para um plano de desenvolvimento ou um plano de teste de certificação não enviado clicando em Testar novamente no plano de teste desejado na seção Planos de teste. Você será direcionado para a página Ambiente de teste, que exibe os resultados do teste.
Para um plano de certificação enviado, clique em Resultados na seção Salvos para certificação para ver o relatório de resultados do teste.
Os resultados do teste também podem ser acessados para uma versão de integração na guia Test no Developer Console. Clique em Visualizar para acessar o Histórico de testes de qualquer versão de integração listada nessa página para acessar a página Histórico de testes na Test Suite.
Status do console
Os seguintes status do console são encontrados na fase de teste:
| Section | Status | Descrição | Requisito | O que fazer agora |
|---|---|---|---|---|
| Pronto para testar | Pronto | Esta versão do integration está pronta para ser testada. | N/A | Teste essa versão do integration. |
| Testado | Pronto | Esta versão do integration foi testada e pode ser enviada para teste de campo ou certificação. |
A versão foi testada e salva. Todos os casos de teste reprovados incluem justificativas para a análise do Google. |
Teste novamente, se quiser. |
Solução de problemas
O dispositivo comissionado não aparece no Test Suite
Se você pareou um dispositivo com um ID do fornecedor (VID, na sigla em inglês) e um ID do produto (PID, na sigla em inglês) de teste, mas ele não aparece quando você tenta testar o dispositivo com o Pacote de testes no Developer Console, isso provavelmente é causado pelo uso da mesma combinação de VID e PID de teste em várias integrações.
Para resolver problemas, remova todos os dispositivos de teste do Developer Console e pareie o dispositivo que você quer testar novamente.
Para validar se você pareou o correto, defina as informações do fabricante e
do modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) do dispositivo como
valores exclusivos no firmware de teste.
Consulte Informações do dispositivo para mais informações.
Verifique o VID/PID do dispositivo
Se você quiser começar a desenvolver sua integração com o Google, crie um projeto e uma integração no Google Home Console.
O valor do VID/PID que o dispositivo está beacon precisa corresponder ao VID/PID inserido no seu projeto Developer Console.
- VIDs
0xFFF1—0xFFF4são reservados para testes. Elas podem ser usadas para testes básicos de comissionamento e controle, mas não durante as seguintes fases de desenvolvimento:- Teste
- Teste de campo
- OTA (em inglês)
Usando um app de engenharia de Bluetooth, como o nRF Connect para dispositivos móveis, é possível ver o VID/PID do dispositivo de beacon no campo Dados de serviço.
Nesta captura de tela da versão Android do nRF Connect, o VID/PID está listado como 5A23FFFE a partir do quarto byte do campo Dados de serviço. Isso indica um VID de 5A23 e um PID de FFFE,
ambos em formato Little endian.
O app BLE exibe os valores no small endian,mas os valores de VID/PID inseridos no projeto Developer Console estão no big endian.
Confira se os valores e o formato corretos foram inseridos no projeto do Actions Console com base no que o sensor de Bluetooth está mostrando.
Para os valores na captura de tela de exemplo, o VID e o PID em
Developer Console seriam 235A e FEFF, respectivamente.