Google Home Developer Console udostępnia stronę Test, na której możesz skonfigurować i uruchamiać 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ć zamówienie 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 testowe 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 sekcji 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 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 krokó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 i kliknij Testuj.
- 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.
Na ekranie Skonfiguruj test wpisz nazwę testu i kliknij Automatycznie sparuj urządzenie, aby wybrać urządzenie do sparowania.
- Na urządzeniu z Androidem:
1. Make sure you installed GHA to your phone. 1. Connect your phone with a USB cable to the host machine. 1. You must [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging) The `APK` `com.chip.interop.moblysnippet` will automatically download and install. 1. Once your phone is connected, enter the **Pairing code** and **Device name** to auto-pair your device.- Urządzenie z iOS: sparowanie urządzenia musisz wykonać ręcznie. Instrukcje dotyczące parowania ręcznego znajdziesz w sekcji Aplikacja Google Home.
- Jeśli masz już urządzenie, możesz zostać poproszony(-a) o sparowanie go ponownie lub sparowanie nowego urządzenia.
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ąć okno Test Suite, kliknij Wróć do Centrum deweloperów.
Uruchamianie planu testów
Na stronie Test Suite Tworzenie planu testu 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).
Panel Logi zawiera stan każdego pojedynczego wykonania testu.
Aby ponownie przetestować plan testu na stronie Środowisko testowe, po zakończeniu wykonywania testu u góry kliknij Ponownie przetestuj.
Gdy skończysz:
- 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 niezgłoszonego planu testu certyfikacyjnego. Aby to zrobić, kliknij Ponownie przeprowadź test obok wybranego planu testu 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). |
Sprawdź jeszcze raz
Certyfikat
Jeśli musisz ponownie przetestować urządzenie w celu uzyskania certyfikatu, musisz sparować je po rozpoczęciu ponownego testowania.
Programowanie
Jeśli chcesz przetestować aplikację w celu jej dalszego rozwoju, możesz użyć dotychczasowego urządzenia bez ponownego parowania.
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 przypadku wielu integracji.
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 zacząć tworzyć integrację 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. Mogą one służyć do podstawowych testów uruchomienia 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. Wskazuje to VID 5A23 i PID 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.