Google Home Developer Console, Google Home Test Suite'i kullanarak Matterentegrasyonunuzla ilgili testleri yapılandırıp çalıştırabileceğiniz bir Test sayfası sağlar. Test Suite, tüm entegrasyon testlerini yöneten ve Developer Console'a yerleşik olan ayrı bir uygulamadır.
Entegrasyon için Tedarikçi Kimliği ve Ürün Kimliği'ne sahip cihazlar, test edilmek üzere Developer Console ile birlikte kullanılan hesap için Google Home app (GHA)'te etkinleştirilmiş ve kullanılabilir olmalıdır. Daha fazla bilgi için Matter cihazı eşleme başlıklı makaleyi inceleyin.
Test Suite, belirli bir Matter proje yapılandırmasına ait bir cihaz grubunda çalıştırılabilir. Her şeyin düzgün çalıştığından emin olmak için entegrasyonlarınızda Test Suite'yi çalıştırmak çok önemlidir.
Test sayfasında, tamamlanmış ve test edilmeye hazır Matter entegrasyonu Test için hazır bölümünde listelenir.
Test edilen Matter entegrasyonları Test Edildi bölümünde listelenir.
Test planı türleri
İki tür test planı vardır:
Matter kullanarak kontrol cihazlarını test etmek için geliştirme test planları kullanılır. Bu öğeler düzenlenebilir ancak Matter sertifikası için gönderilemez.
Sertifika test planları, Matter sertifikası için özeldir ve düzenlenemez. Bu seçeneği belirlediğinizde Matter entegrasyonunuzun yeni bir sürümü oluşturulur.
Sertifika için test sonuçlarını göndermek üzere Developer Console içindeki Test Suite öğesini kullanın. Geliştirme sırasında test amacıyla Test Suite'ü çalıştırmak istiyorsanız bağımsız sürüm için Google Home Test Suite sayfasına bakın.
Entegrasyon sürümleri
Sertifika için test planı oluşturduğunuzda entegrasyonun yeni bir sürümü oluşturulur. Bu numaralı sürüm, Test sekmesinden itibaren Developer Console'teki tüm entegrasyon listelerinde listelenir.
Yeni sürümler hiçbir zaman diğer numaralı sürümlerden oluşturulmaz. Örneğin, bir entegrasyon için oluşturduğunuz ilk test planı, söz konusu entegrasyon için v.1 sürümünü oluşturur. Başka bir test planı oluşturduğunuzda bu entegrasyon için v.2 sürümü oluşturulur ancak bu sürüm v.1'e dayalı olmaz. Bunun yerine bu sürüm, v.1'de olduğu gibi entegrasyon örneğinin sürümsüz halini temel alır.
Bir entegrasyonun Geçerli değil sürümü, entegrasyonun sürümsüz örneğini temsil eder ve Geliştir sekmesinde yönetilir.
Diğer bir deyişle, Developer Console'daki Matter > Test bölümünde:
- Entegrasyonun Geçersiz sürümü için Test'i tıklarsanız yeni bir sürüm oluşturulur. Sürüm numarası, mevcut numaralandırılmış sürümlerden bir üst olacak şekilde ayarlanır.
- Numaralı sürüm yoksa v.1 sürümü oluşturulur.
- v.1 sürümü varsa v.2 sürümü oluşturulur. v.2 sürümü varsa v.3 sürümü oluşturulur ve bu şekilde devam eder.
- Entegrasyon için numaralandırılmış bir sürüm (ör. 1. sürüm) için Test'i tıklarsanız yeni bir sürüm oluşturulmaz. Bunun yerine v.1 sürümü tekrar test edilir.
Daha fazla bilgi için Entegrasyon sürümlendirme başlıklı makaleyi inceleyin.
Test planı oluşturma
Entegrasyon sürümleri, sürümlenmemiş bir entegrasyonun anlık görüntüsüdür. Bu, sertifika için bir test planı ve dolayısıyla bir entegrasyon sürümü oluşturduğunuzda bu entegrasyonla ilgili tüm meta verilerin, kullanıma sunulan entegrasyon için kullanmak istediğiniz bilgiler olması gerektiği anlamına gelir.
Sertifika için test planı oluşturmadan önce aşağıdakileri yaptığınızdan emin olun:
- Şirket profili oluşturduysanız.
- Entegrasyon için üretim tedarikçi firma kimliğini (VID) girin.
- Yapılandırılmış kurulum ve marka öğeleri.
Entegrasyonunuz için bunların tümünü tamamlamadıysanız sertifika testi için oluşturulan entegrasyon sürümü sertifikalandırılamaz. Yeni bir sürüm oluşturmanız gerekir. Bu, Test, Saha Deneme ve Sertifika adımlarını yeniden yapmanız anlamına gelir.
Entegrasyon sürümü onaylanmadan önce markanızı güncellemek istiyorsanız yeni bir sürüm oluşturmanız ve baştan başlamanız da gerekir.
Test planı oluşturmak için:
- Proje listesinde, üzerinde çalışmak istediğiniz projenin yanındaki Aç'ı tıklayın.
- Sayfanın sol tarafındaki gezinme menüsünde Matter > Test'e gidin.
- Test etmek istediğiniz entegrasyon sürümünün Geçersiz olması durumunda Test'i tıklayın. Bu işlem yeni bir entegrasyon sürümü oluşturur.
- Geliştirme testi veya Sertifika testi test türlerinden birini seçip Test'i tıklayın.
- Google ekosisteminde sertifika almaya hazırlanıyorsanız Sertifika testi'ni seçin.
- Geliştirme testi sertifika için kullanılamaz.
Testinizi yapılandırın ekranında testiniz için bir ad girin ve eşlenecek bir cihaz seçmek için Cihazı otomatik olarak eşle'yi tıklayın.
- Android cihazlar için:
- Telefonunuza GHA'ü yüklediğinizden emin olun.
- Telefonunuzu USB kablosuyla ana makineye bağlayın.
- Cihazınızda USB hata ayıklama özelliğini etkinleştirmeniz gerekir.
APKcom.chip.interop.moblysnippetotomatik olarak indirilip yüklenir. - Telefonunuz bağlandıktan sonra cihazınızı otomatik olarak eşlemek için Eşleme kodunu ve Cihaz adını girin.
- iOS cihazlar için: Cihazınızı manuel olarak eşlemeniz gerekir. Manuel olarak eşlemeyle ilgili talimatlar için Google Home uygulaması bölümüne bakın.
- Mevcut bir cihazınız varsa cihazın eşlemesini kaldırıp tekrar eşlemeniz veya yeni bir cihazı eşlemeniz istenebilir.
Sonraki: Planı test et düğmesini tıklayın.
Test planı oluştur sayfasındaki Test paketleri bölümünde, çalıştırmak istediğiniz test paketlerini seçin.
Test Suite sayfasından çıkmak istiyorsanız Geliştirici Merkezi'ne dön'ü tıklayın.
Test planını çalıştırma
Test Suite'te, Test planı oluştur sayfasında Testi çalıştır'ı tıklayın. Tüm testlerin durumunu ve günlüklerini içeren Test ortamı sayfası görünür.
Testler tamamlandıktan sonra test sonuçlarınız gösterilir. Her test paketi çalıştırmasının durumu (Geçti, Başarısız) yanında görünür.
Günlükler bölmesinde her test çalıştırmasının durumu gösterilir.
Test ortamı sayfasından bir test planını yeniden test etmek için test yürütme işlemi tamamlandıktan sonra üstteki Yeniden test et'i tıklayın.
İşlem tamamlandıktan sonra:
- Test geçmişi sayfasına gitmek için Bitti'yi tıklayın veya
- Sertifika için test sonuçlarını göndermek üzere Gönder'i tıklayın.
Test sonuçlarınızı görüntüleme ve yorumlama
Test Suite'deki Test geçmişi sayfasında, Test planları bölümünde istediğiniz test planı için Yeniden test et'i tıklayarak bir geliştirme planının veya gönderilmemiş bir sertifika test planının önceki test sonuçlarını görüntüleyebilirsiniz. Bu işlemle, ilgili testin sonuçlarını gösteren Test Ortamı sayfasına yönlendirilirsiniz.
Gönderilen bir sertifika planı için test sonuçları raporunu görüntülemek üzere Sertifika için kayıtlı bölümünde Sonuçlar'ı tıklayın.
Entegrasyon sürümünün test sonuçlarına Developer Console'deki Test sekmesinden de erişilebilir. Sayfada listelenen herhangi bir entegrasyon sürümünün test geçmişi için Görüntüle'yi tıklayarak Test Suite'deki Test geçmişi sayfasına gidin.
Konsol durumları
Test aşamasında aşağıdaki Console durumlarıyla karşılaşılır:
| Section | Durum | Açıklama | Koşul | Sonraki adımlar |
|---|---|---|---|---|
| Test için hazır | Hazır | integration 'ün bu sürümü test edilmeye hazır. | Yok | integration'nin bu sürümünü test edin. |
| Test edildi | Hazır | integration 'ın bu sürümü test edildi ve Field Trial veya sertifika için gönderilebilir. |
Sürüm test edildi ve kaydedildi. Başarısız olan tüm test durumları, Google'ın incelemesi için gerekçeler içerir. |
İsterseniz yeniden test edin. |
Tekrar test et
Sertifika
Sertifika için yeniden test yapmanız gerekirse yeniden test etmeye başladıktan sonra cihazınızı eşlemeniz gerekir.
Geliştirme
Geliştirme için yeniden test etmeniz gerekirse mevcut cihazı tekrar eşlemeden kullanabilirsiniz.
Sorun giderme
Devreye alınan cihaz Test Paketi'nde görünmüyor
Bir cihazı test amaçlı bir tedarikçi kimliği (VID) ve ürün kimliği (PID) ile eşlediniz ancak Developer Console'de cihazı Test Paketi ile test etmeye çalıştığınızda cihaz görünmüyorsa bunun nedeni muhtemelen birden fazla entegrasyonda aynı test VID ve PID kombinasyonunun kullanılmasıdır.
Sorun gidermek için tüm test cihazlarını Developer Console'ten kaldırın ve tekrar test etmek istediğiniz cihazı eşleyin.
Doğru cihazı eşlediğinizi doğrulamak için cihazın Üretici ve Model bilgilerini (CHIP_DEVICE_CONFIG_DEVICE_* değerleri), test donanım yazılımınızdaki benzersiz değerlere ayarlayabilirsiniz.
Daha fazla bilgi için Cihaz bilgileri bölümüne bakın.
Cihazınızın VID/PID'sini doğrulama
Google ile entegrasyonunuzu geliştirmeye başlamak istiyorsanız Google Home Console'da bir proje ve entegrasyon oluşturmanız gerekir.
Cihazınızın işaret ettiği VID/PID değeri, Developer Console projenize girilen VID/PID ile eşleşmelidir.
- VID'ler
0xFFF1-0xFFF4test için ayrılmıştır. Temel devreye alma ve kontrol testleri için kullanılabilir ancak aşağıdaki geliştirme aşamalarında kullanılamaz:
nRF Connect for Mobile gibi bir Bluetooth mühendislik uygulaması kullanarak Hizmet Verileri alanında işaretçi cihazın VID/PID'sini görebilirsiniz.
nRF Connect'in Android sürümüne ait bu ekran görüntüsünde, VID/PID'nin Hizmet Verileri alanının dördüncü baytından itibaren 5A23FFFE olarak listelendiğini görebilirsiniz. Bu, 5A23 VID'sini ve FFFE PID'sini gösterir. Her ikisi de little endian biçimindedir.
BLE uygulaması değerleri küçük endian olarak gösterir ancak Developer Console projenize girdiğiniz VID/PID değerleri büyük endian olarak gösterilir.
Bluetooth sniffer'ın gösterdiğine göre Actions Console projenize doğru değerlerin ve biçimin girildiğini doğrulayın.
Örnek ekran görüntüsünde yer alan değerler için Developer Console'teki VID ve PID sırasıyla 235A ve FEFF olur.