Narzędzie do weryfikacji rozszerzeń aparatu

Narzędzie do weryfikacji rozszerzeń aparatu pozwala producentom urządzeń sprawdź, czy Biblioteka dostawcy OEM rozszerzeń aparatu jest prawidłowo zaimplementowany. Narzędzie obejmuje weryfikację ręczną i automatyczną testów.

• Zautomatyzowane testy weryfikacji: sprawdź, czy biblioteka dostawcy został prawidłowo zaimplementowany. Jeśli na przykład CaptureProcessor to wymaganych do robienia zdjęć, testy sprawdzają, ImageCaptureExtenderImpl#getCaptureStages() zwraca wymaganą wartość Liczba instancji do przechwytywania obrazów: CaptureStage.

• Ręczne testy weryfikacji: zweryfikuj efekty graficzne i jakość podgląd i zrobienie zdjęć. Przykładowo, testy umożliwiają: producenci muszą ręcznie sprawdzić, czy efekt retuszu twarzy został zastosowany poprawnie lub czy siła bokeh jest wystarczająca.

Kod źródłowy narzędzia do weryfikacji jest częścią aplikacja testowa rozszerzeń w Repozytorium Androida Jetpack.

Tworzenie narzędzia do weryfikacji rozszerzeń aparatu

Aby utworzyć narzędzie do weryfikacji rozszerzeń, wykonaj te czynności:

1. Pobierz kod źródłowy biblioteki Androida Jetpack. Więcej informacji: Sprawdzanie kodu strony Plik README Androida Jetpack.

2. Budowanie extensionstestapp plik APK. Umożliwia to przeprowadzanie ręcznych testów weryfikacyjnych.

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

   Plik APK jest wysyłany do tej ścieżki:

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

3. Budowanie androidTest plik APK. Ten plik APK umożliwia przeprowadzanie automatycznych testów weryfikacyjnych.

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

   Plik APK jest wysyłany do tej ścieżki:

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

Przeprowadzanie automatycznych testów weryfikacyjnych

Aby uruchomić automatyczne testy weryfikacyjne, zainstaluj pakiety extensionstestapp i Pliki APK: androidTest.

• Pakiet 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
  

• Pakiet 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
  

Uruchamianie wszystkich testów automatycznych

Po zainstalowaniu pakietów APK przeprowadza wszystkie automatyczne testy w celu weryfikacji dostawcy. implementacji biblioteki, uruchom następujące polecenie:

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

Jeśli wszystkie testy zakończą się powodzeniem, zwrócony zostanie wynik OK. W przeciwnym razie końcowy raport z testu pokazuje błędy w terminalu po zakończeniu wszystkich testów.

Rysunek 1. Zautomatyzowany wynik testów automatycznych

Rysunek 2. Wyniki testów automatycznych z błędami

Przeprowadzanie automatycznych testów określonych zajęć

Aby uruchomić automatyczne testy określonej klasy, podaj nazwę i ścieżkę jej klasy do klasy docelowej. W poniższym przykładzie pokazano polecenie do uruchomienia testów dla Zajęcia ImageCaptureTest:

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

Przeprowadzanie testów ręcznej weryfikacji

Testy ręcznej weryfikacji znajdują się w aplikacji testowej rozszerzeń. Po zainstalowaniu i uruchomieniu aplikacji testowej rozszerzeń przełącz się na kliknij pozycję menu w prawym górnym rogu.

Po przejściu do trybu narzędzia do weryfikacji na pierwszej stronie zobaczysz listę wszystkich aparatów. zawierające REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE działania. Jeśli kamera nie obsługuje żadnego trybu rozszerzenia, jej odpowiednik element listy jest szary.

Rysunek 3. Tryb narzędzia do weryfikacji

Kliknij jedną z aparatów, aby wyświetlić tryby rozszerzeń do testowania. Rozszerzenie tryby nieobsługiwane przez wybrany aparat są wyświetlane na szaro.

Rysunek 4. Tryby rozszerzeń dostępne w przypadku aparatu

Sprawdzanie wyników podglądu

Aby sprawdzić wyniki podglądu, rozpocznij test ręczny, klikając trybu rozszerzenia dla wybranego aparatu. Obraz przedstawiający aktywność zawierającą podgląd jest wyświetlany.

Rysunek 5. Podgląd obrazu z włączonym efektem bokeh

Przechwytywanie obrazu obsługuje te funkcje:

• Powiększ/pomniejsz
• Dotknij, aby ustawić ostrość
• Przycisk przełączania trybów lampy błyskowej
• EV +/-
• Przycisk przełącznika włączenia/wyłączenia rozszerzenia

Sprawdź, czy tryby powiększenia/pomniejszenia, ostrości przez dotknięcie, tryby lampy błyskowej oraz Funkcje EV +/- działają na podglądzie zgodnie z oczekiwaniami.

Sprawdź wyniki dotyczące przechwyconych obrazów

Aby zrobić zdjęcie, kliknij przycisk CAPTURE (okrągły przycisk) na zdjęciu rejestrowania aktywności. Spowoduje to uruchomienie procesu weryfikacji obrazu, który zostanie wyświetlony.

Rysunek 6. Zrobione zdjęcie z włączonym efektem bokeh

Działanie weryfikacji obrazu obejmuje te funkcje:

• Ściągaj i rozsuwaj palce, aby przeskalować obraz
• Przesuń w lewo lub w prawo, aby przełączyć zrobione zdjęcia
• Przechwyć ponownie
• Zapisz pozycję menu obrazu

Sprawdź, czy zdjęcie jest prawidłowe i odpowiada powiększeniu wejścia/wyjścia, ustawiania ostrości przez dotknięcie, trybów lampy błyskowej i ustawień EV +/-, które zostały wybrane zrobić zdjęcie.

Jeśli wyniki są poprawne, kliknij przycisk ZAPASOWA (znacznik wyboru) w w prawym dolnym rogu. W przeciwnym razie kliknij przycisk FAIL (wykrzyknik) w sekcji w lewym dolnym rogu.

Wyświetlanie wyników testu

Gdy tryb rozszerzenia zostanie zweryfikowany jako zaliczony lub niepowodzenie, pozycja na liście tryb rozszerzenia wyświetla inny kolor tła i wskaźnik. Na liście w widoku wszystkich kamer, elementy są wyświetlane w następujących kolorach:

• Białe tło: aparat obsługuje co najmniej jeden tryb rozszerzenia i obsługiwane tryby rozszerzeń nie zostały w pełni zweryfikowane.
• Zielone tło: aparat obsługuje co najmniej jeden tryb rozszerzenia. Wszystkie obsługiwane tryby rozszerzeń są weryfikowane pod kątem wszystkich wyników.
• Czerwone tło: aparat obsługuje co najmniej jeden tryb rozszerzenia. Wszystkie obsługiwane tryby rozszerzeń są weryfikowane z użyciem co najmniej jednego trybu rozszerzenia z nieudanym wynikiem.
• szare tło: ta funkcja jest niedostępna.

Rysunek 7. Kolory wskazujące wyniki testów aparatów i trybów rozszerzeń

Inne funkcje narzędzia do weryfikacji

Po zakończeniu wszystkich testów aktywność na liście kamer dostarcza: następujące funkcje:

• Eksportuj wyniki testu: pozwala wyeksportować wyniki testu jako plik CSV do Folder Documents/ExtensionsValidation.
• Resetuj:usuwa wszystkie wyniki testów w pamięci podręcznej.
• Przykładowa aplikacja z rozszerzeniami: przełącza się na przykładową aplikację z rozszerzeniami. i trybu uzyskiwania zgody.

Po zakończeniu testu możesz wyeksportować jego wyniki. Jeśli znajdziesz oraz nową wersję implementacji biblioteki dostawcy z należy ponownie zweryfikować rozwiązania, zresetuj poprzedni test i uruchom go ponownie wszystkich obsługiwanych trybach rozszerzeń we wszystkich aparatach, by sprawdzić, czy problemy są naprawiane.