Google Home Developer Console udostępnia stronę Test, na której możesz skonfigurować i uruchomić testy integracji Matter za pomocą Google Home Test Suite. Test Suite to osobna aplikacja wbudowana w Developer Console, która obsługuje wszystkie testy integracji.
Aby można było przetestować urządzenia, na których ma być testowana integracja, na koncie używanym z integracją (Developer Console) musisz zlecić wdrożenie i uzyskać dostęp do identyfikatora dostawcy oraz identyfikatora produktu.Google Home app (GHA) Więcej informacji znajdziesz w artykule Parowanie urządzenia z Matter.
Test Suite może być uruchamiana na zestawie urządzeń należących do określonej konfiguracji projektu Matter. Aby mieć pewność, że wszystko działa prawidłowo, bardzo ważne jest przeprowadzenie testu Test Suite w przypadku integracji.
Na stronie Testowanie Matterintegracje, które są gotowe do testowania, są wymienione w sekcji Gotowe do testowania.
Testowane integracje Matter są wymienione w sekcji Testowane.
Rodzaje planów testów
Istnieją 2 rodzaje planów testów:
Plany testów rozwojowych służą do testowania urządzeń sterujących za pomocą Matter. Można je edytować, ale nie można ich przesłać do certyfikacji Matter.
Certyfikat to plany testów przeznaczone do certyfikacji Matter. Nie można ich edytować. Wybranie tej opcji spowoduje utworzenie nowej wersji integracji Matter.
Użyj Test Suite w Developer Console, aby przesłać wyniki testów do certyfikacji. Jeśli chcesz uruchomić Test Suite w celu przetestowania podczas tworzenia, zapoznaj się ze stroną Test Suite Google Home, aby pobrać wersję samodzielną.
Wersje integracji
Gdy tworzysz plan testowy na potrzeby certyfikacji, tworzona jest nowa wersja integracji. Ta numerowana wersja jest widoczna na wszystkich listach integracji w sekcji Developer Consoleod karty Test.
Nowe wersje nigdy nie są tworzone na podstawie innych wersji. Na przykład pierwszy plan testowy utworzony dla integracji utworzy wersję v.1 tej integracji. Utworzenie kolejnego planu testowego spowoduje utworzenie wersji v.2 tej integracji, ale ta wersja nie będzie oparta na wersji v.1. Ta wersja opiera się na instancji integracji bez wersji, tak jak miało to miejsce w przypadku wersji v.1.
Wersja N/A integracji reprezentuje instancję integracji bez wersji, którą zarządza się na karcie Tworzenie.
Innymi słowy, w sekcji Matter > Test w Developer Console:
- Jeśli klikniesz Testuj w przypadku wersji N/D integracji, zostanie utworzona nowa wersja. Numer wersji będzie wyższy o jeden niż numer każdej istniejącej wersji.
- Jeśli nie ma żadnych wersji z liczbą, tworzona jest wersja v.1.
- Jeśli istnieje wersja v.1, tworzona jest wersja v.2. Jeśli istnieje wersja v.2, tworzona jest wersja v.3 itd.
- Jeśli klikniesz Testuj w przypadku wersji z numerem (np. v.1), nowa wersja nie zostanie utworzona. Zamiast tego ponownie testowana jest wersja v.1.
Więcej informacji znajdziesz w artykule o wersjonarstwie integracji.
Tworzenie planu testów
Wersje integracji to migawka integracji bez wersji. Oznacza to, że podczas tworzenia planu testów na potrzeby certyfikacji, a także wersji integracji wszystkie metadane związane z tą integracją muszą zawierać informacje, których chcesz używać w ramach uruchomionej integracji.
Zanim utworzysz plan testów na potrzeby certyfikacji, wykonaj te czynności:
- Utworzono profil firmy.
- W ramach integracji podany został produkcyjny identyfikator dostawcy (VID).
- Skonfigurowana konfiguracja i markowanie.
Jeśli nie masz jeszcze wszystkich tych informacji dotyczących integracji, wersja integracji utworzona na potrzeby testów certyfikacyjnych nie może zostać certyfikowana. Musisz utworzyć nową wersję, co oznacza powtórzenie etapów Test, Field Trial i Certyfikat.
Jeśli chcesz zaktualizować swój branding przed certyfikacją wersji integracji, musisz też utworzyć nową wersję i zaczynać od początku.
Aby utworzyć plan testów:
Na liście projektów kliknij Otwórz obok projektu, nad którym chcesz pracować.
W menu nawigacyjnym po lewej stronie kliknij Matter > Testowanie.
Kliknij Testuj w przypadku wersji N/D integracji, którą chcesz przetestować. Ta czynność tworzy nową wersję integracji.
Wybierz typ testu: Test rozwoju lub Test certyfikacji.
- Jeśli przygotowujesz się do egzaminu certyfikacyjnego w ekosystemie Google, wybierz Egzamin certyfikacyjny.
- Testowanie w procesie rozwoju nie może być używane do certyfikacji.
Kliknij Przetestuj. Jeśli pojawi się błąd Nie znaleziono urządzenia, oznacza to, że urządzenie przeznaczone do tej integracji nie zostało jeszcze włączone do ekosystemu. Więcej informacji znajdziesz w sekcji Rozwiązywanie problemów z parowaniem.
Na ekranie Skonfiguruj test podaj nazwę testu i wybierz z listy urządzenia, które chcesz przetestować.
Kliknij przycisk Dalej: testowanie planu.
Na stronie Tworzenie planu testów w sekcji Zestawy testów wybierz zestawy testów, które chcesz uruchomić.
Jeśli chcesz zamknąć Test Suite, kliknij Wróć do Centrum programisty.
Uruchamianie planu testów
Na stronie Test Suite Tworzenie planu testowego kliknij Uruchom test. Pojawi się strona Środowisko testowe ze stanem i logami wszystkich testów.
Wyniki testów pojawią się po ich zakończeniu. Obok każdego testu znajduje się jego stan (Przeszedł, Niepowodzenie).
Na panelu Logi widać stan poszczególnych testów.
Aby ponownie przetestować plan testu na stronie Środowisko testowe, po zakończeniu wykonywania testu u góry kliknij Ponownie przetestuj.
Po zakończeniu:
- Kliknij Gotowe, aby otworzyć stronę Historia testów.
- Kliknij Prześlij, aby przesłać wyniki testu do certyfikacji.
Wyświetlanie i interpretowanie wyników testu
Na stronie Historia testów w Test Suite możesz wyświetlić poprzednie wyniki testów planu rozwoju lub niezasłanego planu testu certyfikacyjnego. Aby to zrobić, kliknij Ponownie przeprowadź test obok wybranego planu testowego w sekcji Plany testów. Otworzy się strona Środowisko testowe, na której znajdziesz wyniki testu.
W przypadku przesłanego planu certyfikacji w sekcji Zapisane na potrzeby certyfikacji kliknij Wyniki, aby wyświetlić raport z wynikami testu.
Wyniki testów wersji integracji można też wyświetlić na karcie Test w Developer Console. Kliknij Wyświetl historię testów dowolnej wersji integracji wymienionej na tej stronie, aby przejść na stronę Historia testów w Test Suite.
Stany konsoli
W fazie testowania występują te stany konsoli:
| Sekcja | Status | Opis | Wymagania | Co dalej? |
|---|---|---|---|---|
| Gotowa do testowania | Gotowe | Ta wersja integration jest gotowa do testowania. | Nie dotyczy | Testuj tę wersję integration. |
| Testowane | Gotowe | Ta wersja integration została przetestowana i może zostać przesłana do Field Trial lub certyfikacji. |
Wersja została przetestowana i zapisana. Wszystkie nieudane przypadki testowe zawierają uzasadnienie, które Google może sprawdzić. |
Ponownie przeprowadź test (jeśli chcesz). |
Rozwiązywanie problemów
Zarejestrowane urządzenie nie wyświetla się w pakiecie testów
Jeśli sparujesz urządzenie z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawi się ono, gdy spróbujesz przetestować urządzenie za pomocą Testowej suity w Developer Console, jest to prawdopodobnie spowodowane użyciem tej samej testowej kombinacji identyfikatorów VID i PID w różnych integracjach.
Aby rozwiązać problem, usuń wszystkie urządzenia testowe z usługi Developer Console i sparuj urządzenie, które chcesz ponownie przetestować.
Aby sprawdzić, czy sparowano prawidłowe urządzenie, możesz ustawić informacje o producencie i modelu (wartości CHIP_DEVICE_CONFIG_DEVICE_*) na wartości unikalne w testowym oprogramowaniu układu.
Więcej informacji znajdziesz w sekcji Informacje o urządzeniu.
Weryfikowanie VID/PID urządzenia
Jeśli chcesz rozpocząć tworzenie integracji z Google, musisz utworzyć projekt i integrację w konsoli Google Home.
Wartość VID/PID, którą beaconuje urządzenie, powinna być zgodna z wartością VID/PID podana w projekcie Developer Console.
- VIDs
0xFFF1–0xFFF4są zarezerwowane do testowania. Można ich używać do podstawowych testów wdrożenia i kontroli, ale nie można ich używać w tych fazach rozwoju:
Za pomocą aplikacji do obsługi Bluetooth, takiej jak nRF Connect for Mobile, możesz sprawdzić VID/PID urządzenia emitującego sygnały beacon w polu Dane usługi.
Na tym zrzucie ekranu z wersji Android nRF Connect widać, że VID/PID jest wymieniony jako 5A23FFFE, zaczynając od czwartego bajtu pola Service Data. W tym przypadku VID to 5A23, a PID to FFFE – oba w formacie little-endian.
Aplikacja BLE wyświetla wartości w systemie little-endian, ale wartości VID/PID, które wpisujesz w projekcie Developer Console, są w systemie big-endian.
Sprawdź, czy w Twoim projekcie w Actions Console zostały podane prawidłowe wartości i format na podstawie tego, co pokazuje sniffer Bluetooth.
W przypadku wartości na przykładowym zrzucie ekranu VID i PID w Developer Console miałyby odpowiednio wartości 235A i FEFF.