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 çözümleri açıklanmaktadır.

Genel

Hata: "URL'yi açacak uygulama bulunamadı" hata mesajı bir pop-up bildirimde gösteriliyor

Doğru şekilde yapılandırıldığından emin olmak için actions.xml uygulamanızda 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> öğesinin, actions.xml dosyanızda belirttiğiniz derin bağlantıyı filtrelemediği anlamına gelebilir. Hata bildirmeden önce bu sayfayı kontrol etmeyi unutmayın.

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

Bu durum, <entity-set-reference> etiketiyle ilgili bilinen bir linter sorunundan kaynaklanmaktadır. Bu mesajı dikkate almayabilirsiniz. Geçici bir çözüm olarak, bu etikete tools:ignore="ValidActionsXml" özelliğini ekleyerek lint kontrolünü devre dışı bırakabilirsiniz.

Lint kontrolü devre dışı bırakılmış bir varlık grubu referansı örneği: 

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

Hata: APK yüklenirken işlem şeması 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ükleme işleminiz başarısız olabilir. Kaynak dosyalarını önleyen ProGuard gibi 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 (ör. izin verilenler listesi kullanarak).

Hata: "Etkin bir APK veya Android App Bundle, actions.xml dosyası içeriyor. In order to continue, accept the Actions on Google Terms of Service." (Devam etmek için Actions on Google Hizmet Şartları'nı kabul edin.) mesajı Google Play Console'da gösteriliyor.

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

  1. Google 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 hizmetlerime Uygulama İşlemleri'ni entegre et etiketli kutuyu işaretleyin ve talimatları uygulayın.

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

Bu durum, oturum açmış kullanıcının bu şartları kabul etmek için gereken erişim düzeyine sahip olmadığı anlamına gelebilir. İlk gönderimin Google 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ını 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 dosyasıyla eşleşmiyor.

Önizlemeniz, actions.xml dosyanızın içeriğiyle dinamik olarak güncellenmez. actions.xml dosyanızı manuel olarak değiştirdikten veya Android Studio'da derleme değişkenlerini 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 veriyor.

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

Hata devam ederse lütfen bir hata bildirin ve aşağıdaki bilgileri 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, Finder'da idea.log konumunu gösterir. Günlük dosyasında "Submit Actions Request Body:" 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 önizlemesini oluşturarak Google Asistan entegrasyonlarını tek bir Google Hesabı ile test etmenize olanak tanır. Bu önizlemeleri oluşturmak için test aracının etkin bir internet bağlantısına ve gerekirse Google alanlarına proxy erişimine ihtiyacı vardır.

Test aracını çalıştırırken ağ sorunlarını çözmek için aşağıdaki yaygın sorunları kontrol edin:

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

  • İnternet bağlantınız etkinse 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 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 bunu bulamadım" diyor.

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

  1. Android Studio, Play Console ve test cihazınızda aynı Google Hesabı ile oturum açın.
  2. Cihaz verilerini senkronize etme'yi etkinleştirin.
  3. Cihazın ve Google Asistan'ın dilini en-US olarak ayarlayın.
  4. Google Play Console'daki uygulamanın paket adının, test uygulamasındaki paket adıyla eşleştiğinden emin olun.
  5. actions.xml dosyanızdaki karşılama urlTemplate tanımında, android:host ve android:scheme değerlerinin AndroidManifest dosyasında belirtilen değerlerle 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. Uygulama İşlemleri test aracından önizlemeyi silin ve tekrar yeni bir önizleme oluşturun.
  8. Google Asistan için yerine getirmeyle ilgili hatalar olup olmadığını Logcat aracında kontrol edin. Uygulamanızda bir intent başlatıldığını görürsünüz.
  9. Hesap için "Cihazlarınızdaki uygulama bilgileri" ayarını etkinleştirin.
  10. Google Asistan'ı açın ve kurulumu tamamladığınızdan emin olun. (Kurulum ilerleme çubuğu genellikle ekranın alt kısmında mavi bir çubuk olarak görünür ancak bazı durumlarda farklı görünebilir.)
  11. Uygulama İşlemi'ni tetiklemek için Google Asistan'ı kullanırken başlatma adının, Uygulama İşlemleri test aracı tarafından oluşturulan önizlemeyle eşleştiğinden emin olun.
  12. Metne dönüştürme hatalarını önlemek için ses yerine metin girişi 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 türleri ve derleme değişkenleri için derlemelerin nihai applicationId değerini değiştirebileceğini unutmayın. Bu örnekte, sahte ürün türünün applicationId değeri com.example.android.architecture.blueprints yerine com.example.android.architecture.blueprints.master.mock olarak ayarlanmıştır.
  14. Önizlemenizi benzersiz bir çağrı adı kullanacak şekilde yapılandırın. Diğer uygulamalarla çakışma olasılığını azaltan benzersiz bir kelime kullanmayı deneyin.
  15. Paylaşılabilir bir kod tabanında sorun giderirken sorunları izole 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 üzerine kademeli olarak ek ö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ışı 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şturabilmeli ve cihazlarında bu hesabı kullanarak başarılı bir şekilde test yapabilmelidir.
  17. Google Asistan'ı ayrı bir uygulama olarak indirdiyseniz cihazınızda uygulamayı 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 bir sorun bildirin.