Matter Buluttan buluta Yerel Ev SDK'sı Cihaz SDK'sı
Google Home Extension for Visual Studio Code, Google Home Platform geliştiricileri için tasarlanmış ve oluşturulmuştur. Bu uzantı sayesinde, Konu ve akıllı ev geliştirme sürecinizi basitleştirmek için Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer ve diğer araçlara erişebilirsiniz.
Google Home Uzantı Özellikleri
Google Asistan Simülatörü
Akıllı ev cihazlarınızın Google Home ekosistemiyle düzgün çalışıp çalışmadığını test etmek için VS Code'dan ayrılmadan istediğiniz zaman Assistant Simulator ile etkileşimde bulunabilirsiniz.
Actions Console'da sunulan mevcut Simülatör'e benzer şekilde Assistant Simulator, "Işığı aç" gibi sorgularınızı yazarak cihazlarınızı kolayca kontrol etmenizi sağlar. VS Code'da Assistant Simulator, komutlarınıza dayanarak kısa mesajlarla yanıt verir. Örneğin, "Tamam, ışığı açıyorum." Daha fazla ayrıntı için Google Asistan Simülatörü'nü Kullanma bölümüne bakın.
Toplu İfadeler
Google Home entegrasyonunuzu otomat gibi test etmek için bir telaffuz komut dosyası çalıştırarak toplu ifadeleri Google Asistan Simülatörü'ne gönderebilirsiniz. Daha fazla ayrıntı için Toplu İfadeler Çalıştırma bölümüne bakın.
Konu Günlük Kaydı Araçları
Matter Logging Araçları, Google Home app (GHA) günlükleri ve Google Play Hizmetleri (GMS Core) günlükleri de dahil olmak üzere Matter hata ayıklamasıyla ilgili tüm günlükleri toplayabilir. Günlükler, VS Code'da filtre ve anahtar kelime aramalarıyla görüntülenebilir. Günlükler, Android ve Uygulama sürümü gibi ek hata ayıklama bilgileriyle birlikte indirilebilir ve sorunları bildirmek için Google'a gönderilebilir.
Cloud Logging
Cloud Logging İşleminizin kullanımı hakkında size bilgi verecek hata ayıklama bilgileri ve önemli metrikler sağlar. Google Home Extension, geliştirmeyi basitleştirmek için sorun giderme sırasında kodunuzun hemen yanında gerçek zamanlı Google Cloud Logging mesajları gösterir. Daha fazla bilgi için Cloud Logging'i görüntüleme bölümünü inceleyin.
Home Graph Görüntüleyici
Home Graph Viewer artık doğrudan Google Home Extension'da kullanılabilir. Böylece VS Code'daki Home Graph'te cihazın durumunu doğrulayabilirsiniz. Daha fazla bilgi için Ana Sayfa Grafiğini Görüntüleme ve Testleri Çalıştırma bölümüne bakın.
VS Code için Google Home Uzantısı'nı yükleyin
Google Home Extension öğesini yüklemek için VS Code'dan şu adımları uygulayın:
- Etkinlik Çubuğu'nda Uzantılar simgesini tıklayın.
google home
araması yapın, ardından Yükle'yi tıklayın.
Google Home Extension öğesini doğrudan VS Code Marketplace'ten de indirebilirsiniz.
VS Code için Google Home Uzantısı'nı kurun
Google Home Extension eklentisini yükledikten ve VS Code'u yeniden yükledikten sonra Assistant Simulator uygulamasını kullanıp Cloud Logging'i görüntüleyebilmek için oturum açmanız ve bir proje seçmeniz gerekir.
Google ile oturum açın ve bir bulut projesi seçin
Google Home Extension adresinden geliştirici hesabınızda oturum açarak VS Code'u sizin adınıza Google hizmetleriyle iletişim kurması için yetkilendirebilirsiniz.
Google Home Extension uygulamasını açmak için Etkinlik Çubuğu'ndaki Google Home simgesini tıklayın.
Tarayıcınızda giriş görünümünü başlatmak için Google ile oturum aç'ı tıklayın.
Akıllı ev cihazlarınıza bağlı hesabı seçin.
Google ile oturum aç yetkilendirme sayfasında İzin ver'i tıklayın.
Bir tarayıcı sekmesi açılır ve Visual Studio Kodunu Aç iletişim kutusu gösterilir. Devam etmek için Open Visual Studio Code'u (Visual Studio Code'u Aç) tıklayın.
Google Home uzantısının bir URI açmasına izin vermek için izin vermeniz gereken VS Code'a yönlendirileceksiniz. Giriş işlemini tamamlamak için Aç'ı tıklayın.
Google Home Extension, oturum açtıktan sonra projelerinizi yükler. Bittiğinde Select a project'i (Proje seç) tıklayın.
Gösterilen Proje arayın ve seçin açılır penceresinde akıllı ev projenizi seçin.
Android Debug Bridge (ADB) Aracını Yükle
Matter günlüklerini bir Android telefonunda görüntülemek için ADB'yi yüklemeniz gerekir:
- Bilgisayarınıza ADB'yi yükleyin.
- Android telefonunuzda Geliştirici Seçenekleri ve USB Hata Ayıklaması'nı açın.
Matter Device SoC Araçlarını Yükleyin
Matter cihazdaki hata ayıklama günlüklerini görüntülemek için:
- Çoğu cihaz çip üzerinde sistem (SoC), Linux'ta
/dev/ttyUSBx
veya MacOS'te/dev/tty.SLAB_USBtoUART
ya da/dev/tty.usbserial
gibi seri bağlantı noktalarını dışa aktarır. LogViewer, günlüğü doğrudan cihazdan okuyabilir. - NXP veya Silicon Labs gibi bazı çip üzerinde sistem türleri için harici araçların (ör. JLink) yüklenmesi gerekebilir. Daha fazla bilgi için Desteklenen cihazlar bölümüne bakın.
VS Code için Google Home Uzantısını Kullanın
Geliştirici Kaynaklarını Göster
YARDIM VE GERİ BİLDİRİM bölümünde, Google Home ekosistemindeki geliştirmelerinizle ilgili yararlı bilgiler bulabileceğiniz Kaynaklar sayfasını açmak için Başlayın ve Kaynaklar'ı tıklayın.
Google Asistan Simülatörü'nü Kullanma
Assistant Simulator aracını VS Code'da açmak için Kenar Çubuğundaki GOOGLE ASİSTAN SIMULATOR'u tıklayın. İleti kutusuna sorgunuzu yazın ve Enter
tuşuna basın.
Assistant Simulator yanıtlarını görüntüleyebilir ve sorgunuzun ardından gelen düğmeyi tıklayarak Yeniden gönderebilirsiniz.
Toplu İfadeleri Çalıştırma
Farenizi GOOGLE ASSISTANT SIMULATOR menü çubuğunun üzerine getirin ve komut dosyalarını ayarlamak için aşağıdaki seçeneklerden birini belirleyin:
Mevcut telaffuz komut dosyalarını açmak için
öğesini tıklayın.Geçmişi
*.utterance
komut dosyasına kaydetmek için düğmesini tıklayın.
Toplu ifadeleri göndermeye başlamak için aşağıdaki seçeneklerden birini belirleyin:
- Açılır pencereden bir telaffuz komut dosyası seçmek için öğesini tıklayın.
Doğrudan bir
*.utterance
dosyasını açın ve simgesini tıklayın.
Cloud Logging'i göster
HIZLI ERİŞİM bölümünde, seçtiğiniz projeye ait günlükleri bulabileceğiniz Cloud Günlükleri sayfasını açmak için Cloud Günlükleri'ni tıklayın.
Kullanıcılar günlükleri önem derecesine ve zaman aralığına göre filtreleyebilir.
Varsayılan olarak günlükler 50 satırla sınırlıdır. Kullanıcı daha fazla günlük görmek isterse en alta ilerleyin ve daha fazla günlük görüntülemek için Diğer'i tıklayın.
Ana Sayfa Grafiği'ni Görüntüleyin ve Testleri Çalıştırın
HIZLI ERİŞİM altında Home Graph Viewer'ı tıklayarak Home Graph Viewer panelini açın. Burada, seçilen projeye ait cihazları bulabilirsiniz. Cihaz için testler çalıştırmak üzere Testi Çalıştır'ı da tıklayabilirsiniz.
Bu işlem, tarayıcınızda test paketini, cihazınız seçili ve teste hazır bir şekilde başlatır. Başlat'ı tıklayın ve test sonuçlarını bekleyin.
Test ayrıntılarını inceleyebilir ve tüm testler tamamlandıktan sonra günlükleri görüntüleyebilirsiniz.
Konu Hata Ayıklaması için Google Home Uzantısını Kullanma
Android Günlük Kaydı
GÜNLÜK GÜNCELLEME ARAÇLARI bölümünde Android Günlükler'i tıklayarak Android Günlükler sayfasını açın, bağlanmak istediğiniz Android telefonu seçin ve günlükleri göstermeye başlayın.
Android telefonu bağlandıktan sonra günlükleri satır satır görebilirsiniz. Günlüklerin filtrelendiğini, yani yalnızca GHA ve Google Play services Matter modülü ile ilgili günlüklerin gösterildiğini unutmayın. Ayrıca, günlükleri filtrelemek veya anahtar kelimeyi günlüklerde Arama yapmak için Önem Düzeyi'ni de ayarlayabilirsiniz.
Matter Cihaz Günlük Kaydı
GÜNLÜK GÜNCELLEME ARAÇLARI'nın altında Cihaz Günlükleri'ni tıklayın ve Kaynaklar sayfasını açın, önce SoC Türü'nü seçin:
Ardından Konu Cihazı'nı seçin:
Ardından, cihazdaki tüm cihaz günlüklerini alabilir ve ilgilendiğiniz bilgileri bulmak için Önem Derecesi ve Arama gibi filtreleri kullanabilirsiniz.
Tüm Konu Günlüklerini İndir
HIZLI ERİŞİM bölümünde Günlükleri İndir iletişim kutusunu açmak için Günlükleri İndir'i tıklayın, indirilecek günlükleri seçin ve Tamam'ı tıklayın.
Günlüklerin indirileceği klasörü seçin ve Kaydet'i tıklayın:
Ardından günlükler hedef klasöre kaydedilir:
Kaydedilen ZIP dosyasını çıkarın. Cihaz bilgileri ve günlük dosyaları gösterilir.
Cihaz bilgileri dosyası, sorunları ayıklamak için gereken tüm sürüm bilgilerini içerir.
Geri bildirim gönderin
Google Home Extension ile geliştirme deneyimini nasıl iyileştirebileceğimiz konusunda düşüncelerinizi veya geri bildirimlerinizi göndermek için aşağıdaki seçeneklerden birini belirleyin:
- YARDIM VE GERİ BİLDİRİM panelinde, bize önerilerde bulunmak için Geri Bildirim Gönder'i tıklayın.
- Google Home Extension ile ilgili bulduğunuz herhangi bir sorunu bildirmek için YARDIM VE GERİ BİLDİRİM panelinde Sorun Bildir'i tıklayın.
- Kaynaklar sayfasında bir geri bildirim simgesi de sağladık.