Google Home Plugin for Android Studio, Google Home Platform geliştiricileri için tasarlanmış ve oluşturulmuştur. Bu eklenti, akıllı ev geliştirme sürecinizi basitleştirmek için Google Assistant Simulator, Cloud Logging ve diğer araçlara erişim sağlar.
Güvenlik bildirimi
Android Studio'ün gizli anahtarları ve şifreleri saklamasını önlemek için aşağıdaki adımları uygulayın:
- Dosya'yı, ardından Ayarlar...'ı tıklayın.
- Görünüm ve Davranış bölümünde Sistem Ayarları'nı genişletin ve ardından Şifreler'i tıklayın.
- Kaydetme, yeniden başlatma sonrasında şifreleri unut'u seçin.
Özellikler
Asistan Simülasyon Aracı
Akıllı ev cihazlarınızın Google Home ekosistemiyle düzgün çalışıp çalışmadığını test etmek için Android Studio'ten ayrılmadan dilediğiniz zaman Assistant Simulator ile etkileşim kurabilirsiniz.
Assistant Simulator, "Işığı aç" gibi sorgularınızı yazarak cihazlarınızı kolayca kontrol etmenizi sağlar. Android Studio içinde, Assistant Simulator komutlarınıza göre kısa mesajlarla yanıt verir. Örneğin, "Tamam, ışığı açıyorum."
Cloud Logging'i görüntüleme
Google Cloud Logging, işleminizle ilgili analizler sunmak için hata ayıklama bilgileri ve önemli metrikler sağlar. Geliştirmeyi basitleştirmek için Google Home Plugin, sorun giderme sırasında kodunuzun hemen yanında anlık Cloud Logging mesajları gösterir.
Gerçek zamanlı günlükleri görüntüleyebilir veya bir tarih aralığı seçebilirsiniz.
Toplu İfadeler
Tek bir ifadeye verilen Assistant Simulator yanıtları belirlenemez. Örneğin, bir yanıt aşağıdaki ifadelerden herhangi biri olabilir:
- Anladım, 2 ışığı açıyorum.
- Elbette, 2 ışığı açıyorum.
- Anladım, 2 ışığı açıyorum.
- Tamam, 2 ışığı açıyorum.
Otomatik testler çalıştırmak ve Google entegrasyonlarınızın bu çeşitli yanıtlarla nasıl çalıştığını doğrulamak için ifade komut dosyaları çalıştırarak Assistant Simulator'e toplu ifadeler gönderebilirsiniz. Bir komut dosyası kaydedildikten sonra yanıt toplayabilir ve sorgularınıza karşı birden fazla test çalıştırabilirsiniz.
Home Graph Görüntüleyici
Home Graph Viewer, cihazlarınızın durumunu görüntülemenize ve tarayıcınızda Google Home Test Suite'u başlatmanıza olanak tanır.
Android Debug Bridge (adb) Günlük Görüntüleyici
Adb Log Viewer, Matter cihaz günlük dosyaları, Google Home günlükleri ve Android günlükleri gibi günlük dosyalarını görüntülemek ve analiz etmek için kullanılan bir araçtır.
Yükle
Google Home Plugin'ü Android Studio'a yüklemek için aşağıdaki adımları uygulayın:
- Android Studio'yi indirin veya güncelleyin. Android Studio'yu indirin
- Dosya > Ayarlar'a (MacOS'te Android Studio > Tercihler'e) gidin.
- Eklentiler bölümünde Marketplace'e gidin ve
google home'yi arayın. - Aracı yükleyip Android Studio cihazını yeniden başlatın.
Eklentiyi doğrudan JetBrains Marketplace'ten de indirebilirsiniz.
Kurulum
Eklentiyi yükledikten sonra Assistant Simulator'ü kullanabilmek ve Cloud Logging'u görüntüleyebilmek için aşağıdaki adımları tamamlamanız gerekir:
Google ile oturum aç
Google Home panelinden geliştirici hesabınızda oturum açarak Android Studio'ün sizin adınıza Google hizmetleriyle iletişim kurması için yetki verebilirsiniz.
Android Studio penceresinin sol tarafındaki dikey sekme sütununda Google Home sekmesini tıklayın.
Oturum açarken Google'ı tıklayarak tarayıcınızı başlatı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.
Tarayıcı penceresini kapatın ve Android Studio'e dönün.
Artık giriş yapmış durumdasınız ve Çıkış yapma seçeneğiniz var.
Bulut projesi seçme
Oturum açtıktan sonra açılır listeden bir Proje seçin. Proje listenizi filtrelemek için bir Filtre ifadesi yazın (ör. matter) ve Enter tuşuna basın.
Proje açılır menüsünde, Filtre'nize göre ilk 100 proje yüklenir. Android Studio'ten çıktığınızda seçimleriniz korunur.
Proje filtreleriyle ilgili yardım için Google Cloud Referansı'ndaki Sorgu parametreleri bölümüne bakın.
Asistan Simülasyon Aracı'nı kullanma
Android Studio'te Assistant Simulator'ü açmak için Google Home Plugin panelinden Söylemler Paneli'ni tıklayın.
Assistant Simulator'ye sorgu göndermenin birkaç yolu vardır. Ardından, her bir seçeneği inceleyeceğiz.
Sorgu yazma ve yanıt toplama
Assistant Simulator ile etkileşimde bulunmak için sorgunuzu yazıp Enter tuşuna basın.
Sorgunuzun sonundaki yeniden gönder simgesini tıklayarak sorguyu yeniden gönderebilirsiniz.
Bir veya daha fazla sorgu gönderdikten sonra sorgularınızı yeniden çalıştırmak ve yanıtlarınızı kontrol etmek için Tekrar oynat'ı tıklayın. Söylemler paneli, sorgularınızı ve yanıtlarınızı depolanan bir önbellekte izler. Yeniden oynat yalnızca bu dahili önbelleğe yeni yanıtlar ekler ve düğmeyi her tıkladığınızda sorgularınızı kopyalamaz.
Söylemler paneline girdiğiniz sorguları ve yanıtları kaydetmek için Kaydet'i tıklayın. Etkileşimlerinize aşağıdaki biçimde JSON biçiminde dönüştürülür:
ask: Sorgunuz.answers: Olası Assistant Simulator yanıtları dizisi.
Bu JSON dosyasını Android Studio'te düzenleyebilirsiniz.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Toplu yanıt toplama
Kayıtlı JSON dosyalarınızı yeni bir sekmede açmak için Google Home Plugin panelinde Söylem Dosyası'nı tıklayın. Yol seç bölümünde bir dosya veya klasör seçebilirsiniz. Bir klasör seçerseniz Topla ve Test, söz .json dosyaları için o klasördeki tüm dosyaları kullanır.
Aynı dosya veya farklı dosyalar için birden fazla sekme açabilirsiniz (ör. lights, lights(1) ve plug).
Durum çubuğu, son testinizin sonucunu (varsa), dosyanın toplanıp toplanmadığını belirten sarı veya yeşil bir noktayı ve ifade .json dosya yolunu gösterir. Topla'yı tıkladıktan sonra Assistant Simulator, sorgularınızı çalıştırır.
Yeni bir yanıt toplandığında bildirim alırsınız. Sorgularınız işlenirken Durum Çubuğu'nda bir sayaç gösterilir.
Topla işlemi tamamlandığında Durum Çubuğu, .json yolunuzun önüne yeşil bir onay işareti ekleyerek güncellenir ve ifade dosyalarınız olası yanıtlarla doldurulur.
{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
Koleksiyonu erken durdurursanız .json rotanız toplandı olarak işaretlenmez.
Toplu ifade testleri
Yanıtlarınızı topladıktan sonra sorgularınızı yeniden oynatmak, yanıtlarınızı ve günlüklerinizi kontrol etmek için Test'i tıklayın. Toplu ifadeleri test ettiğinizde Assistant Simulator, JSON dosyanıza kaydedilen yanıtları bekler. Testiniz, toplanmamış bir yanıt döndürürse aşağıdaki yanıta benzer bir bildirim alırsınız:
Expected one of: "Got it, turning on
2 lights."
Bu senaryo, başarısız bir testi gösterir. Aksi takdirde, Assistant Simulator her sorgunuzu çalıştırır ve bir yanıt döndürür. Test başarılı olursa Durum Çubuğu'nda işareti gösterilir.
Cloud Logging'i görüntüleme
Cloud Logs araç penceresinde bir proje sekmesi açmak için Google Home Plugin panelinden Cloud Logs'u tıklayın. Projelerinizin her biri için ayrı Cloud Günlüğü sekmeleri açabilirsiniz.
Sorgu terimleri
Seçtiğiniz proje için Sorgu alanını kullanarak günlükleri de filtreleyebilirsiniz.
Örneğin, günlükleri light anahtar kelimesine göre filtrelemek için:
Günlük kaydı sorgu dilini kullanmak için QL'yi kullan'ı seçin.
Başlamanıza yardımcı olacak birkaç QL sorgusu örneğini aşağıda bulabilirsiniz:
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
Tarih ve saat sorguları
Günlükleri tarihe göre sorgulamak da isteğe bağlıdır ve Sonra ve Önce'yi tıklayarak etkinleştirilebilir. Tarih ve saat biçiminizi sağlanan metin alanına yazabilirsiniz (ör. 5/11/22, 12:37 PM) veya tarih seçicileri kullanarak tarih seçip ardından saati metin alanına girebilirsiniz.
5/1/22tarihinden sonraki bir tarihi seçmek için Sonra'yı seçin ve tarih simgesini tıklayın.5/1/22tarihinden önceki bir tarihi seçmek için Önce'yi seçin ve tarih simgesini tıklayın.5/1/22ile6/30/22arasında bir tarih seçmek için Önce ve Sonra'yı seçin ve tarih simgesinden tarihlerinizi seçin.
Canlı proje günlüklerini almak için Gerçek zamanlı'yı seçin. Gerçek zamanlı feed'i sonlandırmak için Durdur'u tıklayın.
Önem düzeyi
Açılır menüden En Düşük Önem'i de seçebilirsiniz.
Sorgu sonuçları
Sorgu parametrelerinizi göndermek için Getir'i tıklayın.
Günlükler yüklendikten sonra JSON yükünün tamamını genişletmek için herhangi bir kaydı tıklayın. İletinin tamamını görüntülemek için simgesini tekrar tıklayın.
İsteğe bağlı olarak, günlük sonuçlarınızı daraltmak için Filtre kutusuna bir anahtar kelime yazabilirsiniz. Filtrenizi kaldırmak ve orijinal getirme sonuçlarına dönmek için x simgesini tıklayın.
Home Graph'i görüntüleme ve test çalıştırma
Cihazlarınızı listelemek için Google Home Plugin panelinden Home Graph'ı seçin.
Seçilen projeyle ilişkili cihazlarınızın Cihaz adı, Cihaz kimliği ve Cihaz türü bilgilerini görüntülemek için Yenile'yi tıklayın. Ayrı projeler için birden fazla Google Home Graph paneli açabilirsiniz.
Cihazlarınız yüklendikten sonra JSON yükünün tamamını genişletmek için herhangi bir kaydı tıklayın.
Cihazlarınıza ait JSON yüklerini görüntülemek ve gizlemek için Genişlet ve Daralt seçeneklerini de kullanabilirsiniz.
Belirli bir cihaz için Test Suite'u başlatmak üzere Test et'i tıklayın. Bu işlem, tarayıcınızda Test Paketi'ni cihazınız seçili ve test etmeye hazır olarak başlatır. Başlat'ı tıklayın ve test sonuçlarını bekleyin.
Testler tamamlandıktan sonra test ayrıntılarını kontrol edebilir ve günlükleri görüntüleyebilirsiniz.
Android Debug Bridge (adb) Günlük Görüntüleyici
Adb Log araç penceresinde bir proje sekmesi açmak için Google Home eklenti araç çubuğunda (solda) Adb Log komutunu tıklayın. Günlük dosyalarınızın her biri için ayrı Adb Günlüğü sekmeleri açabilirsiniz. Bir sekmeyi silmek için simgesini tıklayın.
Görüntülemek istediğiniz belirli bir günlük kaydı bileşenini seçmek için Seç alanını, yalnızca eşleşen günlük önem derecesine sahip girişleri görüntülemek için de Önem açılır menüsünü kullanın.
Seçtiğiniz adb günlüğünde, isteğe bağlı Büyük/küçük harf duyarlı veya Normal ifade değiştiricileriyle Filtre alanını kullanarak günlük girişlerini filtreleyebilirsiniz.
Ayrıca şunları yapabilirsiniz:
- Bul alanını ve Sonrakini Bul ( simgesi) ile Öncekini Bul ( simgesi) komutlarını kullanarak belirli girişleri bulun.
- İsteğe bağlı Büyük/küçük harfe duyarlı veya Normal ifade değiştiricileri kullanın.
- Günlükte belirtilen bir satıra (numaraya göre) atlamak için Satıra atla'yı tıklayın.
Satır numaraları eklenmiş günlük satırlarını görüntülemek için Numaralı'yı seçin. Ham günlük girişlerini görüntülemek için Ham'ı seçin.
Kaynaklar ve geri bildirim
Geliştirici araçları ve kaynaklarının listesi için Kaynaklar'ı tıklayın.
Google Home Plugin ile geliştirme deneyimini nasıl iyileştirebileceğimiz hakkındaki düşüncelerinizi veya geri bildirimlerinizi göndermek için Geri bildirim'i tıklayın.
