Google Home Developer Console, Google Home Test Suite kullanarak Matter entegrasyonunuza göre testleri yapılandırıp çalıştırabileceğiniz bir Test sayfası sağlar. Test Suite, tüm entegrasyon testlerini gerçekleştiren ve Developer Console üzerinde yerleşik olarak bulunan ayrı bir uygulamadır.
Entegrasyonun Tedarikçi Kimliği ve Ürün Kimliğine yönelik cihazların test edilebilmesi için Developer Console ile kullanılan hesap için Google Home app (GHA) içinde devreye alınmış ve hazır olması gerekir. Daha fazla bilgi için Matter cihazı eşleme konusuna bakın.
Test Suite, belirli bir Matter proje yapılandırmasına ait cihaz grubunda çalıştırılabilir. Her şeyin düzgün çalıştığından emin olmak için entegrasyonlarınızda Test Suite kullanmanız çok önemlidir.
Test sayfasında, tamamlanmış ve test edilmeye hazır Matter entegrasyonları Teste hazır bölümünde listelenir.
Test edilen Matter entegrasyon Test edilen bölümünde listelenir.
Test planı türü
İki tür test planı vardır:
Geliştirme test planları, Matter kullanarak cihazların kontrolünü test etmek için kullanılır. Düzenlenebilir ancak Matter sertifikası için gönderilemez.
Sertifika test planları özellikle Matter sertifikasyonu içindir ve düzenlenemez. Bu seçeneği belirlediğinizde Matter entegrasyonunuzun yeni bir sürümü oluşturulur.
Entegrasyon sürümleri
Sertifika için bir test planı oluşturduğunuzda entegrasyonun yeni bir sürümü oluşturulur. Bu numaralı sürüm, Test sekmesinden itibaren Developer Console içindeki tüm entegrasyon listelerinde listelenir.
Yeni sürümler asla 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 söz konusu entegrasyon için v.2 sürümü oluşturulur ancak bu sürüm, v.1 sürümünü temel almaz. Bunun yerine bu sürüm, v.1'de olduğu gibi entegrasyonun eski sürüme geçirilmemiş örneğini temel alır.
Bir entegrasyonun yok sürümü, Geliştirme sekmesinde yönetilen entegrasyonun eski sürüme geçirilmemiş örneğini temsil eder.
Başka bir deyişle, Developer Console içindeki Matter > Test'te:
- Entegrasyonun Yok sürümü için Test et'i tıklarsanız yeni bir sürüm oluşturulur. Sürüm numarası, numaralandırılmış mevcut sürümlerden bir yüksek olacaktı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.
- Entegrasyonun numaralı bir sürümü için (örneğin, v.1) Test et'i tıklarsanız yeni sürüm oluşturulmaz. Bunun yerine, v.1 sürümü tekrar test edilir.
Daha fazla bilgi için Entegrasyon sürümü oluşturma bölümüne bakın.
Test planı oluşturma
Entegrasyon sürümleri, sürümü dönüştürülmemiş bir entegrasyonun anlık görüntüsüdür. Diğer bir deyişle, sertifikasyon için bir test planı ve dolayısıyla bir entegrasyon sürümü oluşturduğunuzda, bu entegrasyonla ilgili tüm meta verilerin, başlatılan entegrasyon için kullanmak istediğiniz bilgiler olması gerekir.
Sertifikasyon için bir test planı oluşturmadan önce aşağıdakileri yaptığınızdan emin olun:
- Bir şirket profili oluşturduysanız.
- Entegrasyon için üretim tedarikçi firması kimliğini (VID) girin.
- Kurulum ve markalama yapılandırıldı.
Entegrasyonunuz için bunların hepsini tamamlamadıysanız sertifika testi için oluşturulan bir entegrasyon sürümü onaylanamaz. Yeni bir sürüm oluşturmanız, yani Test, Saha Denemesi ve Sertifikalandırma adımlarını yeniden uygulamanız gerekir.
Ayrıca, bir entegrasyon sürümü onaylanmadan önce marka öğelerinizi güncellemek istiyorsanız yeni bir sürüm oluşturmanız ve baştan başlamanız gerekir.
Test planı oluşturmak için:
Proje listesinden, çalışmak istediğiniz projenin yanındaki Aç'ı tıklayın.
Sayfanın sol tarafındaki gezinme menüsünde Matter > Test et'e gidin.
Test etmek istediğiniz entegrasyonun Yok sürümü için Test et'i tıklayın. Bu işlem yeni bir entegrasyon sürümü oluşturur.
Test türü olarak Geliştirme testi veya Sertifika testi'ni seçin.
- Google ekosisteminde sertifika almaya hazırlanıyorsanız Sertifika testi'ni seçin.
- Geliştirme testi, sertifikasyon için kullanılamaz.
Test et'i tıklayın. Cihaz bulunamadı hata ekranını görürseniz bu entegrasyon için bir cihaz henüz ekosisteme dahil edilmemiş demektir. Daha fazla bilgi için Eşleme sorunlarını giderme bölümüne bakın.
Testinizi yapılandırın ekranında testiniz için bir ad girin ve cihaz listesinden test etmek istediğiniz cihazları seçin.
Sonraki: Test planı düğmesini tıklayın.
Test planı oluşturun sayfasındaki Test paketleri bölümünde, çalıştırmak istediğiniz test paketlerini seçin.
Test Suite uygulamasından çıkmak isterseniz Geliştirici Merkezi'ne dön'ü tıklayın.
Test planını çalıştırma
Test Suite içindeki Test planı oluşturun sayfasında Testi Çalıştır'ı tıklayın. Tüm testlerin durumu ve günlükleriyle birlikte Test ortamı sayfası görüntülenir.
Testler tamamlandıktan sonra test sonuçlarınız görünür. Her test paketi yürütme işleminin durumu yanında (Başarılı, Başarısız) gösterilir.
Günlükler bölmesi, her bir test yürütmenin durumunu gösterir.
Test ortamı sayfasında bir test planını yeniden test etmek için test yürütmesi tamamlandıktan sonra üstteki
Retest'i (Yeniden test et) tıklayın.Tamamladığınızda:
- Test geçmişi sayfasına gitmek için Bitti'yi tıklayın veya
- Test sonuçlarını sertifika almak üzere göndermek için Gönder'i tıklayın.
Test sonuçlarınızı görüntüleme ve yorumlama
Test Suite içindeki Test geçmişi sayfasında, Test planları bölümünde istenen test planı için Yeniden test et'i tıklayarak bir geliştirme planına veya gönderilmemiş bir sertifika test planına ilişkin önceki test sonuçlarını görüntüleyebilirsiniz. Bu işlem, sizi söz konusu testin sonuçlarını gösteren Test Ortamı sayfasına yönlendirir.
Gönderilen bir sertifika planı için test sonuçları raporunu görüntülemek üzere Sertifika için kaydedilenler bölümündeki Sonuçlar'ı tıklayın.
Entegrasyon sürümü için test sonuçlarına Developer Console içindeki Test sekmesinden de erişilebilir. Test Suite içindeki Test geçmişi sayfasına gitmek için bu sayfada listelenen herhangi bir entegrasyon sürümünün Test geçmişi için Görüntüle'yi tıklayın.
Konsol durumları
Test aşamasında aşağıdaki Konsol durumlarıyla karşılaşılır:
Section | Durum | Açıklama | Koşul | Sonraki adımlar |
---|---|---|---|---|
Test için hazır | Hazır | Bu integration sürümü test edilmeye hazır. | Yok | integrationöğesinin bu sürümünü test edin. |
Test edildi | Hazır | Bu integration 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 Tedarikçi Firma Kimliği (VID) ve Ürün Kimliği (PID) ile eşlediyseniz ancak Developer Console içinde cihazı Test Paketi ile test etmeye çalıştığınızda bu cihaz görünmezse bunun nedeni muhtemelen birden çok entegrasyonda aynı test VID ve PID kombinasyonunun kullanılmasıdır.
Sorunu gidermek için Developer Console ürünündeki tüm test cihazlarını kaldırın ve tekrar test etmek istediğiniz cihazı eşleyin.
Doğru cihazı eşleştirdiğinizden emin olmak 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 değerini doğrulayın
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şaretlediği VID/PID değeri, Developer Console projenize girilen VID/PID ile eşleşmelidir.
0xFFF1
-0xFFF4
arasındaki VID'ler test için ayrılmıştır. Bu testler, temel kullanıma sunma 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şaretleme cihazının VID/PID değerini görebilirsiniz.
nRF Connect'in Android sürümündeki bu ekran görüntüsünde, VID/PID değerinin Hizmet Verileri alanının dördüncü baytından başlayarak 5A23FFFE
olarak listelendiğini göreceksiniz. Bu, her ikisi de küçük endian biçiminde olan 5A23
VID ve FFFE
PID değerlerini gösterir.
BDE uygulaması,değerleri küçük endian dilinde görüntüler ancak Developer Console projenize girdiğiniz VID/PID değerleri büyük endian içindedir.
Bluetooth algılayıcısının gösterdiklerine bağlı olarak Actions Console projenize doğru değerlerin ve biçimin girildiğini doğrulayın.
Örnek ekran görüntüsündeki değerler için Developer Console içindeki VID ve PID sırasıyla 235A
ve FEFF
olur.