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ı, 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.
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.
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:
- Etkinlik çubuğundaki Uzantılar simgesini tıklayın.
google home'yi arayın ve Yükle'yi tıklayın.
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.
Google Home Extension'i açmak için Etkinlik Çubuğu'ndaki 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ç yetkilendirme sayfasında İzin ver'i tıklayın.
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.
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 Aç'ı tıklayın.
Oturum açtıktan sonra Google Home Extension, projelerinizi yükler. İşlem tamamlandığında Proje seçin'i tıklayın.
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:
- ADB'yi bilgisayarınıza yükleyin.
- 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:
- Çoğu cihaz SoC'si, Linux'da
/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ü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 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.
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
*.utterancekomut dosyasına kaydetmek için simgesini tıklayın.
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
*.utterancedosyasını açıp simgesini tıklayın.
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.
Kullanıcılar günlükleri önem derecesine ve zaman aralığına göre filtreleyebilir.
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.
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.
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.
Tüm testler tamamlandıktan sonra test ayrıntılarını kontrol edebilir ve günlükleri görüntüleyebilirsiniz.
Matter Hata Ayıklama için Google Home Uzantısı'nı kullanma
Android Günlüğü
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 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.
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:
Ardından Matter cihaz'ı seçin:
Ardından cihazdan tüm cihaz günlüklerini alabilir ve ilgilendiğiniz bilgileri bulmak için Önem ve Arama gibi filtreleri kullanabilirsiniz.
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.
Günlüklerin indirileceği klasörü seçin ve Kaydet'i tıklayın:
Ardından günlükler hedef klasöre kaydedilir:
Kayıtlı ZIP dosyasını ayıklayın. Bu dosya, cihaz bilgilerini ve günlük dosyalarını gösterir.
Cihaz bilgileri dosyası, sorunların hata ayıklanması 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 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.
- Kaynaklar sayfasında da bir geri bildirim simgesi ekledik.