Sorun giderme

Uygulama İşlemleri geliştirirken kurulumunuzla veya Uygulama İşlemleri test aracıyla ilgili sorunlarla karşılaşabilirsiniz. Bu sayfada, sık karşılaşılan bazı sorunlar ve çözümleri açıklanmaktadır.

Genel

Hata: Kısa bildirimde "URL'yi açacak uygulama bulunamadı" mesajı gösteriliyor

Doğru şekilde yapılandırıldığından emin olmak için actions.xml bölümündeki karşılama urlTemplate ayarları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şlamak için doğru şekilde yapılandırıldığından emin olun.

Hata: "Uygulama yüklenmedi"

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 bunu kontrol ettiğinizden emin olun.

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

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

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

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

APK yüklenirken işlemler şema dokümanı için "Geçersiz konum" hatası

Yayın APK'nızdaki kaynakları etkileyen bir karartma veya optimizasyon aracı kullanırsanız APK yüklemeniz başarısız olabilir. Kaynak dosyaları kullanmayan ProGuard gibi araçlar bu soruna neden olmaz.

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

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

Bu hatayı Play Console'da uygulama sürümü oluştururken görebilirsiniz. Actions on Google Hizmet Şartları'nı kabul etmek için aşağıdaki 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, giriş yapmış kullanıcının bu şartları kabul etmek için gerekli 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ının yüklü sürümünü en yeni sürüme güncelleyin.

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

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

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

Önizlemeniz, actions.xml dosyanızın içeriğiyle dinamik olarak güncellenmiyor. actions.xml dosyanızı manuel olarak değiştirdikten 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, üzerinde çalıştırma izninizin olmadığı bir pakette de çalıştırıyor olabilirsiniz.

Hata devam ederse lütfen bir hata kaydı oluşturun 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, Finder'ınızdaki 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 etmenizi sağlar. 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 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ızda proxy sunucusu kullanılı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 bu URL kalıbına izin verecek şekilde güncelleyin: https://actions.googleapis.com/**.

Test eklentisiyle uygulama işlemi çağrıldığında Asistan, "Üzgünüm, 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 ve Google Asistan 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ğini kontrol edin.
5. actions.xml dosyanızdaki urlTemplateyerine getirme tanı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 silip tekrar yeni bir önizleme oluşturun.
8. Google Asistan'ın yerine getirme işlemiyle ilgili hatalar için Logcat aracını kontrol edin. Uygulamanızda başlatılan bir amaç 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. Google Asistan'ı kullanarak bir uygulama işlemini tetiklerken çağırma adının, uygulama işlemleri test aracı tarafından oluşturulan önizlemeyle eşleştiğinden emin olun.
12. Transkripsiyon hatalarını önlemek 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 özelliklerin, belirli ürün türleri ve derleme varyantları için derlemelerin nihai applicationId değerini 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'dür.
14. Önizlemenizi benzersiz bir çağırma 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 iş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 tekrarlayamadığınızı görmek için bu uygulamaya 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 olmayan 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 hesabı kullanarak uygulamalarının önizlemelerini 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ı durmaya zorlamayı 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 kaydı oluşturun.