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 devreye alınmış 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 seçeneğini 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:
- Entegrasyon için Geçersiz sürümü 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 bölümüne bakın.
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ürünü seçin.
- Google ekosisteminde sertifika almaya hazırlanıyorsanız Sertifika testi'ni seçin.
- Geliştirme testi sertifika için kullanılamaz.
Test et'i tıklayın. Cihaz bulunamadı hata ekranı görürseniz bu entegrasyon için henüz ekosisteme bir cihaz atanmamış demektir. Daha fazla bilgi için Eşlemeyle ilgili sorunları giderme başlıklı makaleyi inceleyin.
Testinizi yapılandırın ekranında testiniz için bir ad girin ve cihaz listesinden test etmek istediğiniz cihazları seçin.
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'ten çıkmak isterseniz 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 saha denemesi 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. |
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ılabilirler ancak aşağıdaki geliştirme aşamalarında kullanılamazlar:
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.