Android Studio için Journeys

Android Studio için yolculuklar oluşturmak, her testin (yolculuk) 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ı yazmak ve 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.

Gemini, hedefleri karşılamak için hangi işlemlerin yapılacağını belirlediğinden 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.

Android Studio'dan doğrudan yerel veya uzak Android destekli cihazlarda yolculuklar yazıp çalıştırın. IDE, yolculuklar oluşturmak için yeni bir düzenleyici deneyimi sunar. Ayrıca, Gemini'ın yolculuğunuzdaki muhakeme ve yürütme sürecini daha iyi anlamanıza yardımcı olan zengin sonuçlar sağlar.

Yolculuk yazma

Android Studio, yolculuk oluşturma ve düzenleme işlemlerini basitleştiren bir dosya şablonu ve yeni bir düzenleyici deneyimi sunar. Yolculuklar, yolculuk açıklamanızı ve adımlarınızı düzenlemek için Genişletilebilir Biçimlendirme Dili (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 görüntülerken 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 kesin bir şekilde doğru olarak çalıştırma olasılığını artırabilir. Aşağıda, yolculuklarınızı daha etkili bir şekilde yazmanıza yardımcı olacak bazı ipuçları verilmiştir:

• Onayları işlemlerden ayırma: 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 belirtmek için her isteme "Doğrula", "Onayla" veya "Kontrol et" gibi önemli ifadelerle başlayın.
• Kaydırma hareketleriyle Gemini'a 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çeriği kaydırmak veya bazı kullanıcı arayüzlerini kapatmak için kaydırma işleminizin yönünü ve amacını açıklayın. Gemini, varsayılan olarak ekranın ortasından kaydırılır ancak cihaz ekranının farklı bir bölümünde kaydırılmasını belirtebilirsiniz.
• Karmaşık etkileşimlerden ve yapılandırma değişikliklerinden kaçının: Gemini, ç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 geliştirmek için çalışıyor.

Yolculuğunuzu çalıştırma

Yolculuğunuzu, diğer tüm enstrümantasyonlu 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. Bu işlem, enstrümanlı test çalıştırırken yaptığınız işleme benzer.
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ündeyseniz XML'de yolculuğun adının tanımlandığı yerin yanındaki olukta Çalıştırtest'ı 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 yapılacak işlemleri belirlemek için Gemini'a bağlanır.

Daha fazla bilgi görmek için düzenleyicideki küçük resmin üzerine gelin. Bu, yolculuğunuzdaki istemleri yineleme konusunda 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 panelinde yolculuk ayrı adımlara ayrılı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ğunuzla ilgili yorumunu ve akıl yürütmesini, ayrıca Gemini tarafından nasıl gerçekleştirildiğini anlamanıza 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şlemle ilgili gerekçesi, her ekran görüntüsünün yanında açıklanmıştı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ını 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österilmemektedir. Projenizdeki yolculuk dosyalarını görmek için Proje görünümünü kullanın.
• Bir yolculuktaki birden fazla işlemde aynı istem kullanılı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 işlemi 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.