VS Code için Google Home Uzantısı

Konu    Buluttan buluta    Yerel Ev SDK'sı    Cihaz SDK'sı

Google Home Extension for Visual Studio Code, Google Home Platform geliştiricileri için tasarlanmıştır. Bu uzantı sayesinde Google Assistant Simulator, Google Cloud Logging, Home Graph Görüntüleyici ve diğer önemli araçlara erişerek Matter ile akıllı ev geliştirme sürecini basitleştirebilirsiniz.

Google Home uzantısı özellikleri

Google Asistan Simülatörü

Akıllı ev cihazlarınızın Google Home ekosisteminde düzgün şekilde çalışıp çalışmadığını test etmek için VS Code'dan ayrılmadan Assistant Simulator ile istediğiniz zaman etkileşime geçebilirsiniz.

Actions Console'da sağlanan mevcut Simülatöre benzer şekilde Assistant Simulator, sorgularınızı yazarak cihazlarınızı kolayca kontrol etmenizi sağlar. Örneğin, "Işıkı aç." VS Code'da Assistant Simulator, komutlarınıza göre kısa mesajlarla yanıt verir. Örneğin: "Tamam, ışığı açıyorum. Daha fazla bilgi için Google Asistan Simülatörünü kullanma bölümüne bakın.

Toplu İfadeler

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

Matter Günlük Araçları

Matter Günlük Araçları, Matter hata ayıklamayla 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, 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 raporlama sorunları için Google'a gönderilebilir.

Cloud Logging

Cloud Logging, Action'ınızın kullanımıyla ilgili bilgi veren hata ayıklama bilgileri ve temel metrikler sunar. Google Home Extension, geliştirme sürecini basitleştirmek için 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 başlıklı makaleyi inceleyin.

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 cihazın durumunu VS Code'daki Home Graph'inizde doğrulayabilirsiniz. Daha fazla bilgi için Home Grafiği Görüntüleme ve Testleri Çalıştırma bölümüne göz atın.

VS Code için Google Home Uzantısını Yükleyin

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

1. Etkinlik Çubuğu'ndaki Uzantılar simgesini tıklayın.

2. google home için arama yapın, ardından Yükle'yi tıklayın.

   

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

İndirin Google Home Extension

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

Google Home Extension platformunu yükleyip VS Code'u yeniden yükledikten sonra Assistant Simulator uygulamasını kullanabilmeniz ve Cloud Logging'i görüntüleyebilmek için önce oturum açıp bir proje seçmeniz gerekir.

Google ile oturum açın ve bulut projesi seçin

Geliştirici hesabınızdan Google Home Extension üzerinden oturum açarak sizin adınıza Google hizmetleriyle iletişim kurması için VS Code'u yetkilendirebilirsiniz.

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

   

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

   

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 Code'u aç iletişim kutusu gösterilir. Devam etmek için Visual Studio Code'u aç seçeneğini tıklayın.

   

6. Google Home Uzantısı'nın bir URI'yı açmasına izin vermek için izninizin gerektiği VS Kodu'na yönlendirilirsiniz. Giriş işlemini tamamlamak için Aç'ı tıklayın.

   

7. Google Home Extension oturum açtıktan sonra projelerinizi yükler. Proje tamamlandığında Proje seçin'i tıklayın.

   

8. Görüntülenen Arama ve proje seçme açılır penceresinde akıllı ev projenizi seçin.

Android Debug Bridge'i (ADB) yükleme

Matter günlüklerini bir Android telefonunda 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'ni ve USB Hata Ayıklama'yı açın.

Matter Cihaz SoC Araçlarını Yükleyin

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

1. Cihazın çoğu 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 sayfasına göz atı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ünden Başlayın ve Kaynaklar'ı tıklayarak Google Home ekosistemine yönelik geliştirmenize dair faydalı bilgiler bulabileceğiniz Kaynaklar sayfasını açın.

Google Asistan Simülatörünü Kullanma

Assistant Simulator kodunu VS Code'da açmak için yan çubukta GOOGLE ASİSTAN SIMULATOR'u tıklayın. Mesaj kutusuna sorgunuzu girin ve Enter tuşuna basın.

Assistant Simulator yanıtı görüntüleyebilir ve sorgunuzdan sonra Yeniden gönder düğmesini tıklayabilirsiniz.

Toplu ifadeleri çalıştırma

GOOGLE ASASTANT SIMULATOR menü çubuğunun üzerine gelin ve komut dosyalarını ayarlamak için aşağıdaki seçeneklerden birini belirleyin:

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

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

  

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

• Açılır pencereden bir açıklama metni seçmek için play_arrow simgesini tıklayın.

• Doğrudan bir *.utterance dosyası açın ve play_arrow simgesini tıklayın.

  

Cloud Logging'i göster

HIZLI ERİŞİM bölümünde, Bulut Günlükleri sayfasını açmak için Cloud Günlükleri'ni tıklayın. Burada, seçtiğiniz projeye ait günlükleri bulabilirsiniz.

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örüntülemek isterse alta doğru ilerleyin ve daha fazla günlüğü görüntülemek için More'u (Diğer) tıklayın.

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

HIZLI ERİŞİMbölümünde, seçilen projeye ait cihazları bulabileceğiniz Ev Grafiği Görüntüleyici panelini açmak için Ev Grafiği Görüntüleyici'yi tıklayın. Cihaz için test çalıştırmak isterseniz Testi Çalıştır'ı da tıklayabilirsiniz.

Bunu yaptığınızda, cihazınız seçili ve test edilmeye hazır olacak şekilde test paketi tarayıcınızda başlatılır. Başlat'ı tıklayın ve test sonuçlarını bekleyin.

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

Matter hata ayıklama için Google Home uzantısını kullanma

Android Günlük Kaydı

ÖNEMLİ GÜNLÜK ARAMALARI'nın altında Android Günlükler'i tıklayarak AndroidGünlükler sayfasını açın, bağlanmak istediğiniz Android telefonunu seçin ve günlükleri göstermeye başlayın.

Android telefonu bağlandıktan sonra günlükleri satır bazında 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 için Önem derecesini belirleyebilir veya günlüklerde anahtar kelimeyi Ara seçeneğini belirleyebilirsiniz.

Matter Cihaz Günlük Kaydı

ÖNEMLİ GÜNLÜK ARAMALARI'nın altında, Kaynaklar sayfasını açmak için Cihaz Günlükleri'ni tıklayın, önce SoC Type'ı seçin:

Ardından Konu Cihazı'nı seçin:

Ardından, cihazdaki tüm cihaz günlüklerini alabilir ve Önem derecesi ile Arama gibi filtreleri kullanarak ilgilendiğiniz bilgileri bulabilirsiniz.

Tüm Matter 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'a basın.

Günlükleri indirmek için klasörü seçin ve Kaydet'i tıklayın:

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

Kaydedilen zip dosyasını ayıklayın. Dosya, cihaz bilgilerini ve günlük dosyalarını gösterecektir.

Cihaz bilgileri dosyası, hata 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ğimizle ilgili 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 önerilerinizi bizimle paylaşın.
• YARDIM VE GERİ BİLDİRİM panelinde, Google Home Extension ile ilgili bulduğunuz tüm sorunları bildirmek için Sorun Bildir'i tıklayın.

• Kaynaklar sayfasında da bir geri bildirim simgesi sağladık.