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ı, Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer ve Matter ile akıllı ev geliştirme sürecinizi basitleştirecek diğer araçlara erişim sağlar.

VS Code için Google Home Uzantısı

Google Home Uzatma Ö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 (ör. "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 İfadeler

Google Home entegrasyonunuzu bir otomasyon 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 ifade çalıştırma bölümüne bakın.

Matter Günlük Kayıt Araçları

Madde Günlük Kaydetme Araçları, Google Home app (GHA) günlükleri ve Google Play Hizmetleri (GMS Core) günlükleri dahil olmak üzere Matter hata ayıklamayla ilgili tüm günlükleri toplayabilir. Günlükler, filtre ve anahtar kelime aramalarıyla VS Code'da görüntülenebilir. Günlükler, Android ve uygulama sürümü gibi ek hata ayıklama bilgileriyle indirilebilir ve sorunları bildirmek için Google'a gönderilebilir.

Google Home Uzantısı Konusu Günlüğe Kaydetme

Cloud Logging

Cloud Logging, işleminizle ilgili analizler sunmak için hata ayıklama bilgileri ve önemli metrikler sağlar. Geliştirmeyi kolaylaştırmak için Google Home Extension, sorun giderme sırasında gerçek zamanlı Google Cloud Günlük mesajlarını kodunuzun hemen yanında gösterir. Daha fazla bilgi için Cloud Logging'i görüntüleme başlıklı makaleyi inceleyin.

Home Graph Görüntüleyici

Home Graph Viewer artık doğrudan Google Home Extension'de kullanılabilir. Böylece, VS Code'daki Home Graph'ınızda cihazın durumunu doğrulayabilirsiniz. Daha fazla bilgi için Ana Sayfa Grafiğini Görüntüleme ve Testler Yapma 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 aşağıdaki adımları uygulayın:

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

    Google Home Uzantısı Pazarı

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

Google Home Extension dosyasını indirin

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

Google Home Extension'ü yükleyip VS Code'u yeniden yükledikten sonra Assistant Simulator'ü kullanabilmek ve Cloud Günlük'ü 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.

  1. Google Home Extension'i açmak için Etkinlik Çubuğu'ndaki 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'ta Google ile oturum açma
  3. Akıllı ev cihazlarınıza bağlı hesabı seçin.

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

  5. Bir tarayıcı sekmesi açılır ve Visual Studio Code'u aç iletişim kutusu gösterilir. Devam etmek için Visual Studio Code'u aç'ı tıklayın.

    VS Code iletişim kutusunu açma
  6. Google Home uzantısının URI açmasına izin vermek için izninizin gerekli olduğu VS Code'a yönlendirilirsiniz. Giriş işlemini tamamlamak için 'ı tıklayın.

    Google Home uzantısının URI açmasına izin verme
  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

Android telefonundaki Matter günlüklerini 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 Cihaz SoC Araçları'nı yükleme

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

  1. Çoğu cihaz SoC'si, Linux'da /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ürlerinde 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

YARDIMLA İLGİLİ BİLGİLER VE GERİ BİLDİRİM bölümünde Başlayın ve Kaynaklar'ı tıklayarak Google Home ekosistemiyle geliştirme çalışmalarınız için faydalı bilgiler bulabileceğiniz Kaynaklar sayfasını açın.

Google Home Ekosistemi için Kaynaklar

Google Asistan Simülasyon Aracı'nı kullanma

Assistant Simulator'ü VS Code'da açmak için Kenar Çubuğu'nda GOOGLE ASSISTANT SİMÜLATÖRÜ'nü tıklayın. Mesaj kutusuna sorgunuzu yazıp Enter tuşuna basın.

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

Google Asistan Simülasyon Aracı'nı kullanma

Toplu ifade çalıştırma

Fareyle GOOGLE ASSISTANT SIMULATOR menü çubuğunun üzerine gelin ve komut dosyaları oluşturmak için aşağıdaki seçeneklerden birini belirleyin:

  • Mevcut ifade komut dosyalarını açmak için simgesini tıklayın.

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

    Toplu İfadeler Menüsü Simgeleri

Toplu ifade 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ını açıp simgesini tıklayın.

    Toplu Sözler Ç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 seçtiğiniz projeye ait günlükleri bulabileceğiniz Cloud Günlükleri sayfasını açın.

Cloud Logging'i kullanma

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

Günlükleri öneme ve zamana göre filtreleme

Günlükler varsayılan olarak 50 satırla sınırlıdır. Kullanıcı daha fazla günlük görüntülemek isterse en alta gidip 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 Ana Sayfa Grafiği Görüntüleyici'yi tıklayarak Ana Sayfa Grafiği Görüntüleyici panelini açın. Bu panelde, seçili projeye ait cihazları bulabilirsiniz. Cihaz için test çalıştırmak üzere Test çalıştır'ı da tıklayabilirsiniz.

Home Graph Görüntüleyici

Bu işlem, test paketini tarayıcınızda başlatır ve cihazınız seçili ve teste hazır olarak açılır. Başlat'ı tıklayın ve test sonuçlarını bekleyin.

Google Home Test Suite

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

Test sonuçları

Matter Hata Ayıklama için Google Home Uzantısı'nı kullanma

Android Günlük Kaydı

MATTER LOGGING TOOLS (MATTER GÜNLÜK KAYIT 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 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ü ile ilgili günlüklerin gösterildiğini unutmayın. Günlükleri filtrelemek için Önem Derecesi'ni ayarlayabilir veya günlüklerde anahtar kelimeyi Arayabilirsiniz.

Android Günlük Kaydı Filtrelendi

Matter Cihaz Günlük Kaydı

MATTER LOGGING TOOLS (MATTER LOGGING TOOLS) bölümünde Device Logs'ı (Cihaz Günlükleri) tıklayarak Resources (Kaynaklar) sayfasını açın, önce SoC Type'ı (SoC Türü) seçin:

Matter cihaz günlük kaydı

Ardından Matter cihaz'ı seçin:

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

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

Matter cihaz filtrelenmiş günlük kaydı

Tüm konu 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üğü Kaydetme

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

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

Kayıtlı ZIP dosyasını ayıklayın. Bu dosya, cihaz bilgilerini ve günlük dosyalarını gösterir.

Matter Günlüğü Zip Dosyası

Cihaz bilgileri dosyası, sorunların hata ayıklanması 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 hakkındaki düşüncelerinizi veya geri bildirimlerinizi göndermek için aşağıdaki seçeneklerden birini belirleyin:

  • Önerilerinizi YARDIMLA GERİ BİLDİRİM panelinde Geri Bildirim Gönder'i tıklayarak bizimle paylaşabilirsiniz.
  • Google Home Extension ile ilgili karşılaştığınız sorunları bildirmek için YARDIMLA 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 ekledik.