Strumento di convalida delle estensioni per le videocamere

Lo strumento di convalida delle estensioni della fotocamera consente ai produttori di verifica che Libreria OEM del fornitore di estensioni per fotocamera sia implementato correttamente. Lo strumento include la convalida automatica e manuale test.

  • Test di convalida automatici: verificano che la libreria del fornitore sia implementata correttamente. Ad esempio, se CaptureProcessor è richiesti per l'acquisizione delle immagini, i test convalidano ImageCaptureExtenderImpl#getCaptureStages() restituisce i valori richiesti CaptureStage istanze per acquisire le immagini.

  • Test di convalida manuale: convalida gli effetti e la qualità dell'immagine della l'anteprima e le immagini acquisite. Ad esempio, i test consentono di controllare manualmente se l'effetto ritocco viso sia applicata correttamente o se l'intensità del bokeh è sufficiente.

Il codice sorgente dello strumento di convalida fa parte della app di test delle estensioni nel Repository Android Jetpack.

Creare lo strumento di convalida delle estensioni della videocamera

Per creare lo strumento di convalida delle estensioni:

  1. Scarica il codice sorgente della libreria Android Jetpack. Per maggiori dettagli, consulta Controllare il codice sezione del File README di Android Jetpack.

  2. Crea il extensionstestapp . Ciò consente di eseguire test di convalida manuali.

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

    L'APK viene restituito nel seguente percorso:

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

  3. Crea il androidTest . Questo APK consente di eseguire test di convalida automatici.

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

    L'APK viene restituito nel seguente percorso:

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

Eseguire test di convalida automatici

Per eseguire i test di convalida automatici, installa extensionstestapp e androidTest APK.

  • APK extensionstestapp

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

  • APK androidTest

      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

Esegui tutti i test automatici

Dopo aver installato gli APK, eseguire tutti i test automatici per convalidare il fornitore implementazione della libreria, esegui questo comando:

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

Se tutti i test vengono superati, viene restituito un risultato OK. Altrimenti, il report di test finale mostra gli errori nel terminale al termine di tutti i test.

superamento_risultato_con_validazione_automatica

Figura 1. Risultato OK per i test automatici

esito_convalida_automatica-non riuscito

Figura 2. Risultato dei test automatici con errori

Eseguire test automatici di un corso specifico

Per eseguire i test automatici di una classe specifica, specifica il nome e il percorso del classe target. L'esempio seguente mostra il comando per eseguire test per ImageCaptureTest corso:

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

Eseguire test di convalida manuali

I test di convalida manuale si trovano nella app di test delle estensioni. Dopo aver installato e avviato l'app di test delle estensioni, passa alla strumento di convalida toccando la voce di menu in alto a destra.

Dopo il passaggio alla modalità dello strumento di convalida, la prima pagina elenca tutte le fotocamere che contengono REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE funzionalità. Se una fotocamera non supporta nessuna modalità di estensione, viene la voce dell'elenco è grigia.

iniziale_risultato_convalida_camera

Figura 3. Modalità strumento di convalida

Tocca una delle fotocamere per vedere le modalità dell'estensione per i test. Estensione le modalità non supportate dalla fotocamera selezionata sono mostrate in grigio.

iniziale_risultato_convalida_modalità_estensione

Figura 4. Modalità estensione disponibili per una fotocamera

Verificare i risultati dell'anteprima

Per verificare i risultati dell'anteprima, avvia un test manuale toccando un per la videocamera selezionata. Un'attività di acquisizione di immagini contenente viene visualizzata l'anteprima.

anteprima-bokeh_abilitato

Figura 5. Immagine di anteprima con bokeh attivato

L'attività di acquisizione di immagini supporta le seguenti funzioni:

  • Zoom avanti/indietro
  • Tocca per mettere a fuoco
  • Pulsante per cambiare modalità flash
  • EV +/-
  • Pulsante di opzione dell'estensione attivata/disattivata

Verifica che le funzionalità di zoom avanti e indietro, tocco per mettere a fuoco, modalità flash e Le funzioni +/- EV funzionano come previsto nell'anteprima.

Verificare i risultati delle immagini acquisite

Per acquisire l'immagine, tocca il pulsante ACQUISTA (il pulsante rotondo) nell'immagine acquisire l'attività. Viene avviata un'attività di convalida dell'immagine che mostra l'immagine acquisita.

foto_visualizzatore-bokeh_attivato

Figura 6. Immagine acquisita con la funzionalità bokeh attivata

L'attività di convalida delle immagini include le seguenti funzioni:

  • Avvicina/allontanamento di due dita per ridimensionare l'immagine
  • Fai scorrere verso sinistra/destra per cambiare l'immagine acquisita
  • Riconquista
  • Voce di menu Salva immagine

Verifica se l'immagine acquisita è corretta e corrisponde allo zoom in/out, tocco per mettere a fuoco, modalità flash ed EV +/- configurate durante acquisire l'immagine.

Se i risultati acquisiti sono corretti, tocca il pulsante SUPER (segno di spunta) nella nell'angolo in basso a destra. In caso contrario, tocca il pulsante NON SUPERATO (punto esclamativo) nella nell'angolo in basso a sinistra.

Visualizzare i risultati dei test

Dopo che la modalità di un'estensione è stata verificata come superata o non riuscita, la voce dell'elenco per di estensione mostra un colore di sfondo e un indicatore diversi. Nell'elenco vista di tutte le videocamere, gli elementi vengono visualizzati nei seguenti colori:

  • Sfondo bianco. La fotocamera supporta almeno una modalità di estensione e le modalità delle estensioni supportate non sono convalidate completamente.
  • Sfondo verde. La fotocamera supporta almeno una modalità di estensione. Tutti le modalità di estensione supportate vengono convalidate e tutti i risultati vengono superati.
  • Sfondo rosso: la fotocamera supporta almeno una modalità di estensione. Tutti le modalità di estensione supportate vengono convalidate con almeno una modalità di estensione errore del risultato.
  • Sfondo grigio: questa funzionalità non è disponibile.

risultato_convalida_fotocamera risultato_convalida_modalità_estensione

Figura 7. Colori che indicano i risultati dei test per le fotocamere e le modalità di estensione

Altre funzioni dello strumento di convalida

Una volta completati tutti i test, l'attività dell'elenco delle videocamere fornisce la le seguenti funzioni:

  • Esporta i risultati del test: consente di esportare i risultati del test come file CSV nel Documents/ExtensionsValidation.
  • Reimposta: cancella tutti i risultati del test memorizzati nella cache.
  • App di esempio estensioni: consente di passare all'app di esempio delle estensioni .

Dopo aver completato il test, puoi esportare i risultati del test. Se trovi un e una nuova versione dell'implementazione della libreria del fornitore con il soluzioni devono essere verificate di nuovo, reimposta i risultati dei test precedenti ed esegui di nuovo tutte le modalità di estensione supportate su tutte le fotocamere per verificare che i problemi sono corretti.