Android Studio için Journeys

Android Studio için yolculuklar oluşturmak, her testin (yolculuk olarak adlandırılır) adımlarını ve onaylarını açıklamak için doğal dil kullanmanıza olanak tanıyarak uçtan uca testlerin yazılmasını ve sürdürülmesini kolaylaştırır. Gemini'ın görme ve muhakeme özelliklerinden yararlanarak doğal dilde yazılan adımlar, Gemini'ın uygulamanızda gerçekleştirdiği işlemlere dönüştürülür. Böylece yolculuklarınızı hem yazmak hem de anlamak kolaylaşır. Ayrıca, daha karmaşık onaylamalar yazıp açıklayabilirsiniz. Gemini, yolculuklarınızın başarılı olup olmadığını belirlemek için bunları cihazda gördüklerine göre değerlendirir.

Ayrıca Gemini, hedefleri karşılamak için hangi işlemlerin yapılacağı konusunda akıl yürüttüğünden yolculuklar, uygulamanızın düzeninde veya davranışında yapılan küçük değişikliklere karşı daha dayanıklıdır. Bu da uygulamanızın farklı sürümlerinde ve farklı cihaz yapılandırmalarında test çalıştırırken daha az kararsız testle sonuçlanır.

Yolculukları doğrudan Android Studio'da yazıp yerel veya uzak Android cihazlarda çalıştırın. IDE, yolculuklar oluşturmak için yeni bir düzenleyici deneyimi sunar. Ayrıca, Gemini'ın muhakemesini ve yolculuğunuzun yürütülmesini daha iyi takip etmenize yardımcı olan zengin sonuçlar sağlar.

Yolculuk yazma

Android Studio, yolculuk oluşturmayı ve düzenlemeyi kolaylaştıran bir dosya şablonu ve yeni bir düzenleyici deneyimi sunar. Arama Yolculukları, yolculuk açıklamanızı ve adımlarınızı düzenlemek için XML söz dizimi kullanılarak yazılır.

Bir yolculuk oluşturmak ve düzenlemeye başlamak için aşağıdakileri yapın:

1. Android Studio'daki Project (Proje) panelinde, yolculuk yazmak istediğiniz uygulama modülünü sağ tıklayın.
2. Yeni > Test > Yolculuk Dosyası'nı seçin.
3. Görünen iletişim kutusunda yolculuğunuzun adını ve açıklamasını girin.
4. Tamam'ı tıklayın. Android Studio, yolculuğunuz için seçtiğiniz adla bir XML dosyası oluşturur. XML'yi doğrudan düzenlemek için Kod görünümünü veya daha iyi bir düzenleme deneyimi için Tasarım görünümünü kullanabilirsiniz.
5. Yolculuğunuzu Tasarım görünümünde incelerken metin alanını kullanarak yolculuğunuzun her adımını açıklayın. Her adımda, Gemini'ın gerçekleştirmesini istediğiniz açıklayıcı işlemler veya Gemini'ın değerlendirmesini istediğiniz iddialar yer alabilir.
6. Aynı yolculukta yeni bir istem başlatmak için klavyenizde Enter tuşuna basın. Tanımlamak istediğiniz yolculuğun her adımı için bu işlemi gerektiği kadar tekrarlayabilirsiniz.

Yolculuk yazmayla ilgili ipuçları

Yolculuklarınızı ayrıntılı ve düzenli bir şekilde yazmak, Gemini'ın amaçladığınız yolculukları daha doğru ve belirleyici bir şekilde gerçekleştirme olasılığını artırabilir. Yolculuklarınızı daha etkili bir şekilde yazmanıza yardımcı olacak bazı ipuçlarını aşağıda bulabilirsiniz: * Onayları işlemlerden ayırın: Gemini, yolculuğa devam etmek için uygulamanızın "doğru" durumda olup olmadığını belirlemek üzere uygulamanızın durumunu sürekli olarak değerlendirir. Ancak daha karmaşık onaylamaları ayrı bir adım olarak tanımlamanız gerekebilir. Ayrıca, bu adımın bir onaylama adımı olduğunu Gemini'a bildirmek için her isteme "Doğrula", "Onayla" veya "Kontrol et" gibi anahtar ifadelerle başlayın. * Kaydırma hareketleriyle Gemini'a doğrudan talimat verme: Gemini, dokunma veya klavye girişleri gibi temel etkileşimlerin yanı sıra ekranın belirli yönlerde kaydırılmasını gerektiren işlemleri de destekler. Örneğin, içeriklerde gezinmek veya bazı kullanıcı arayüzlerini kapatmak için kaydırma işleminizin yönünü ve amacını açıklamanız yeterlidir. Gemini, varsayılan olarak ekranın ortasından kaydırılır ancak ekranın farklı bir bölümünde kaydırılmasını sağlayabilirsiniz. * Karmaşık etkileşimlerden ve yapılandırma değişikliklerinden kaçının: Gemini şu anda çok parmaklı hareketler, ekran döndürme veya katlama gibi tüm etkileşimleri ve yapılandırma değişikliklerini desteklemez. Ekibimiz, Gemini'ın özelliklerini iyileştirmek için çalışıyor.

Yolculuğunuzu çalıştırma

Yolculuğunuzu, diğer tüm enstrümanlı testlerde olduğu gibi mevcut herhangi bir yerel veya uzak cihazda çalıştırabilirsiniz. Android Studio, yolculuğunuzun yürütülmesini anlamanıza yardımcı olan zengin sonuçlar oluşturur.

Bir yolculuğu test etmek için aşağıdakileri yapın:

1. Ana araç çubuğundan bir hedef cihaz seçin (ör. enstrümanlı test çalıştırırken yaptığınız gibi).
2. Test etmek istediğiniz yolculuk XML dosyasına gidin ve dosyayı düzenleyicide açın.
3. Düzenleyicide aşağıdakilerden birini yapın:
   1. Tasarım görünümündeyseniz Yolculuğu Çalıştır'ı tıklayın.
   2. Kod görünümündeyken, XML'de yolculuğun adının tanımlandığı yerin yanındaki olukta Çalıştır'ı tıklayın.

Android Studio, sizin için bir Journeys Test yapılandırması oluşturur ve bunu hedef cihazda çalıştırır. Android Studio, yürütme sırasında uygulamanızı oluşturup dağıtır ve yolculuğunuzun her adımında hangi işlemlerin yapılacağını belirlemek için Gemini'a bağlanır.

Yolculuk yürütülürken düzenleyicide sınırlı sonuçlar da gösterilir. Örneğin, yolculuğunuzdaki her adımın yürütülmesi sırasında ekran görüntüleri, gerçekleştirilen işlem ve gerekçe. Daha fazla bilgi görmek için düzenleyicideki küçük resmin üzerine gelmeniz yeterlidir. Bu, yolculuğunuzdaki istemleri tekrarlarken faydalı olabilir.

Sonuçları görüntüle

Android Studio, yolculuğunuzu test etmeyi tamamladığında sonuçları göstermek için test sonuçları paneli otomatik olarak görünür.

Android Studio'da çalıştırabileceğiniz diğer enstrümanlı testlere kıyasla, yolculukların sonuçlarının gösterilme biçiminde bazı farklılıklar vardır.

• Testler paneli, yolculuğu ayrı adımlara ayırır. Gemini'ın her adımı nasıl uyguladığı hakkında daha fazla bilgi edinmek için adımları tıklayabilirsiniz.
• Sonuçlar panelinde, Gemini'ın yolculuğunuzu nasıl anladığı ve bu konuda nasıl akıl yürüttüğü ile yolculuğun nasıl gerçekleştirildiği hakkında bilgi edinmenize yardımcı olacak zengin bilgiler gösterilir.
• Gemini'a gönderilen ekran görüntüleri, adımın her işleminde görsel yardım için gösterilir.
• Yapılan her işlem ve Gemini'ın bu işlemi yapma nedeni, her ekran görüntüsünün yanında açıklanır.
• Adımdaki her işlem numaralandırılır.

Bilinen sorunlar

• Bir yolculuğu test ederken uygulamanızın tüm izinleri varsayılan olarak verilir.
• Android 15 (API düzeyi 35) çalıştıran bir cihazda yolculuk testi yaparken cihazda "AndroidX Crawler" için "Güvenli Olmayan Uygulama Engellendi" uyarısı görebilirsiniz. Bu kontrolü atlamak için Yine de yükle'yi tıklayabilirsiniz. Dilerseniz Cihazdaki geliştirici seçeneklerini yapılandırabilir ve USB üzerinden uygulama doğrulama seçeneğini devre dışı bırakabilirsiniz.
• Yolculuk dosyaları şu anda Projeler panelindeki Android görünümünde görünmemektedir. Projenizdeki yolculuk dosyalarını görmek için Proje görünümünü kullanın.
• Bir yolculuktaki birden fazla işlem tam olarak aynı istemi paylaşıyorsa yolculuk düzenleyicide gösterilen test sonuçları yanlış olabilir. Daha net bir ifadeyle, yinelenen istemle ilgili tüm işlemler, bu istemin en son güncellenen örneğiyle ilişkili test sonuçlarını gösterir. Bu sorunu çözmek için her işlemin benzersiz bir isteme sahip olduğundan emin olun. Örneğin, farklı bir önek veya sonek ekleyebilirsiniz.
• Klavye yeni bir emülatöre ikinci kez yüklendiğinde kalem pop-up'ı görünür. Bu pop-up genellikle metin alanlarıyla etkileşime giren testlerin başarısız olmasına neden olur. Bu durumda, pop-up'ı kapatın ve yolculuğu yeniden çalıştırın.
• Uygulama tarayıcı yapıları bazen aracı gerekçesinde görünebilir.
• Yolculuk yürütme bazen IllegalStateException ile başarısız oluyor. Bu durumda, hatanın tamamını görmek için Test Sonuçları'nı tıklayabilirsiniz.

• Android Gradle eklentisi (com.android.application) üst düzey build.gradle dosyasında tanımlanmamışsa bir yolculuğu çalıştırırken aşağıdaki hatayı görebilirsiniz:

  Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
  

  Bu sorunu çözmek için eklentinin üst düzeydeki build.gradle dosyasında tanımlandığından emin olun. Daha fazla bilgi için Android derleme sistemini yapılandırma başlıklı makaleyi inceleyin.