Ferramenta de validação das extensões de câmera

A ferramenta de validação de extensões da câmera permite que os fabricantes de dispositivos verifiquem se a biblioteca OEM de extensões da câmera está implementada corretamente. A ferramenta inclui testes de validação automatizados e manuais.

• Testes de validação automatizados:validam se a interface da biblioteca do fornecedor foi implementada corretamente. Por exemplo, se CaptureProcessor for necessário para a captura de imagem, os testes vão validar que ImageCaptureExtenderImpl#getCaptureStages() retorna as instâncias CaptureStage necessárias para capturar as imagens.

• Testes de validação manual:valide os efeitos e a qualidade das imagens de visualização e capturadas. Por exemplo, os testes permitem que os fabricantes de dispositivos validem manualmente se o efeito de retoque de rosto foi aplicado corretamente ou se a intensidade do bokeh é suficiente.

O código-fonte da ferramenta de validação faz parte do app de teste de extensões no repositório do Android Jetpack.

Criar a ferramenta de validação das extensões da câmera

Para criar a ferramenta de validação de extensões, siga estas etapas:

1. Faça o download do código-fonte da biblioteca do Android Jetpack. Para mais detalhes, consulte a seção Como conferir o código do README do Android Jetpack.

2. Crie o APK extensionstestapp. Isso permite a execução de testes de validação manual.

     cd path/to/checkout/frameworks/support/
     ./gradlew camera:integration-tests:camera-testapp-extensions:assembleDebug
   

   O APK é gerado no seguinte caminho:

     path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
   

3. Crie o APK androidTest. Esse APK permite executar testes de validação automatizados.

     cd path/to/checkout/frameworks/support/
     ./gradlew camera:integration-tests:camera-testapp-extensions:assembleAndroidTest
   

   O APK é gerado no seguinte caminho:

     path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
   

Executar testes de validação automatizados

Para executar os testes de validação automatizados, instale os APKs extensionstestapp e androidTest.

• extensionstestapp APK

    adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
  

• androidTest APK

    adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
  

Executar todos os testes automatizados

Depois de instalar os APKs, execute todos os testes automatizados para validar a implementação da biblioteca do fornecedor executando o seguinte comando:

adb shell am instrument -w -r androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner

Se todos os testes forem aprovados, o resultado OK será retornado. Caso contrário, o relatório final do teste mostra falhas no terminal após a conclusão de todos os testes.

Figura 1. Resultado OK dos testes automatizados

Figura 2. Os testes automatizados resultam em falhas

Executar testes automatizados de uma classe específica

Para executar testes automatizados de uma classe específica, especifique o nome e o caminho da classe de destino. O exemplo a seguir mostra o comando para executar testes para a classe ImageCaptureTest:

adb shell am instrument -w -r -e class **androidx.camera.integration.extensions.ImageCaptureTest** androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner

Executar testes manuais de validação

Os testes de validação manual estão disponíveis no app de teste de extensões. Depois de instalar e iniciar o app de teste de extensões, mude para o modo de ferramenta de validação tocando no item de menu no canto superior direito.

Depois de mudar para o modo de ferramenta de validação, a primeira página lista todas as câmeras que contêm o recurso REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE. Se uma câmera não oferecer suporte a nenhum modo de extensão, o item de lista correspondente ficará acinzentado.

Figura 3. Modo da ferramenta de validação

Toque em uma das câmeras para conferir os modos de extensão para teste. Os modos de extensão que não têm suporte da câmera selecionada são mostrados em cinza.

Figura 4. Modos de extensão disponíveis para uma câmera

Verificar os resultados da visualização

Para verificar os resultados da visualização, inicie um teste manual tocando em um modo de extensão da câmera selecionada. Uma atividade de captura de imagem contendo a visualização é mostrada.

Figura 5. Prévia da imagem com o efeito bokeh ativado

A atividade de captura de imagem oferece suporte às seguintes funções:

• Aumentar/diminuir zoom
• Toque para focar
• Botão de alternância dos modos de flash
• EV +/-
• Botão de ativação/desativação da extensão

Verifique se o zoom in/out, o toque para focar, os modos de flash e as funções EV +/- funcionam conforme o esperado na visualização.

Verificar os resultados da imagem capturada

Para capturar a imagem, toque no botão CAPTURE (o botão redondo) na atividade de captura de imagem. Isso inicia uma atividade de validação de imagem que mostra a imagem capturada.

Figura 6. Imagem capturada com o efeito bokeh ativado

A atividade de validação de imagem inclui as seguintes funções:

• Faça gesto de pinça para redimensionar a imagem
• Deslize para a esquerda/direita para alternar entre as imagens capturadas
• Recuperação
• Item de menu "Salvar imagem"

Verifique se a imagem capturada está correta e corresponde ao zoom in/out, toque para focar, modos de flash e configurações de EV +/- que foram definidas ao capturar a imagem.

Se os resultados capturados estiverem corretos, toque no botão PASS (marca de seleção) no canto inferior direito. Caso contrário, toque no botão FAIL (ponto de exclamação) no canto inferior esquerdo.

Ver os resultados dos testes

Depois que um modo de extensão é verificado como aprovado ou reprovado, o item de lista do modo de extensão mostra uma cor de plano de fundo e um indicador diferentes. Na visualização de lista de todas as câmeras, os itens são mostrados nas seguintes cores:

• Fundo branco:a câmera oferece suporte a pelo menos um modo de extensão, e os modos de extensão com suporte não são validados completamente.
• Fundo verde:a câmera oferece suporte a pelo menos um modo de extensão. Todos os modos de extensão com suporte são validados com todos os resultados aprovados.
• Fundo vermelho:a câmera oferece suporte a pelo menos um modo de extensão. Todos os modos de extensão com suporte são validados com pelo menos um modo de extensão com falha.
• Plano de fundo cinza:esse recurso não está disponível.

Figura 7. Cores que indicam os resultados do teste para câmeras e modos de extensão

Outras funções da ferramenta de validação

Depois que todos os testes forem concluídos, a atividade da lista de câmeras vai oferecer as seguintes funções:

• Exportar resultados de teste:exporta os resultados do teste como um arquivo CSV para a pasta Documents/ExtensionsValidation.
• Redefinir:limpa todos os resultados de teste armazenados em cache.
• App de exemplo de extensões:alterna para o modo de app de exemplo de extensões.

Depois de concluir os testes, você pode exportar os resultados. Se você encontrar um problema e uma nova versão da implementação da biblioteca do fornecedor com as soluções precisar ser verificada novamente, redefina os resultados do teste anterior e execute novamente todos os modos de extensão compatíveis em todas as câmeras para verificar se os problemas foram corrigidos.