Google Home Developer Console, Google Home Test Suite kullanarak Matter entegrasyonunuzda testler yapılandırıp çalıştırabileceğiniz bir Test sayfası sunar. Test Suite, tüm entegrasyon testlerini gerçekleştiren, Developer Console içine yerleşik ayrı bir uygulamadır.
Entegrasyonun Tedarikçi Kimliği ve Ürün Kimliği için cihazların devreye alınması ve test edilebilmesi için Developer Console ile kullanılan hesap için Google Home app (GHA) içinde mevcut olması gerekir. Daha fazla bilgi için Matter cihazı eşleme başlıklı makaleye göz atın.
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 çalıştırmanız çok önemlidir.
Test sayfasında, tamamlanmış ve test edilmeye hazır olan Matter entegrasyonlar Test edilmeye hazır bölümünde listelenir.
Test edilen Matter entegrasyonları, Test edildi bölümünde listelenir.
Test planı türleri
Aşağıdaki test planı türleri kullanılabilir:
Geliştirme test planları, Matter kullanarak cihazları kontrol etmeyi test etmek için kullanılır. Bu reklamlar düzenlenebilir ancak Matter sertifikası için gönderilemez.
Sertifikasyon test planları, Matter sertifikasyonuna özeldir ve düzenlenemez. Bu seçeneği belirlediğinizde Matter entegrasyonunuzun yeni bir sürümü oluşturulur.
CSA Interop test planları, test aşamasını atlamanıza ve Connectivity Standards Alliance (Alliance) Interop Test Lab sonuçlarınızı kullanmanıza olanak tanır. Bu test seçeneği, desteklenen tüm cihaz türleri için kullanılabilir ve Aliro uyumlu kapı kilitleri için Aliro sertifikası almanın tek geçerli yoludur.
Sertifika için test sonuçlarını göndermek üzere Developer Console içindeki Test Suite 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 Paketi 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 numaralandırılmış sürüm, Test sekmesinden itibaren Developer Console içindeki tüm entegrasyon listelerinde yer alır.
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 entegrasyonun 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'i temel almaz. Bunun yerine bu sürüm, v.1'de olduğu gibi entegrasyonun sürümsüz örneğini temel alır.
Bir entegrasyonun N/A sürümü, entegrasyonun sürüme sahip olmayan örneğini temsil eder. Bu örnek, Develop (Geliştirme) sekmesinde yönetilir.
Başka bir ifadeyle, Developer Console içinde Matter > Test'te:
- Entegrasyonun Yok sürümü için Test'i tıklarsanız yeni bir sürüm oluşturulur. Sürüm numarası, mevcut numaralı sürümlerden bir sayı daha yüksek olur.
- Numaralandırılmış 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 numaralandırılmış bir sürümü (ör. v.1) için Test et'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ümü oluşturma başlıklı makaleyi inceleyin.
Test planı oluşturma
Entegrasyon sürümleri, sürüme sahip olmayan bir entegrasyonun anlık görüntüsüdür. Yani sertifika için bir test planı ve dolayısıyla bir entegrasyon sürümü oluşturduğunuzda bu entegrasyonla ilgili tüm meta veriler, kullanıma sunulan entegrasyon için kullanmak istediğiniz bilgiler olmalıdır.
Sertifika için test planı oluşturmadan önce aşağıdakileri yaptığınızdan emin olun:
- Şirket profili oluşturmuş olmanız gerekir.
- Entegrasyon için üretim tedarikçi kimliğini (VID) girmiş olmanız gerekir.
- Yapılandırılmış kurulum ve markalama.
Entegrasyonunuz için bu adımları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 Sertifika adımlarını yeniden yapmanız gerektiği anlamına gelir.
Bir entegrasyon sürümü onaylanmadan önce markanızı güncellemek istiyorsanız da yeni bir sürüm oluşturmanız ve baştan başlamanız 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 entegrasyonun N/A sürümü için Test'i tıklayın. Bu işlem, yeni bir entegrasyon sürümü oluşturur.
Bir test türü seçip Test et'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.
Matter entegrasyon akışındaki Test ve Saha Denemesi aşamalarını atlamak için Alliance Birlikte Çalışabilirlik Test Laboratuvarı sonuçlarınızı kullanmak üzere CSA Birlikte Çalışabilirlik testi'ni seçin. CSA Interop test'i (CSA Birlikte Çalışabilirlik testi) seçtikten sonra yapılandırma profiline bir izleme adı atayın, cihazın ürün kimliğini (PID) eşleyin ve doğrudan Certification'a (Sertifika) geçmek için Submit'i (Gönder) tıklayın.
Aliro uyumlu kapı kilitleri için Aliro sertifikası almak istiyorsanız CSA Interop test'i (CSA birlikte çalışabilirlik testi) seçmeniz gerekir. Farklı bir test seçeneği belirlerseniz yeni bir entegrasyon sürümü oluşturup yeniden göndermeniz gerekir.
Sertifika testi veya Geliştirme testi'ni seçtiyseniz Testinizi yapılandırın ekranında testiniz için bir ad girin ve eşlenecek cihazı seçmek için Cihazı otomatik olarak eşle'yi tıklayın.
Android cihazlar için:
- Telefonunuza GHA uygulamasını yüklediğinizden emin olun.
- Telefonunuzu bir USB kablosuyla ana makineye bağlayın.
- Cihazınızda USB üzerinden hata ayıklamayı etkinleştirmeniz gerekir.
APKcom.chip.interop.moblysnippetotomatik olarak indirilip yüklenecek. - Telefonunuz bağlandıktan sonra cihazınızı otomatik olarak eşlemek için Eşleme kodu ve Cihaz adı'nı girin.
iOS cihazlar için:
- Cihazınızı manuel olarak eşlemeniz gerekir. Manuel eşleme talimatları için Google Home uygulaması bölümüne bakın.
- Mevcut bir cihazınız varsa cihazın eşlemesini kaldırmanız ve tekrar eşlemeniz ya da yeni bir cihaz eşlemeniz istenebilir.
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 sayfasından çıkmak istiyorsanız Geliştirici Merkezi'ne dön'ü tıklayın.
Test planını çalıştırma
Test Suite uygulamasında, Create a test plan (Test planı oluşturun) sayfasında Run Test'i (Testi çalıştır) tıklayın. Tüm testlerin durumunu ve günlüklerini içeren Test ortamı sayfası gösterilir.
Test sonuçlarınız, testler tamamlandıktan sonra gösterilir. Her test paketi yürütme işleminin durumu yanında gösterilir (Başarılı, Başarısız).
Günlükler bölmesinde her bir test yürütme işleminin durumu gösterilir.
Bir test planını Test ortamı sayfasından yeniden test etmek için test işlemi tamamlandıktan sonra üst kısımdaki Yeniden test et'i tıklayın.
İşlem tamamlandığında:
- Test geçmişi sayfasına gitmek için Bitti'yi tıklayın veya
- Test sonuçlarını sertifika için göndermek üzere 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 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şlem sizi, testin sonuçlarını gösteren Test Ortamı sayfasına yönlendirir.
Gönderilen bir sertifika planı için Sertifika için kaydedildi bölümünde Sonuçlar'ı tıklayarak test sonuçları raporunu görüntüleyin.
Test sonuçlarına, Developer Console içindeki Test sekmesinden bir entegrasyon sürümü için de erişilebilir. Test Suite'ndaki Test geçmişi sayfasına yönlendirilmek için bu sayfada listelenen herhangi bir entegrasyon sürümünün Test geçmişi bölümünde Görüntüle'yi tıklayın.
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 uygulamasının bu sürümü test edilmeye hazır. | Yok | integrationuygulamasının bu sürümünü test edin. |
| Test edildi | Hazır | integration uygulamasını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 et'i tıklayın. |
Tekrar test et
Sertifika
Sertifika için yeniden test etmeniz gerekiyorsa yeniden test etmeye başladıktan sonra cihazınızı eşlemeniz gerekir.
Geliştirme
Geliştirme için yeniden test etmeniz gerekiyorsa mevcut cihazı tekrar eşlemeden kullanabilirsiniz.
Sorun giderme
Yetkilendirilen cihaz, test paketinde görünmüyor
Bir cihazı test Tedarikçi Kimliği (VID) ve Ürün Kimliği (PID) ile eşlediyseniz ancak Developer Console uygulamasında cihazı Test Paketi ile test etmeye çalıştığınızda görünmüyorsa bunun nedeni muhtemelen birden fazla entegrasyonda aynı test VID ve PID kombinasyonunun kullanılmasıdır.
Sorunu gidermek için tüm test cihazlarını Developer Console uygulamasından kaldırın ve test etmek istediğiniz cihazı tekrar 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 geliştirme sürecinin aşağıdaki aşamalarında kullanılamazlar:
nRF Connect for Mobile gibi bir Bluetooth mühendislik uygulaması kullanarak işaret cihazının VID/PID'sini Service Data (Hizmet Verileri) alanında 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 şeklinde listelendiğini görebilirsiniz. Bu, 5A23 VID ve FFFE PID değerlerini gösterir. Her ikisi de little endian biçimindedir.
BLE uygulaması,değerleri little-endian biçiminde gösterir ancak Developer Console projenize girdiğiniz VID/PID değerleri big-endian biçimindedir.
Bluetooth sniffer'ın gösterdiği değerlere göre 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.