VS Code için Google Home Uzantısı

Google Home Extension for Visual Studio Code, Google Home Platformu geliştiricileri için tasarlanmış ve oluşturulmuştur. Bu uzantı, Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer ve diğer araçlara erişmenizi sağlayarak Matter ve akıllı ev geliştirme sürecinizi basitleştirir.

VS Code için Google Home uzantısı

Google Home Extension Ö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 çıkmadan istediğiniz zaman Assistant Simulator ile etkileşimde bulunabilirsiniz.

Assistant Simulator, sorgularınızı yazarak cihazlarınızı kolayca kontrol etmenizi sağlar. Örneğin, "Işığı aç." VS Code'da Assistant Simulator, komutlarınıza göre metin mesajlarıyla yanıt verir. Örneğin, "Tamam, ışığı açıyorum." Daha fazla bilgi için Google Asistan Simülasyon Aracı'nı kullanma başlıklı makaleyi inceleyin.

Toplu Konuşma

Google Home entegrasyonunuzu otomat gibi test etmek için bir ifade komut dosyası çalıştırarak Google Asistan Simülatörü'ne toplu ifadeler gönderebilirsiniz. Daha fazla bilgi için Toplu Konuşma Çalıştırma bölümüne bakın.

Matter Günlük Kaydı Araçları

Matter Günlük Kaydı Araçları, Matter hata ayıklama ile ilgili tüm günlükleri (Google Home app (GHA) günlükleri ve Google Play Hizmetleri (GMS Core) günlükleri dahil) 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.

Google Home Extension Matter Logging

Cloud Logging

Cloud Logging, hata ayıklama bilgileri ve önemli metrikler sağlayarak İşleminizin kullanımıyla ilgili analizler sunar. Geliştirmeyi kolaylaştırmak için Google Home Extension, sorun giderme sırasında gerçek zamanlı Google Cloud Logging mesajlarını kodunuzun hemen yanında 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 Görüntüleyici artık doğrudan Google Home Extension içinde kullanılabilir. Böylece, VS Code'da Home Graph'inizdeki cihazın durumunu doğrulayabilirsiniz. Daha fazla bilgi için Ev Grafiği'ni Görüntüleme ve Testleri Çalıştırma başlıklı makaleyi inceleyin.

VS Code için Google Home uzantısını yükleme

Google Home Extension'ı yüklemek için VS Code'da şu adımları uygulayın:

  1. Etkinlik çubuğundaki Uzantılar simgesini tıklayın.
  2. google home eklentisini arayın ve Yükle'yi tıklayın.

    Google Home Extension Marketplace

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

İndir Google Home Extension

VS Code için Google Home uzantısını kurma

Google Home Extension uygulamasını yükleyip VS Code'u yeniden yükledikten sonra Assistant Simulator uygulamasını kullanabilmek ve 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çabilir, böylece VS Code'un sizin adınıza Google hizmetleriyle iletişim kurmasına izin verebilirsiniz.

  1. Etkinlik çubuğunda Google Home simgesini tıklayarak Google Home Extension açı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'da 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 Open Visual Studio Code (Visual Studio Code'u Aç) iletişim kutusu gösterilir. Devam etmek için Open Visual Studio Code'u (Visual Studio Code'u aç) tıklayın.

    VS Code iletişim kutusunu açma
  6. VS Code'a yönlendirilirsiniz. Burada, Google Home Uzantısı'nın URI açmasına izin vermeniz gerekir. Oturum açma işlemini tamamlamak için 'ı tıklayın.

    Google Home Uzantısı'nın URI açmasına izin ver
  7. Oturum açtıktan sonra Google Home Extension projelerinizi yükler. İşlem tamamlandığında Proje seçin'i tıklayın.

    Proje seç
  8. Görüntülenen Proje arayın ve seçin açılır penceresinde akıllı ev projenizi seçin.

Android Debug Bridge (ADB) aracını yükleme

Matter günlüklerini bir Android telefonda görüntülemek için ADB'yi yüklemeniz gerekir:

  1. ADB'yi bilgisayarınıza yükleyin.
  2. Android telefonunuzda Geliştirici Seçenekleri ve USB üzerinden hata ayıklama'yı etkinleştirin.

Matter Device SoC Tools'u yükleme

Matter cihazındaki hata ayıklama günlüklerini görüntülemek için:

  1. Çoğu cihaz SoC'si, Linux'ta /dev/ttyUSBx, MacOS'te ise /dev/tty.SLAB_USBtoUART veya /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ürlerinin 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ı kullanma

Geliştirici Kaynaklarını Görüntüleme

YARDIM VE GERİ BİLDİRİM bölümünde Başlangıç ve Kaynaklar'ı tıklayarak Kaynaklar sayfasını açın. Bu sayfada, Google Home ekosistemiyle geliştirme yaparken faydalı bilgiler bulabilirsiniz.

Google Home Ekosistemi için Kaynaklar

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

VS Code'da Assistant Simulator simgesini açmak için Yan Çubuk'ta GOOGLE ASİSTAN SİMÜLATÖRÜ'nü tıklayın. Mesaj kutusuna sorgunuzu yazıp Enter tuşuna basın.

Assistant Simulator yanıtları görüntüleyebilir ve sorgunuzdan sonraki düğmeyi tıklayarak sorguyu yeniden gönderebilirsiniz.

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

Toplu Konuşma Çalıştırma

Fareyle GOOGLE ASİSTAN SİMÜLATÖRÜ menü çubuğunun üzerine gelin ve komut dosyalarını ayarlamak için aşağıdaki seçeneklerden birini belirleyin:

  • Mevcut konuşma metinlerini açmak için simgesini tıklayın.

  • Geçmişi *.utterance komut dosyasına kaydetmek için simgesini tıklayın.

    Toplu Konuşma Menüsü Simgeleri

Toplu ifadeler göndermeye başlamak için aşağıdaki seçeneklerden birini belirleyin:

  • Açılır pencereden bir konuşma metni seçmek için simgesini tıklayın.
  • Doğrudan bir *.utterance dosyasını açıp simgesini tıklayın.

    Toplu Konuşma Çalıştırma Simgesi

Cloud Logging'i görüntüleme

HIZLI ERİŞİM bölümünde Cloud Günlükleri'ni tıklayarak Cloud Günlükleri sayfasını açın. Bu sayfada, seçtiğiniz projeye ait günlükleri bulabilirsiniz.

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 filtreleme

Varsayılan olarak, günlükler 50 satırla sınırlıdır. Kullanıcı daha fazla günlük görüntülemek isterse en alta kaydırıp Diğer'i tıklayarak daha fazla günlük görüntüleyebilir.

Daha fazla günlük görüntüleme

Home Graph'i görüntüleme ve test çalıştırma

HIZLI ERİŞİM bölümünde Home Graph Viewer'ı tıklayarak Home Graph Viewer panelini açın. Bu panelde, seçilen projeye ait cihazları bulabilirsiniz. Cihaz için test çalıştırmak üzere Testi Çalıştır'ı da tıklayabilirsiniz.

Home Graph Görüntüleyici

Bu işlem, test paketini tarayıcınızda başlatır. Cihazınız seçilmiş ve test etmeye hazır hâldedir. Başlat'ı tıklayın ve test sonuçlarını bekleyin.

Google Home Test Paketi

Tüm testler tamamlandıktan sonra test ayrıntılarını inceleyebilir ve günlükleri görüntüleyebilirsiniz.

Test sonuçları

Matter hata ayıklaması için Google Home Extension'ı kullanma

Android Günlüğü

MATTER LOG KAYIT ARAÇLARI bölümünde Android Günlükler'i tıklayarak Android Günlükler sayfasını açın, Android bağlanmak istediğiniz telefonu seçin ve günlükleri göstermeye başlayın.

Android Günlüğü

Android telefon 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üyle ilgili günlüklerin gösterildiğini unutmayın. Günlükleri filtrelemek için Önem Derecesi'ni de ayarlayabilir veya günlüklerdeki anahtar kelimeyi Arama yapabilirsiniz.

Android Günlükleri Filtrelendi

Matter Cihaz Günlük Kaydı

MATTER LOG KAYIT ARAÇLARI bölümünde Kaynaklar sayfasını açmak için Cihaz Günlükleri'ni tıklayın, önce SoC Türü'nü seçin:

Matter cihaz günlük kaydı

Ardından, Matter Cihazı'nı seçin:

Matter cihazı günlük kaydı için cihaz seçme

Ardından, cihazdan tüm cihaz günlüklerini alabilir ve ilgilendiğiniz bilgileri bulmak için Önem Derecesi ve Arama gibi filtreleri kullanabilirsiniz.

Matter cihazı için filtrelenmiş günlük kaydı

Tüm Matter günlüklerini indirme

HIZLI ERİŞİM bölümünde Günlükleri İndir'i tıklayarak Günlükleri İndir iletişim kutusunu açın, indirilecek günlükleri seçin ve Tamam'a basın.

Konu Günlüklerini İndirme

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

Konu Günlüğünü Kaydetme

Günlükler hedef klasöre kaydedilir:

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

Kaydedilen ZIP dosyasını ayıklayın. Cihaz bilgileri ve günlük dosyaları gösterilir.

Matter günlük zip dosyası

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

Konu Günlüğünde Hata Ayıklama

Geri bildirim gönder

Google Home Extension ile geliştirme deneyimini nasıl iyileştirebileceğimizle ilgili düşüncelerinizi veya geri bildiriminizi göndermek için aşağıdaki seçeneklerden birini belirleyin:

  • YARDIM VE GERİ BİLDİRİM panelinde, önerilerinizi iletmek için Geri Bildirim Gönder'i tıklayın.
  • YARDIM VE GERİ BİLDİRİM panelinde, Google Home Extension ile ilgili bulduğunuz sorunları bildirmek için Sorun Bildir'i tıklayın.
Geri Bildirim Gönder simgesi
  • Ayrıca Kaynaklar sayfasında bir geri bildirim simgesi de ekledik.