Matter Buluttan buluta Yerel Home 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ı, Matter 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şmenizi sağlar.
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'un içinde Assistant Simulator, komutlarınıza dayanarak kısa mesajlarla yanıt verir. Örneğin, "Tamam, ışığı açıyorum." Daha fazla bilgi için Google Asistan Simülatörü'nü Kullanma başlıklı makaleye göz atın.
Toplu İfadeler
Google Home entegrasyonunuzu otomat gibi test etmek için bir telaffuz komut dosyası çalıştırarak Google Asistan Simülatörü'ne toplu ifadeler gönderebilirsiniz. Daha fazla bilgi için Toplu İfadeleri Ç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ıklama ile 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ı raporlamak üzere Google'a gönderilebilir.
Cloud Logging
Cloud Logging, işleminizin kullanımıyla ilgili analizler için hata ayıklama bilgileri ve temel metrikler sağlar. Geliştirmeyi basitleştirmek için Google Home Extension, sorun giderme sırasında kodunuzun hemen yanında gerçek zamanlı Google Cloud Logging mesajlarını gösterir. Daha fazla bilgi için Cloud Logging'i görüntüleme bölümüne bakın.
Home Graph Görüntüleyici
Home Graph Viewer artık doğrudan Google Home Extension içinde 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'yi yüklemek için VS Code'dan şu adımları uygulayın:
- Etkinlik Çubuğunda Uzantılar simgesini tıklayın.
google homearaması yapın ve ardından Yükle'yi tıklayın.
Google Home Extension dosyasını doğrudan VS Code Marketplace'ten de indirebilirsiniz.
VS Code için Google Home Uzantısı kurma
Google Home Extension eklentisini yükleyip VS Code'u yeniden yükledikten sonra Assistant Simulator kullanıp Cloud Logging'i görüntüleyebilmek için oturum açıp 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ğundaki 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çma 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 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 Proje seç'i tıklayın.
Görünen Proje arayın ve seçin açılır penceresinde akıllı ev projenizi seçin.
Android Debug Bridge (ADB) Aracını Yükleme
Bir Android telefonunda Matter günlüklerini 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 Cihaz 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/ttyUSBxveya MacOS'te/dev/tty.SLAB_USBtoUARTya da/dev/tty.usbserialgibi seri bağlantı noktalarını dışa aktarır. LogViewer, günlüğü doğrudan cihazdan okuyabilir. - NXP veya Silicon Labs gibi bazı SoC 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
Geliştirici Kaynaklarını Göster
YARDIM VE GERİ BİLDİRİM bölümünde, Başlayın ve Kaynaklar'ı tıklayarak Kaynaklar sayfasını açın. Bu sayfada, Google Home ekosistemiyle geliştirmenizle ilgili faydalı bilgiler bulabilirsiniz.
Google Asistan Simülatörü'nü Kullanma
Assistant Simulator eklentisini 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 sorgunuzdan sonraki düğmeyi tıklayarak Yeniden Gönder'i seçebilirsiniz.
Toplu İfadeleri Çalıştır
Farenizi GOOGLE ASSISTANT SIMULATOR menü çubuğunun üzerine getirin ve komut dosyalarını ayarlamak için aşağıdaki seçeneklerden birini belirleyin:
Mevcut ifade komut dosyalarını açmak için öğesini tıklayın.
Geçmişi
*.utterancekomut dosyasına kaydetmek için simgesini tıklayın.
Toplu ifadeleri göndermeye başlamak için aşağıdaki seçeneklerden birini belirleyin:
- Açılır pencereden bir ifade komut dosyası seçmek için simgesini tıklayın.
Doğrudan bir
*.utterancedosyası 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 Bulut 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, seçilen projeye ait cihazları bulabileceğiniz Home Graph Görüntüleyici panelini açmak için Home Graph Görüntüleyici'yi tıklayın. Ayrıca, cihaz için test çalıştırmak üzere Run Test (Test Çalıştır) seçeneğini de 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ı kontrol edebilir 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 unutmayın. Bu sayede yalnızca GHA ve Google Play services Matter modülü ile ilgili günlükler gösterilir. Ayrıca, günlükleri filtrelemek için Önem Derecesi'ni ayarlayabilir veya anahtar kelimeyi günlüklerde Arama gerçekleştirebilirsiniz.
Matter Cihaz Günlük Kaydı
GÜNLÜK GÜNCELLEME ARAÇLARI bölümünde Cihaz Günlükleri'ni tıklayarak Kaynaklar sayfasını açın, ardından önce SoC Türü'nü seçin:
Daha sonra Konu Cihaz'ı seçin:
Böylece, 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 indir
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. Bu işlemde 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önder
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 Geri Bildirim Gönder'i tıklayarak bize önerilerinizi iletebilirsiniz.
- 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 da bir geri bildirim simgesi sağladık.