Sorun giderme

Uygulama İşlemleri'ni geliştirirken kurulumunuzla veya Uygulama İşlemleri test aracıyla ilgili sorunlarla karşılaşabilirsiniz. Bu sayfada, sık karşılaşılan bazı sorunlar ve bunların düzeltmeleri açıklanmaktadır.

Genel

Hata: Durum mesajı bildiriminde "URL'yi açacak uygulama bulunamadı" mesajı gösteriliyor

Doğru yapılandırıldığından emin olmak için actions.xml hesabınızda sipariş karşılama urlTemplate ayarınızı kontrol edin. Uygulama Bağlantıları URL'lerini kullanıyorsanız ACTION_VIEW ve URL'yi kullanarak URL'nizi manuel olarak tetikleyebildiğinizden emin olun. Amaca dayalı URL'ler kullanıyorsanız Etkinliğinizin sağlanan parametreleri kullanmaya başlayacak şekilde doğru yapılandırıldığından emin olun.

Hata: "Uygulama yüklü değil"

Bu hata, AndroidManifest.xml dosyanızdaki <intent-filter> değerinin, actions.xml içinde belirttiğiniz derin bağlantıyı filtrelemediği anlamına gelebilir. Hata bildiriminde bulunmadan önce bunu kontrol ettiğinizden emin olun.

Hata: Android Studio'da "Varlık grubu kimliği veya URL filtresi içermeyen bir varlık grubu referansı bulundu." mesajı gösteriliyor

Bu koşula <entity-set-reference> etiketi için bilinen bir linter sorunu neden olur. Bu mesajı dikkate almayabilirsiniz. Geçici bir çözüm olarak, tools:ignore="ValidActionsXml" özelliğini ekleyerek bu etiket için lint kontrolünü devre dışı bırakabilirsiniz.

Devre dışı bırakılmış lint kontrolünün bulunduğu bir varlık grubu referansı örneğini burada bulabilirsiniz: 

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

Hata: APK yüklenirken işlemler şema dokümanı için "geçersiz konum"

Sürüm APK'nızın kaynaklarını etkileyen bir kod karartma veya optimizasyon aracı kullanırsanız APK yüklemeniz başarısız olabilir. ProGuard gibi kaynak dosyalardan kaçınan araçlar bu soruna neden olmaz.

Bu sorunu çözmek için uygulamanızın actions.xml dosyası için aracı devre dışı bırakmayı deneyin (örneğin, bir izin verilenler listesi kullanarak).

Hata: "Etkin bir APK veya Android App Bundle bir actions.xml dosyası içeriyor. Devam etmek için Actions on Google Hizmet Şartları'nı kabul edin." mesajı gösterilir.

Play Console'da uygulama sürümü oluştururken bu hatayı görebilirsiniz. Actions on Google Hizmet Şartları'nı kabul etmek için şu adımları uygulayın:

  1. Play Console'da uygulamanızı seçin.
  2. Kurulum > Gelişmiş Ayarlar'a gidin.
  3. Actions on Google sekmesini tıklayın.
  4. Actions on Google'ı kullanarak hizmetlerimi Uygulama İşlemleri ile entegre et etiketli kutuyu işaretleyin ve talimatları uygulayın.

Play Hizmet Şartları formundaki "Kabul et" düğmesi devre dışı.

Bu durum, oturum açan kullanıcının bu şartları kabul etmek için gereken erişim düzeyine sahip olmadığı anlamına gelebilir. İlk gönderimin Play Console profilinin yöneticisi tarafından yapıldığından emin olun.

Uygulama İşlemleri test aracı

Aşağıdaki düzeltmelerden herhangi birini denemeden önce Uygulama İşlemleri test aracı yüklemenizi en son sürüme güncelleyin.

Uygulama İşlemleri test aracı eklentisi actions.xml dosyamı bulamıyor.

AndroidManifest.xml dosyanıza doğru <meta-data> etiketini eklediğinizden emin olun.

Uygulama İşlemi önizlemem mevcut actions.xml dosyamla eşleşmiyor.

Önizlemeniz kendini actions.xml dosyanızın içeriğiyle dinamik olarak güncellemez. actions.xml dosyanızı manuel olarak veya Android Studio'da derleme varyantlarını değiştirdikten sonra, actions.xml dosyanızı kaydedin ve test aracında Önizlemeyi Güncelle'yi tıklayın.

Uygulama İşlemleri test aracı eklentisi çalışmayı durdurdu veya hata oluşturuyor.

Öncelikle, Android Studio'yu en son sürüme güncellediğinizden emin olun. 403 hatası alıyorsanız eklentiyi kullanma izninizin olmadığı bir pakette de çalıştırıyor olabilirsiniz.

Hata devam ederse lütfen bir hata bildiriminde bulunun ve aşağıdaki ayrıntıları Google'a gönderin:

  • Hata iletişim kutusunun ayrıntıları
  • Android Studio Günlükleri. Yardım > Günlüğü Finder'da Göster'e gidin. Bu işlem, idea.log öğesinin Finder'daki konumunu gösterir. Günlük dosyasında "Submit Actions İstek Gövdesi:" ifadesini arayın ve sunucu yanıtlarını yapıştırın (işlemler için iki sonuç olmalıdır).

Uygulama İşlemleri test aracı, UnknownHostException veya başka ağ hataları oluşturuyor

Uygulama İşlemleri test aracı, Uygulama İşlemlerinizin bir önizlemesini oluşturarak Google Asistan entegrasyonlarını tek bir Google Hesabı'yla test etmenize olanak tanır. Bu önizlemeleri oluşturmak için test aracının etkin bir internet bağlantısı ve gerekirse Google alanlarına proxy erişimi olması gerekir.

Test aracını çalıştırırken ağ sorunlarını çözmek için aşağıdaki sık karşılaşılan sorunları kontrol edin:

  • Önizlemeleri oluşturmadan önce etkin bir internet bağlantınızın olduğundan emin olun.

  • İnternet bağlantınız varsa ve yerel ağınız bir proxy sunucusu kullanıyorsa aşağıdakileri kontrol edin:

    • IDE proxy yapılandırmanızı doğrulayın. Daha fazla bilgi için Android Studio veya IntelliJ için proxy yapılandırma talimatlarına bakın.
    • Proxy'niz için bir erişim kontrol listesi (EKL) gerekiyorsa EKL'yi şu URL kalıbına izin verecek şekilde güncelleyin: https://actions.googleapis.com/**.

Test eklentisiyle Uygulama İşlemi'ni çağırırken Asistan, "Maalesef onu bulamadım" diyor.

Kurulumunuza bağlı olarak bu yanıt farklı nedenlerle görünebilir. Aşağıdaki adımları deneyin:

  1. Android Studio, Play Console ve test cihazınızda aynı Google hesabıyla oturum açın.
  2. Cihaz verileri senkronizasyonunu etkinleştirin.
  3. Cihazı ve Google Asistan dilini en-US olarak ayarlayın.
  4. Uygulamanın Google Play Console'daki paket adının test uygulamasındaki paket adıyla eşleştiğinden emin olun.
  5. actions.xml dosyanızdaki istek karşılama urlTemplatetanımında, android:host ve android:scheme değerlerinin AndroidManifest dosyasında belirtilenlerle eşleştiğinden emin olun.
  6. Uygulamanızın önceki tüm yüklemelerini test cihazınızdan kaldırın ve yeni bir derleme yükleyin.
  7. Önizlemeyi, Uygulama İşlemleri test aracından silin ve tekrar yeni bir önizleme oluşturun.
  8. Google Asistan'ın istek karşılamayla ilgili hataları için Logcat aracında kontrol edin. Uygulamanız için başlatılmış bir intent göreceksiniz.
  9. Hesabın "Cihazlarınız için uygulama bilgileri" ayarını etkinleştirin.
  10. Google Asistan'ı açın ve kurulumu tamamladığınızdan emin olun. (Kurulum ilerleme çubuğu, genelde ekranın alt kısmında mavi bir çubuk şeklinde görünür ancak bazı durumlarda farklı görünebilir.)
  11. Bir Uygulama İşlemini tetiklemek için Google Asistan'ı kullanırken çağrı adının Uygulama İşlemleri test aracı tarafından oluşturulan önizlemeyle eşleştiğinden emin olun.
  12. Transkript hatalarından kaçınmak için ses yerine metin girişini kullanmayı deneyin.
  13. Test derlemenizi, applicationId Google Play Console'a yüklenen bir APK veya AAB ile tam olarak eşleşecek şekilde yapılandırın. İsteğe bağlı applicationIdSuffix özelliklerinin, belirli ürün aromaları ve yapı varyantları için son applicationId derlemeleri değiştirebileceğini unutmayın. Bu örnekte, sahte ürün aroması için applicationId değeri com.example.android.architecture.blueprints yerine com.example.android.architecture.blueprints.master.mock şeklindedir.
  14. Önizlemenizi benzersiz bir çağrı adı kullanacak şekilde yapılandırın. Diğer uygulamalarla çakışma olasılığını azaltacak benzersiz bir kelime kullanmayı deneyin.
  15. Paylaşılabilir bir kod tabanıyla ilgili sorunları giderirken sorunları tespit etmek için örnek Uygulama İşlemleri Fitness Uygulaması'nı çalıştırmayı deneyin. Fitness uygulamasının uçtan uca çalıştığından emin olun. Ardından, sorunları tekrarlayıp tekrarlayamayacağınızı görmek için bu uygulamanın üstüne kademeli olarak başka özellikler ekleyin.
  16. G Suite hesapları kullanıyorsanız Google Asistan'ın yönetici tarafından etkinleştirildiğinden emin olun. Geçici çözüm olarak G Suite dışında bir test hesabı oluşturmanızı ve bu hesabı Play Store üzerinden lisanslı test kullanıcısı olarak ayarlamanızı öneririz. Test kullanıcıları bu hesaptan uygulamaları için önizleme oluşturup cihazlarında bu hesabı başarılı bir şekilde kullanarak test edebilmelidir.
  17. Google Asistan'ı ayrı bir uygulama olarak indirdiyseniz cihazınızda zorla durdurmayı deneyin. Bir uygulamayı genellikle telefonunuzun Ayarlar uygulamasından zorla durdurabilirsiniz.
  18. Bu adımların hiçbiri işe yaramazsa Uygulama İşlemi sorun izleyicisinde sorun bildirin.