Matter Buluttan buluta Local Home SDK
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.
Google Home Uzantısı Ö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 İfadeler
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 ayrıntı için Toplu İfadeleri Çalıştırma bölümüne bakın.
Madde Kaydı Araçları
Matter Logging Tools, 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, 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 indirilebilir ve sorunların bildirilmesi için Google'a gönderilebilir.
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 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 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:
- Etkinlik çubuğundaki Uzantılar simgesini tıklayın.
google homeeklentisini arayın ve Yükle'yi tıklayın.
Google Home Extension dosyasını doğrudan VS Code Marketplace'ten de indirebilirsiniz.
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.
Etkinlik çubuğunda Google Home simgesini tıklayarak Google Home Extension açı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çma yetkilendirme sayfasında İzin ver'i tıklayın.
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'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 Aç'ı tıklayın.
Oturum açtıktan sonra Google Home Extension projelerinizi yükler. İşlemi tamamladıktan sonra Proje seç'e tıklayın.
Görüntülenen Proje ara ve seç açılır penceresinde akıllı ev projenizi seçin.
Android Hata Ayıklama Köprüsü (ADB) Aracını Yükleyin
Android telefonunda 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 Hata Ayıklama'yı açın.
Matter Device SoC Tools'u yükleyin
Matter cihazlarından hata ayıklama günlüklerini görüntülemek için:
- Çoğu cihaz SoC'si, Linux'ta
/dev/ttyUSBx, MacOS'te ise/dev/tty.SLAB_USBtoUARTveya/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ürleri harici araçların (örneğin, JLink) yüklenmesini gerektirebilir. 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üle
YARDIM VE GERİ BİLDİRİM bölümünde Başlarken ve Kaynaklar'ı tıklayarak Kaynaklar sayfasını açın. Burada Google Home ekosisteminizle ilgili geliştirmeleriniz için faydalı bilgiler bulabilirsiniz.
Google Asistan Simülatörünü kullanın
Assistant Simulator öğesini VS Code'da açmak için Kenar Çubuğu'ndaki GOOGLE ASISTANT SIMULATOR öğesine tıklayın. Mesaj kutusuna sorunuzu yazın ve Enter tuşuna basın.
Assistant Simulator yanıtlarını görüntüleyebilir ve sorgunuzun ardından gelen Yeniden Gönder düğmesine tıklayabilirsiniz.
Toplu İfadeleri Çalıştır
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 seçin:
Mevcut ifade metinlerini açmak için öğesine tıklayın.
Geçmişi
*.utterancekomut dosyasına kaydetmek için simgesini tıklayın.
Toplu ifadeleri göndermeye başlamak için aşağıdaki seçeneklerden birini seçin:
- Açılır pencereden bir ifade betiği seçmek için öğesine tıklayın.
Doğrudan bir
*.utterancedosyası açın ve öğesine tıklayın.
Cloud Logging'i görüntüleme
HIZLI ERİŞİM altında, seçili projenize ait günlükleri bulabileceğiniz Bulut Günlükleri sayfasını açmak için Bulut Günlükleri'ne tıklayın.
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, aşağı kaydırın ve daha fazla günlük görüntülemek için Daha Fazla'ya tıklayın.
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çili projeye ait cihazları bulabilirsiniz. Cihaz için test çalıştırmak üzere Testi Çalıştır'ı da tıklayabilirsiniz.
Bu işlem, tarayıcınızda test paketini 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.
Tüm testler tamamlandıktan sonra test ayrıntılarını inceleyebilir ve günlükleri görüntüleyebilirsiniz.
Matter hata ayıklama 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 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örüntülendiğini unutmayın. Ayrıca, günlükleri filtrelemek için Önem Derecesi'ni ayarlayabilir veya günlüklerde anahtar kelimeyi Arayabilirsiniz.
Matter Cihaz Günlük Kaydı
MATTER LOG KAYIT ARAÇLARI bölümünde Cihaz Günlükleri'ni tıklayarak Kaynaklar sayfasını açın, önce SoC Türü'nü seçin:
Ardından Madde Aygıtı'nı seçin:
Ardından, cihazdan tüm cihaz günlüklerini alabilir ve ilgilendiğiniz bilgileri bulmak için Önem Derecesi ve Arama gibi filtreleri kullanabilirsiniz.
Tüm Madde Günlüklerini İndirin
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ükleri indirmek için klasörü seçin ve Kaydet'e tıklayın:
Ardından günlükler hedef klasöre kaydedilir:
Kaydedilen zip dosyasını çıkartın, cihaz bilgisi ve günlük dosyaları görünecektir.
Cihaz bilgileri dosyası, sorunları 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ğimize dair düşüncelerinizi veya geri bildirimlerinizi göndermek için aşağıdaki seçeneklerden birini seçin:
- YARDIM VE GERİ BİLDİRİM panelinde, bize önerilerde bulunmak için Geri Bildirim Ver'e 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.
- Ayrıca Kaynaklar sayfasında bir geri bildirim simgesi de ekledik.