Google Home Developer Console, Google Home Test Suite kullanarak Matter entegrasyonunuza göre testler 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 ait cihazların test edilebilmesi için, Developer Console ile kullanılan hesap için Google Home app (GHA) içinde devreye sokulması ve kullanılabilir 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 olan bir cihaz grubunda çalıştırılabilir. Entegrasyonlarınızda Test Suite çalıştırmanız, her şeyin düzgün çalıştığından emin olmanız için çok önemlidir.
Tamamlanmış ve test edilmeye hazır Matter entegrasyon, Test sayfasında Test edilmeye hazır bölümünde listelenir.
Test edilen Matter entegrasyonları Test Edilenler bölümünde listelenir.
Test planlarının türü
İki tür test planı vardır:
Geliştirme test planları, Matter kullanarak cihaz 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 hiçbir zaman diğer numaralı sürümlerden oluşturulmaz. Örneğin, bir entegrasyon için oluşturduğunuz ilk test planı, bu 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'i temel almaz. Bunun yerine bu sürüm, v.1'de olduğu gibi entegrasyonun sürümü eski haline getirilmiş örneğini temel alır.
Bir entegrasyonun Yok sürümü, Geliştirme sekmesinde yönetilen entegrasyonun sürümü dönüştürülmemiş örneğini temsil eder.
Başka bir deyişle, Developer Console içindeki Matter > Test bölümünde:
- Entegrasyonun Yok sürümü için Test et'i tıklarsanız yeni bir sürüm oluşturulur. Sürüm numarası, mevcut numaralandırılmış sürümlerden bir daha yüksek olacaktır.
- Numaralı sürüm yoksa v.1 sürümü oluşturulur.
- v.1 sürümü mevcutsa 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ü (örneğin, v.1) için Test et'i tıklarsanız yeni sürüm v.1. 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ü verilmemiş 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şturmanız.
- Entegrasyon için üretim Tedarikçi Firma Kimliği (VID) girildi.
- Kurulum ve marka bilinci oluşturma öğelerini yapılandırın.
Entegrasyonunuz için bunların tümünü tamamlamadıysanız sertifika testi için oluşturulan bir entegrasyon sürümü onaylanamaz. Yeni bir sürüm oluşturmanız gerekir. Bu da Test, Saha Denemesi ve Sertifikalandırma adımlarını yeniden yapacağınız anlamına gelir.
Ayrıca, 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 listesinde, çalışmak istediğiniz projenin yanındaki Aç seçeneğini 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.
Bir test türü seçin: Geliştirme testi veya Sertifika testi.
- 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 cihazlar listesinden test etmek istediğiniz cihazları seçin.
Sıradaki: 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 konumundan çıkmak isterseniz Geliştirici Merkezi'ne dön'ü tıklayın.
Test planını çalıştırma
Test Suite sayfasındaki Test planı oluşturun sayfasında Testi Çalıştır'ı tıklayın. Tüm testlerin durumu ve günlüklerini içeren 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ütme tamamlandıktan sonra üst kısımdaki
Retest'i (Yeniden test et) tıklayın.Tamamlandığında:
- Test geçmişi sayfasına gitmek için Bitti'yi tıklayın veya
- Sertifika test sonuçlarını 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 ait ö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ünde Sonuçlar'ı tıklayın.
Entegrasyon sürümü için test sonuçlarına Developer Console'daki Test sekmesinden de erişilebilir. Test Suite içindeki Test geçmişi sayfasına gitmek üzere 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 | integration uygulamasının bu sürümü test edilmeye hazır. | Yok | Bu integrationsürümünü test edin. |
Test edildi | Hazır | Bu integration sürümü test edilmiş olup 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 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 cihaz görünmüyorsa bunun nedeni muhtemelen birden çok entegrasyonda aynı test VID'si ve PID kombinasyonunu kullanmanızdır.
Sorunu gidermek için Developer Console platformundaki tüm test cihazlarını kaldırıp 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'sini/PID'sini doğrulayın
Google ile entegrasyonunuzu geliştirmeye başlamak istiyorsanız Google Home Console'da 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. 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şaretleme cihazının VID/PID değerini 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 başlayarak 5A23FFFE
olarak listelendiğini görürsünüz. Bu, her ikisi de küçük endian biçiminde olan 5A23
VID ve FFFE
PID değerlerini gösterir.
BLE uygulaması,değerleri küçük bir endian dilinde görüntüler ancak Developer Console projenize girdiğiniz VID/PID değerleri büyük endiandadır.
Bluetooth algılayıcı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.