VS Code için Google Home Uzantı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.

VS Code için Google Home Uzantısı

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.

Google Home Uzantı Konu Kaydı

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:

  1. Etkinlik Çubuğunda Uzantılar simgesini tıklayın.
  2. google home araması yapın ve ardından Yükle'yi tıklayın.

    Google Home Uzantı Pazar Yeri

Google Home Extension dosyasını doğrudan VS Code Marketplace'ten de indirebilirsiniz.

İndir Google Home Extension

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.

  1. Google Home Extension uygulamasını açmak için Etkinlik Çubuğundaki Google Home simgesini tıklayın.

    Google Home uzantısı simgesi
  2. Tarayıcınızda giriş görünümünü başlatmak için Google ile oturum aç'ı tıklayın.

    VS Code Google ile Oturum Açma
  3. Akıllı ev cihazlarınıza bağlı hesabı seçin.

  4. Google ile oturum açma yetkilendirme sayfasında İzin ver'i tıklayın.

  5. 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.

    VS Code iletişim kutusunu aç
  6. 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 'ı tıklayın.

    Google Home uzantısının bir URI açmasına izin ver
  7. Google Home Extension, oturum açtıktan sonra projelerinizi yükler. Bittiğinde Proje seç'i tıklayın.

    Proje seç
  8. 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:

  1. Bilgisayarınıza ADB'yi yükleyin.
  2. 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:

  1. Ç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.
  2. 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 Home Ekosistemi ile İlgili Kaynaklar

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.

Google Asistan Simülatörü'nü Kullanma

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 *.utterance komut dosyasına kaydetmek için simgesini tıklayın.

    Toplu İfadeler Menü Simgeleri

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 *.utterance dosyası açın ve simgesini tıklayın.

    Toplu İfadeleri Çalıştır Simgesi

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.

Cloud Logging'i kullanma

Kullanıcılar günlükleri önem derecesine ve zaman aralığına göre filtreleyebilir.

Günlükleri önem derecesine ve zamana göre filtreleyin

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.

Daha fazla günlük göster

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.

Home Graph Görüntüleyici

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.

Google Home Test Paketi

Test ayrıntılarını kontrol edebilir ve tüm testler tamamlandıktan sonra günlükleri görüntüleyebilirsiniz.

Test sonuçları

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 Günlük Kaydı

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.

Android Günlük Kaydı Filtrelendi

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:

Matter cihaz günlük kaydı

Daha sonra Konu Cihaz'ı seçin:

Matter cihaz günlüğü kayıt seçme cihazı

Böylece, cihazdaki tüm cihaz günlüklerini alabilir ve ilgilendiğiniz bilgileri bulmak için Önem derecesi ve Arama gibi filtreleri kullanabilirsiniz.

Matter cihaz filtreli günlük kaydı

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.

Konu Günlüklerini İndir

Günlüklerin indirileceği klasörü seçin ve Kaydet'i tıklayın:

Konu Günlüğüne Kaydetme

Ardından günlükler hedef klasöre kaydedilir:

Konu Günlüğü Hedef Klasörü

Kaydedilen zip dosyasını çıkarın. Bu işlemde cihaz bilgileri ve günlük dosyaları gösterilir.

Konu Günlüğü Zip Dosyası

Cihaz bilgileri dosyası, sorunları ayıklamak için gereken tüm sürüm bilgilerini içerir.

Konu Günlüğü Hata Ayıklama

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.
Geri Bildirim Gönder Simgesi
  • Kaynaklar sayfasında da bir geri bildirim simgesi sağladık.