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

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

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

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

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

Crie a ferramenta de validação de extensões de câmera

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

  1. Baixe o código-fonte da biblioteca do Android Jetpack. Para obter detalhes, consulte a seção Verificando 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 é enviado para o 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 . Este APK permite a execução de testes de validação automatizados.

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

    O APK é enviado para o seguinte caminho:

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

Execute 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
    

Execute todos os testes automatizados

Após instalar os APKs, para executar todos os testes automatizados para validar a implementação da biblioteca do fornecedor, execute o seguinte comando:

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

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

validação_automatizada_resultado-pass

Figura 1. Testes automatizados com resultado OK

automatização_validação_resultado-falha

Figura 2. Resultado de testes automatizados com falhas

Execute 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

Execute testes de validação manuais

Os testes de validação manual são encontrados no aplicativo de teste de extensões . Depois de instalar e iniciar o aplicativo de teste de extensões, alterne para o modo de ferramenta de validação tocando no item de menu no canto superior direito.

Após alternar 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, seu item de lista correspondente ficará cinza.

camera_validation_result-initial

Figura 3. Modo da ferramenta de validação

Toque em uma das câmeras para ver os modos de extensão para teste. Os modos de extensão não suportados pela câmera selecionada são mostrados em cinza.

extension_mode_validation_result-initial

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

Verifique os resultados da visualização

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

preview-bokeh_enabled

Figura 5. Imagem de visualização com bokeh ativado

A atividade de captura de imagem suporta as seguintes funções:

  • Ampliar/reduzir
  • Toque para focar
  • Botão de alternância de modos de flash
  • EV +/-
  • Botão de alternância de extensão habilitada/desabilitada

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

Verifique os resultados da imagem capturada

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

photo_viewer-bokeh_enabled

Figura 6. Imagem capturada com bokeh ativado

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

  • Aperte para dentro/para fora para dimensionar a imagem
  • Deslize para a esquerda/direita para alternar as imagens capturadas
  • Recaptura
  • Salvar item de menu de imagem

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

Se os resultados capturados estiverem corretos, toque no botão PASSA (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 resultados do teste

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

  • Fundo branco: a câmera suporta pelo menos um modo de extensão e os modos de extensão suportados não são validados completamente.
  • Fundo verde: A câmera suporta pelo menos um modo de extensão. Todos os modos de extensão suportados são validados com a passagem de todos os resultados.
  • Fundo vermelho: A câmera suporta pelo menos um modo de extensão. Todos os modos de extensão suportados são validados com pelo menos um resultado de modo de extensão falhando.
  • Fundo cinza: Este recurso não está disponível.

camera_validation_resultextension_mode_validation_result

Figura 7. Cores indicando resultados de testes para câmeras e modos de extensão

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

Após a conclusão de todos os testes, a atividade da lista de câmeras fornece as seguintes funções:

  • Exportar resultados do 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.
  • Aplicativo de exemplo de extensões: alterna para o modo de aplicativo de exemplo de extensões.

Depois de concluir o teste, você pode exportar os resultados do teste. 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 suportados em todas as câmeras para verificar se os problemas foram corrigidos.