Google Home Developer Console udostępnia stronę Test, na której możesz konfigurować i przeprowadzać testy integracji Matter za pomocą Google Home Test Suite. Test Suite to wbudowana w Developer Console oddzielna aplikacja, która wykonuje wszystkie testy integracji.
Aby można było przetestować urządzenia z identyfikatorem dostawcy i produktu integracji, muszą one zostać zamówione i dostępne w Google Home app (GHA) na koncie używanym z interfejsem Developer Console. Więcej informacji znajdziesz w sekcji Parowanie urządzenia ze standardem Matter.
Element Test Suite można uruchomić na zestawie urządzeń należących do określonej konfiguracji projektu Matter. Aby mieć pewność, że wszystko działa prawidłowo, uruchom w integracji Test Suite bardzo ważne.
Na stronie Test integracje (Matter), które są ukończone i gotowe do przetestowania, są wymienione w sekcji Gotowe do testu.
Przetestowane integracje (Matter) są wymienione w sekcji Przetestowane.
Typ planów testowych
Są 2 rodzaje planów testów:
Plany testów w ramach wersji deweloperskiej służą do testowania urządzeń sterujących przy użyciu Matter. Można je edytować, ale nie można ich przesłać do certyfikatu Matter.
Abonamenty certyfikacji są przeznaczone specjalnie do certyfikacji Matter i nie można ich edytować. Wybranie tej opcji spowoduje utworzenie nowej wersji integracji Matter.
Wersje integracji
Gdy utworzysz plan testowy na potrzeby certyfikacji, utworzymy nową wersję integracji. Ta numerowana wersja jest widoczna na wszystkich listach integracji w Developer Console, od karty Test.
Nowe wersje nigdy nie są tworzone na podstawie innych wersji numerowanych. Na przykład pierwszy plan testowy, który utworzysz na potrzeby integracji, utworzy wersję v.1 na potrzeby tej integracji. Utworzenie innego planu testów spowoduje utworzenie wersji v.2 na potrzeby tej integracji, ale ta wersja nie będzie oparta na v.1. Ta wersja jest oparta na instancji integracji bez wersji, tak samo jak w wersji v.1.
Wersja integracji nie dotyczy reprezentuje instancję integracji bez wersji, którą można zarządzać na karcie Programowanie.
Innymi słowy, na karcie Matter > Przetestuj w Developer Console:
- Jeśli klikniesz Test w przypadku wersji Nie dotyczy integracji, zostanie utworzona nowa wersja. Numer wersji będzie o 1 wyższy niż w przypadku istniejących wersji numerowanych.
- Jeśli nie istnieje żadna wersja numerowana, 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 Przetestuj w przypadku numerowanej wersji integracji (np. v.1), nowa wersja v.1 zostanie utworzona. Zamiast tego wersja v.1 jest ponownie testowana.
Więcej informacji znajdziesz w artykule na temat obsługi wersji integracji.
Tworzenie planu testowego
Wersje integracji to zrzut niewersji integracji. Oznacza to, że gdy utworzysz plan testowania na potrzeby certyfikacji, a tym samym wersję integracji, wszystkie metadane związane z tą integracją muszą być informacjami, których chcesz użyć w przypadku uruchomionej integracji.
Zanim utworzysz plan testów certyfikacyjnych, wykonaj te czynności:
- Utworzono profil firmy.
- Wpisano produkcyjny identyfikator dostawcy (VID) na potrzeby integracji.
- Skonfigurowana konfiguracja i budowanie marki.
Jeśli nie wykonasz wszystkich tych zadań w ramach integracji, nie otrzymasz wersji integracji utworzonej na potrzeby testowania certyfikacyjnego. Konieczne będzie utworzenie nowej wersji, co oznacza powtórzenie kroków testów, testów funkcjonalnych i certyfikacji.
Musisz też utworzyć nową wersję i zacząć od nowa, jeśli chcesz zaktualizować markę przed certyfikacją wersji integracji.
Aby utworzyć plan testowy:
Na liście projektów kliknij Otwórz obok projektu, nad którym chcesz pracować.
W menu nawigacyjnym po lewej stronie kliknij Matter > Przetestuj.
Kliknij Test obok wersji Nie dotyczy integracji, którą chcesz przetestować. To działanie utworzy nową wersję integracji.
Jako typ testu wybierz Test deweloperski lub Test certyfikacyjny.
- Wybierz Test certyfikacji, jeśli przygotowujesz się do uzyskania certyfikatu w ekosystemie Google.
- Do certyfikacji nie można używać testu deweloperskiego.
Kliknij Przetestuj. Jeśli pojawi się ekran błędu Nie znaleziono urządzenia, oznacza to, że urządzenie obsługujące tę integrację nie zostało jeszcze udostępnione w ekosystemie. Więcej informacji znajdziesz w sekcji Rozwiązywanie problemów z parowaniem.
Na ekranie Skonfiguruj test wpisz nazwę testu i wybierz z listy urządzenia, które chcesz przetestować.
Kliknij przycisk Dalej: plan testowania.
Na stronie Utwórz plan testów w sekcji Pakiety testowe wybierz pakiety testów, które chcesz uruchomić.
Jeśli chcesz wyjść z Test Suite, kliknij Return to Developer Center.
Uruchamianie planu testowego
W Test Suite na stronie Tworzenie planu testowego kliknij Uruchom test. Pojawi się strona Środowisko testowe ze stanem i logami wszystkich testów.
Wyniki pojawią się po ich zakończeniu. Obok każdego wykonania pakietu testowego wyświetla się stan każdego wykonania pakietu testowego (Powodzenie, Niepowodzenie).
W panelu Dzienniki widać stan każdego wykonania testu.
Aby jeszcze raz przetestować plan testowy na stronie Środowisko testowe, po zakończeniu wykonywania testu kliknij u góry Test ponownie .
Po zakończeniu:
- Kliknij Gotowe, aby otworzyć stronę Historia testów, lub
- Kliknij Prześlij, aby przesłać wyniki testu do uzyskania certyfikatu.
Wyświetlanie i interpretowanie wyników testu
Na stronie Historia testów w interfejsie Test Suite możesz wyświetlić poprzednie wyniki testów planu rozwoju lub nieprzesłanego planu testów certyfikacji. Aby to zrobić, w sekcji Plany testów kliknij Sprawdź ponownie przy wybranym planie testów. Wyświetli się strona Środowisko testowe z wynikami tego testu.
W przypadku przesłanego planu certyfikacji kliknij Wyniki w sekcji Zapisane na potrzeby certyfikacji, aby wyświetlić raport z wynikami testu.
Wyniki testu dla wersji integracji są też dostępne na karcie Test w Developer Console. Kliknij Wyświetl, aby przejść na stronę Historia testów w narzędziu Test Suite, w sekcji Historia testów dowolnej wersji integracji wymienionej na tej stronie.
Stany konsol
Na etapie testowania występują te stany konsoli:
| Sekcja | Status | Opis | Wymaganie | Co dalej |
|---|---|---|---|---|
| Gotowe do testowania | Gotowe | Ta wersja aplikacji integration jest gotowa do testów. | Nie dotyczy | Przetestuj tę wersję systemu integration. |
| Przetestowane urządzenia | Gotowe | Ta wersja pakietu integration została przetestowana i można ją przesłać do testu funkcjonalnego lub certyfikatu. |
Wersja została przetestowana i zapisana. Wszystkie niezaliczone przypadki testowe zawierają uzasadnienia, które Google musi sprawdzić. |
W razie potrzeby przetestuj urządzenie jeszcze raz. |
Rozwiązywanie problemów
Przekazane urządzenie nie pojawia się w pakiecie Test Suite
Jeśli sparujesz urządzenie z testowym identyfikatorem dostawcy (VID) i identyfikatorem produktu (PID), ale nie pojawia się ono podczas przetestowania urządzenia w pakiecie testowym w Developer Console, prawdopodobnie jest to spowodowane używaniem w wielu integracjach tego samego zestawu identyfikatorów VID i PID.
Aby rozwiązać ten problem, usuń z usługi Developer Console wszystkie urządzenia testowe, a następnie sparuj urządzenie, które chcesz ponownie przetestować.
Aby sprawdzić, czy sparowano właściwy klucz, możesz ustawić informacje o producencie i modelu (wartości CHIP_DEVICE_CONFIG_DEVICE_*) urządzenia na unikalne wartości w oprogramowaniu testowym.
Więcej informacji znajdziesz w sekcji Informacje o urządzeniu.
Sprawdzanie identyfikatora VID/PID urządzenia
Jeśli chcesz rozpocząć integrację z Google, musisz utworzyć projekt i integrację w konsoli Google Home.
Wartość VID/PID sygnalizowana przez urządzenie powinna być zgodna z identyfikatorem VID/PID wpisanym w projekcie Developer Console.
- Identyfikatory VID
0xFFF1–0xFFF4są zarezerwowane na potrzeby testów. Można ich używać do podstawowych testów uruchamiania i kontroli, ale nie można ich używać w następujących fazach programowania:
Za pomocą aplikacji technicznej Bluetooth, takiej jak nRF Connect na urządzenia mobilne, możesz sprawdzić identyfikator VID/PID urządzenia beacon w polu Dane usługi.
Na tym zrzucie ekranu z nRF Connect w wersji Android widać, że identyfikator VID/PID jest podany jako 5A23FFFE od czwartego bajtu w polu Dane usługi. Wskazuje to identyfikator VID o wartości 5A23 i PID o wartości FFFE – obydwa w formacie endian.
Aplikacja BLE wyświetla wartości rysikiem endian,ale wartości VID/PID podawane w projekcie Developer Console są duże.
Na podstawie tego, co pokazuje sniffer Bluetooth, sprawdź, czy w projekcie w Konsoli Actions zostały wprowadzone odpowiednie wartości i format.
W przypadku wartości na przykładowym zrzucie ekranu identyfikatory VID i PID w Developer Console powinny wynosić odpowiednio 235A i FEFF.