Android Studio için Google Home Eklentisi

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:

1. Dosya'yı, ardından Ayarlar...'ı tıklayın.
2. Görünüm ve Davranış bölümünde Sistem Ayarları'nı genişletin ve ardından Şifreler'i tıklayın.
3. 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, 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:

1. Android Studio'yi indirin veya güncelleyin. Android Studio'yu indirme
2. Dosya > Ayarlar'a (MacOS'te Android Studio > Tercihler'e) gidin.
3. Eklentiler bölümünde Marketplace'e gidin ve google home'yi arayın.
4. 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ç
• Bulut projesi seçin

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.

1. Android Studio penceresinin sol tarafındaki dikey sekme sütununda Google Home sekmesini tıklayın.

2. Oturum açmak için Google'ı tıklayarak tarayıcınızı başlatın.

   

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. 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'da 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 cached 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 cached Yeniden 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 save 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. tocTopla'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 ve 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ı tekrar oynatmak, yanıtlarınızı ve günlüklerinizi kontrol etmek için switch_left 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:

error 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 check 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 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 calendar_month kullanarak tarih seçip saati metin alanına girebilirsiniz.

• 5/1/22 tarihinden sonraki bir tarihi seçmek için Sonra'yı seçin ve tarih simgesini calendar_month tıklayın.
• 5/1/22 tarihinden önceki bir tarihi seçmek için Önce'yi seçin ve tarih simgesini calendar_month tıklayın.
• 5/1/22 ile 6/30/22 arasında bir tarih seçmek için Önce ve Sonra'yı seçin ve tarih simgesinden calendar_month 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 cached 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ı chevron_right tıklayın. İletinin tamamını görüntülemek için chevron_left 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ını, cihaz kimliğini ve cihaz türünü görüntülemek için cached Yenile'yi tıklayın. Ayrı projeler için birden fazla Google Home Graph paneli açık tutabilirsiniz.

Cihazlarınız yüklendikten sonra JSON yükünün tamamını genişletmek için herhangi bir kaydı chevron_right 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 clear 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 Regex değiştiricileriyle Filtre alanını kullanarak günlük girişlerini filtreleyebilirsiniz.

Ayrıca şunları yapabilirsiniz:

• Bul alanını ve Sonrakini Bul (arrow_downward simgesi) ile Öncekini Bul (arrow_upward 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.