Android Studio için Google Asistan eklentisi

Google Asistan eklentisi, Android Studio'da Uygulama İşlemlerini test eder. Geliştirme ve test sırasında, web sitenizin önizlemesini oluşturmak için Google hesabınız için Asistan'daki Uygulama İşlemleri. Daha sonra kullanıcıların Uygulama İşlemi, dağıtım için göndermeden önce çeşitli parametreleri işler.

İşleyiş şekli

Google Asistan eklentisi, uygulamanızı geliştiren ve short.xml dosyanızı ayrıştırır ve tek bir Google Hesabı'nda oturum açabilir. Bu önizlemeler, Google Asistan'ın uygulamanızın üretim sürümünü Google Play Console'a dağıtmadan önce uygulama işlemlerinizi tanımasını sağlar.

Araç, short.xml dosyanızdaki her yerleşik intent (BII) için karşılık gelen bir JSON-LD nesnesidir ve varsayılan parametre değerleri sağlar. Şunları yapabilirsiniz: Uygulama İşlemlerinizi anlamlı parametreyle test etmek için bu değerleri değiştirin doğru uygulama işlevlerini gerçekleştirdiklerinden emin olun. Önizlemeler: test aracında oluşturulduğunda, güncellenir ve silinir. Böylece, işlemleri yineler Uygulama İşlemlerinizi güvenli bir ortamda test edin.

Önizleme oluşturulduktan sonra test cihazınızda bir Uygulama İşlemi tetikleyebilirsiniz buradan kontrol edebilirsiniz. Mevcut BBI'ler için Kullanıcının tetiklemesi için, app name cihazını doğrudan Asistan'da kullanabilirsiniz. cihazınızda Uygulama İşleminizi deneyebilirsiniz. Örneğin, "Ok Google, "Örnek Uygulama kullanarak egzersizimi başlat"ı tıklayın. actions.intent.START_EXERCISE BKİ.

Yerel ayar desteği

Test aracında belirli yerel ayarlar için önizleme oluşturma işlemi BII'ye göre farklılık gösterir. Yerleşik amaç referansındaki her BII'nin sayfası, ilgili BII için hangi işlevlerin kullanılabildiğine dair Test aracının belirli bir yerel ayar için önizleme oluşturmayı destekleyip desteklemediği ve Uygulama İşlemleri'nin kullanıcıların tetiklemesi için kullanılabilir olup olmadığı.

Eklentiyi indirin

Google Asistan eklentisi, Android Studio'da kullanılabilir. Örneğin, yükleme ve kullanma hakkında bilgi için bkz. Android Studio sayfası.

Google Asistan eklentisini Android Studio'ya yüklemek için aşağıdaki adımları uygulayın:

  1. Dosya > Ayarlar'a (macOS'te Android Studio > Tercihler'e) gidin.
  2. Eklentiler bölümünde Pazar Yeri'ne gidin ve "Google Asistan eklentisi."
  3. Aracı yükleyin ve Android Studio'yu yeniden başlatın.

Eklentiyi doğrudan Jetbrains herkese açık deposundan da indirebilirsiniz.

Kurulum gereksinimleri

Google Asistan eklentisini kullanmak için bir dizi yapılandırma adımı gerekir. Uygulama İşleminizin başarıyla test edilmesini sağlayın. Özellikle, Google Play için, Android Studio'da test cihazınızda ve Google Play'de aynı kullanıcı hesabını konsol erişimi.

Geliştirme ortamınızı aşağıdaki yapılandırmalarla hazırlayın:

  • Android Studio'da (4.0 veya sonraki sürümler) oturum açın.
  • Aynı hesapla Android test cihazınızdaki Google uygulamasında oturum açın.
  • Aynı hesabı kullanarak Play Console erişimi edinin yüklemekten ibaret değildir.
  • Android test cihazınızda Google uygulamasını açın ve ilk Asistan kurulum işlemi.
  • Test cihazınızda cihaz verilerinin senkronizasyonunu etkinleştirin.

Sınırlamalar

Google Asistan eklentisinin aşağıdaki sınırlamaları vardır:

  • Web envanterini içeren Uygulama İşlemleri ve ön plan uygulama çağrısı Doğrudan test aracında veya Android hata ayıklama köprüsüyle (adb) test edilemez komutlarının ikisine katlanır. Bu Uygulama İşlemleri'ni test etmek için önce aracını kullanın. Ardından, Google Asistan'la etkileşimde bulunarak bu Uygulama İşlemlerini tetikleyin elde edersiniz.
  • actions.intent.OPEN_APP_FEATURE için satır içi envanter BII, yalnızca bir önizleme tamamlandıktan sonra altı saatlik bir süre boyunca oluşturabilir veya güncelleyebilir. Test aracı önizlemesini güncelleyin veya yeni bir önizleme oluşturun: altı saatlik dönemi sıfırlayın.

Başka test kullanıcıları ekleyin

Uygulamanızı test edebilmeleri için projenize başka kullanıcılar davet edebilirsiniz. Uygulama İşlemleri entegrasyonu. Bu, projeyi paylaşmak istediğiniz test yapabilmeleri için geliştirme ekibinizin diğer üyeleriyle kalite güvencesi (KG) test kullanıcılarıyla paylaşarak üretim lansmanı. Test kullanıcıları, Google Hesaplarına lisans test kullanıcıları olarak eklenmelidir. Play Store'a gidip Google Play Console'a salt okuma erişimi verildi.

Başka test kullanıcıları eklemek için aşağıdaki adımları uygulayın:

  1. Play Console'da oturum açın.

  2. Bu kılavuzdaki Uygulama lisanslamayı ayarlama bölümünde Play Console Yardım konusu.

    Google Play Console üzerinden bir lisans test kullanıcısı ekleyin.
    Şekil 1. Lisans test kullanıcısı ekleme.

  3. Lisans test kullanıcısının Google hesabını Google Play Console salt okuma erişimi olarak davet etme belirtir.

    1. Kullanıcı ve izinler > Yeni kullanıcılar davet edin > Uygulama ekle'yi tıklayın.
    2. Uygulama Erişimi bölümünde, Yönetici (tüm izinler) onay kutusunun seçili olduğundan emin olun. temizlendi.

Önizleme testini etkinleştirmek istediğiniz her test kullanıcısı için giriş yapmanız gerekir kullanıcının Google Hesabı ile Android Studio'ya bağlanabilir. Giriş yaptığınızda, Google Asistan eklentisini kullanarak test kullanıcısı için önizleme oluşturun.

Google Asistan eklentisini kullanma

Android Studio'da Araçlar > Google Asistan > Uygulama İşlemleri test aracı ile ilgili daha fazla bilgi edinin. Aracı açtığınızda görünüm, etkin bir test aracı önizlemeniz olup olmadığını gösterir.

Önizlemeleri oluşturma, güncelleme ve silme

Test için uygulamanın taslak sürümünü kullanabilirsiniz. Daha fazla bilgi için Sürümü hazırlayıp kullanıma sunma başlıklı makaleyi inceleyin. Önce uygulamanızı taslak modunda test edin incelemeye gönderilir.

Test aracı, Google Hesabınıza ve uygulama paketi adınıza (uygulama kimliği) göre önizlemeler oluşturur. Böylece aynı Google Hesabı ile birden fazla uygulamayı test edebilirsiniz. Uygulama kimliğiniz her uygulamanın farklı olduğu sürece önizleme oluşturma ve test için aynı Google hesabını kullanmaya devam edebilir. Aynı uygulama paketine erişimi olan birden çok Google hesabının her biri test aracını kullanarak ilgili uygulama için ayrı önizlemeler oluşturabilirsiniz.

Önizleme oluşturmak için Android Studio'da aşağıdakileri yapın:

  1. Uygulama İşlemleri test aracını açın.
  2. İsteğe bağlı olarak test için bir uygulama adı ve yerel ayar girin. Varsayılan uygulama adı ve yerel ayar: test app action ve en.
  3. Önizleme Oluştur'u tıklayın. İstenirse Uygulama İşlemleri'ni inceleyip kabul edin hizmet şartlarını kabul edersiniz. Önizlemeniz oluşturulduktan sonra test aracı pencere güncellemeleri alarak kısayol.xml dosyası olarak kaydedin.

Test aracı, Asistan'ı oluşturmak ve simüle etmek için uygulama adını kullanır uygulama işlemleriniz için sorgu oluşturur. Dağıtılan Uygulama İşlemleri, Play Store uygulamanızın adını kullanır ancak test aracında istediğiniz çağrı adını kullanabilirsiniz. Ancak test aracıdır.

Sağladığınız yerel ayar, kullandığınız Google Asistan'ın diliyle aynı olmalıdır. test cihazına ekleyebilirsiniz ve aynı anda yalnızca bir yerel ayarda önizleme oluşturabilirsiniz. Örneğin, Örneğin, Asistan diliniz İngilizce (ABD) ise en-US girebilirsiniz, ancak en-**, en-GB veya en-US, en-GB değil. Hem en-GB hem de en-US'yi dahil etmek için en gibi bir kök yerel ayar kullanabilirsiniz.

Mevcut bir önizlemenin uygulama adını veya seçilen yerel ayarını değiştirmek için test aracındaki Sil düğmesi. Ardından, yeni bir önizleme oluşturmadan önce istediğiniz uygulama adını ve yerel ayarı girin.

Mevcut bir önizlemeyi short.xml dosyanızla eşleşecek şekilde güncellemek için Güncelle düğmesi gösterilir. Mevcut durumunuzla ilgili bilgiler önizleme, test aracı penceresinin Uygulama İşlemini Test Et bölümündedir.

BII yapılandırması

Uygulamanız için bir önizleme oluşturduktan sonra, çeşitli parametreleri değerlerini kullanabilirsiniz. Her BII için kısayol.xml dosyası içeriyorsa eklenti, JSON-LD nesnesini ifade eder ve varsayılan parametre değerleri sağlar. Bu ayarları değiştirebilirsiniz Uygulama İşlemlerinizi anlamlı parametre kombinasyonlarıyla test etmek için varsayılan değerler ve doğru uygulama işlevlerini gerçekleştirdiklerinden emin olun.

Parametreler ve değerleri genellikle mülkler ve açıklamalar için schema.org veya schema.googleapis.com yapısını izler. Daha fazla şemaya erişerek herhangi bir BII parametresiyle ilgili bilgileri bir parametrenin tür açıklamalarını ve üst düzey parametrelerini içerir.

Örneğin, actions.intent.GET_FOOD_OBSERVATION BII foodObservation.forMeal intent parametresini destekler. İlgili içeriği oluşturmak için kullanılan MealType için schema.googleapis.com sayfasında name olarak listeleniyor forMeal özelliği bir aktarım modudur ve değerleri (MealTypeLunch gibi) için numaralandırılmış MealType türünün değeri.

test aracında, numaralandırmalardan herhangi birini foodObservation.forMeal:

  • https://schema.googleapis.com/MealTypeSnack
  • https://schema.googleapis.com/MealTypeBrunch
  • https://schema.googleapis.com/MealTypeLunch
  • https://schema.googleapis.com/MealTypeBreakfast
  • https://schema.googleapis.com/MealTypeDinner
  • https://schema.googleapis.com/MealTypeDesert

Uygulama İşlemlerini Tetikle

Önizleme oluşturup bir BII yapılandırdıktan sonra, Doğrudan test aracı penceresinden test cihazınızdaki Uygulama İşlemi.

Test aracıyla bir Uygulama İşlemini tetiklemek için aşağıdakileri yapın:

  1. Test cihazınızı bağlayın.
  2. Hedef Cihaz Seçin bölümünde, istediğiniz cihazı seçin uygulama işleminizi tetikleyin.
  3. Uygulama İşlemini Test Et bölümünde Uygulama İşlemini Çalıştır düğmesini tıklayın.

Test aracında tetiklenen Uygulama İşlemleri, görüntülenen Android Debug Bridge (adb) komutunu girin. Oluşturulan adb kabuk komutu Google uygulamasının bir BII yürütmesi için gereken tüm meta verileri içerir. Bu yaklaşım, Uygulama İşleminizin Asistan'dan sonraki davranışını taklit eder sorgudaki önemli bilgileri ayıklar.

Android Studio günlük kaydı

Test aracına özgü günlükler, Logcat çıkışı olarak değil, Android Studio günlük dosyalarında bulunur. Doğrudan iş istasyonunuzda çalışan işlemler Android Studio oluşturur. günlükler. Bunları, oluşturma, önizlemeyi güncelleme veya silme.

Android Studio günlük dosyalarınıza erişmek için Yardım > Giriş gezginini gösterme (macOS'te Yardım > Giriş bulucuyu göster).

Uygulamanız için Uygulama İşlemleri ile ilgili günlüklere Logcat'ten ulaşabilirsiniz. Logcat, Android Studio'ya bağlı sanal veya fiziksel cihazlardaki günlükleri yakalar.

Cihazınıza ilişkin Uygulama İşlemleri günlüklerini almak için aşağıdaki adımları uygulayın:

  1. Android Studio'da Logcat'i tıklayarak Logcat günlük mesajlarınıza erişin. araç pencere çubuğuna getirin.
  2. ActivityTaskManager içeren günlükleri arayın.

Destek ve ek kaynaklara ulaşın

Google Asistan eklentisi; belgelerin, codelab'lerin, ve test aracını kullanmayla ilgili bilgi edinmek ve yardım almak için diğer kaynakları inceleyin.

Asistan'ı Android Studio'da şunu seçerek açabilirsiniz: Araçlar > Google Asistan > Yardım.

Uygulama İşlemleri test aracı asistanı Şekil 2. Google Asistan eklentisinin yardım bölümü.