Perjalanan untuk Android Studio

Membuat perjalanan untuk Android Studio membantu mempermudah penulisan dan pemeliharaan pengujian end-to-end dengan memungkinkan Anda menggunakan bahasa alami untuk mendeskripsikan langkah-langkah dan pernyataan untuk setiap pengujian—yang disebut perjalanan. Dengan memanfaatkan kemampuan visi dan penalaran Gemini, langkah-langkah yang ditulis dalam bahasa alami akan dikonversi menjadi tindakan yang dilakukan Gemini di aplikasi Anda, sehingga memudahkan Anda untuk menulis dan memahami perjalanan Anda. Selain itu, Anda dapat menulis dan menjelaskan pernyataan yang lebih kompleks, yang dievaluasi Gemini berdasarkan apa yang dilihatnya di perangkat untuk menentukan apakah perjalanan Anda lulus atau gagal.

Karena Gemini mempertimbangkan tindakan mana yang harus dilakukan untuk memenuhi sasaran, perjalanan lebih tangguh terhadap perubahan kecil pada tata letak atau perilaku aplikasi Anda, sehingga menghasilkan lebih sedikit pengujian yang tidak stabil saat dijalankan terhadap berbagai versi aplikasi dan konfigurasi perangkat yang berbeda.

Tulis dan jalankan perjalanan langsung dari Android Studio terhadap perangkat Android lokal atau jarak jauh. IDE memberikan pengalaman editor baru untuk membuat perjalanan serta hasil multimedia yang membantu Anda lebih memahami alasan dan eksekusi Gemini terhadap perjalanan Anda.

Menulis perjalanan

Android Studio menyediakan template file dan pengalaman editor baru yang memudahkan pembuatan dan pengeditan perjalanan. Perjalanan ditulis menggunakan sintaksis XML untuk mengatur deskripsi dan langkah-langkah perjalanan Anda.

Untuk membuat dan mulai mengedit perjalanan, lakukan hal berikut:

  1. Dari panel Project di Android Studio, klik kanan modul aplikasi yang ingin Anda tulis perjalanannya.
  2. Pilih New > Test > Journey File.
  3. Pada dialog yang muncul, masukkan nama dan deskripsi perjalanan Anda.
  4. Klik OK. Android Studio membuat file XML untuk perjalanan Anda dengan nama yang Anda pilih. Anda dapat menggunakan tampilan Code untuk mengedit XML secara langsung, atau tampilan Design untuk pengalaman pengeditan yang lebih baik.
  5. Saat melihat perjalanan Anda dalam tampilan Desain, gunakan kolom teks untuk mendeskripsikan setiap langkah perjalanan Anda. Setiap langkah dapat mencakup tindakan deskriptif yang ingin Anda lakukan dengan Gemini atau pernyataan yang ingin Anda evaluasi dengan Gemini.
  6. Tekan Enter pada keyboard Anda untuk memulai perintah baru dalam perjalanan yang sama. Anda dapat mengulangi langkah ini sesuai kebutuhan untuk setiap langkah perjalanan yang ingin Anda tentukan.

Tips untuk menulis perjalanan

Menulis perjalanan Anda secara mendetail dan teratur dapat meningkatkan kemungkinan Gemini menjalankan perjalanan yang Anda maksud secara akurat dan lebih deterministik. Berikut beberapa tips untuk membantu Anda menulis perjalanan dengan lebih efektif: * Pisahkan pernyataan dari tindakan: Gemini terus-menerus mengevaluasi status aplikasi Anda untuk menentukan apakah aplikasi berada dalam status "benar" untuk melanjutkan perjalanan. Namun, Anda mungkin perlu menentukan pernyataan yang lebih kompleks sebagai langkah terpisah. Selain itu, mulai setiap perintah menggunakan frasa utama seperti "Verifikasi bahwa", "Tegaskan bahwa", atau "Periksa bahwa" untuk memberi tahu Gemini bahwa langkah ini dimaksudkan sebagai pernyataan. * Mengarahkan Gemini dengan gesekan: Selain interaksi dasar, seperti mengetuk atau memasukkan keyboard, Gemini mendukung tindakan yang mengharuskannya menggeser layar ke arah tertentu. Misalnya, untuk men-scroll konten atau menutup beberapa UI, cukup deskripsikan arah dan maksud tindakan menggeser Anda. Secara default, Gemini digeser dari tengah layar, tetapi Anda dapat mengarahkan Gemini untuk menggeser di bagian lain layar perangkat. * Hindari interaksi dan perubahan konfigurasi yang rumit: Gemini saat ini tidak mendukung semua interaksi dan perubahan konfigurasi, seperti gestur multi-jari, rotasi layar, atau tindakan melipat. Tim sedang berupaya meningkatkan kemampuan Gemini.

Menjalankan perjalanan Anda

Anda dapat menjalankan perjalanan di perangkat lokal atau jarak jauh yang tersedia, mirip dengan pengujian berinstrumen lainnya, dan Android Studio menghasilkan hasil lengkap yang membantu Anda memahami eksekusi perjalanan Anda.

Untuk menguji perjalanan, lakukan hal berikut:

  1. Pilih perangkat target dari toolbar utama, seperti yang Anda lakukan saat menjalankan pengujian berinstrumen.
  2. Buka file XML perjalanan yang ingin Anda uji dan buka di editor.
  3. Di editor, lakukan salah satu tindakan berikut:
    1. Jika Anda berada di tampilan Desain, klik Jalankan Perjalanan.
    2. Jika Anda berada di tampilan Code, klik Run di gutter di samping tempat nama perjalanan ditentukan dalam XML.

Android Studio membuat konfigurasi Journeys Test untuk Anda dan menjalankannya di perangkat target. Selama eksekusi, Android Studio akan mem-build dan men-deploy aplikasi Anda, serta terhubung ke Gemini untuk menentukan tindakan yang harus dilakukan untuk setiap langkah perjalanan Anda.

Hasil terbatas juga ditampilkan di editor saat menjalankan perjalanan, seperti screenshot, tindakan yang dilakukan, dan alasan selama eksekusi setiap langkah dalam perjalanan Anda. Cukup arahkan kursor ke thumbnail di editor untuk melihat informasi selengkapnya. Hal ini dapat berguna saat melakukan iterasi pada perintah dalam perjalanan Anda.

Lihat hasil

Setelah Android Studio selesai menguji perjalanan Anda, panel hasil pengujian akan muncul secara otomatis untuk menampilkan hasilnya.

Dibandingkan dengan pengujian berinstrumen lainnya yang mungkin Anda jalankan di Android Studio, ada beberapa perbedaan dalam cara hasil perjalanan ditampilkan.

  • Panel Tests memecah perjalanan menjadi langkah-langkah terpisah. Anda dapat mengklik setiap langkah untuk mengetahui informasi selengkapnya tentang cara Gemini mengeksekusinya.
  • Panel Hasil menampilkan informasi lengkap untuk membantu Anda memahami cara Gemini memahami dan memproses perjalanan Anda, serta cara pelaksanaannya.
  • Screenshot yang dikirim ke Gemini ditampilkan sebagai bantuan visual di setiap tindakan dalam langkah.
  • Setiap tindakan yang diambil dan alasan Gemini mengambil tindakan tersebut dijelaskan di samping setiap screenshot.
  • Setiap tindakan dalam langkah diberi nomor.

Masalah umum

  • Saat menguji perjalanan, semua izin untuk aplikasi Anda diberikan secara default.
  • Saat menguji perjalanan di perangkat yang menjalankan Android 15 (level API 35), Anda mungkin melihat peringatan di perangkat yang bertuliskan "Aplikasi Tidak Aman Diblokir" untuk "Crawler AndroidX". Anda dapat mengklik Tetap instal untuk melewati pemeriksaan ini. Atau, Anda dapat Mengonfigurasi opsi developer di perangkat dan menonaktifkan opsi Verifikasi aplikasi melalui USB.
  • File perjalanan saat ini tidak muncul dalam tampilan Android di panel Projects. Untuk melihat file perjalanan dalam project Anda, gunakan tampilan Project.
  • Jika beberapa tindakan dalam perjalanan memiliki perintah yang sama persis, hasil pengujian yang ditampilkan di editor perjalanan mungkin salah. Secara khusus, semua tindakan dengan perintah duplikat akan menampilkan hasil pengujian yang terkait dengan instance perintah yang terakhir diperbarui. Untuk mengatasi masalah ini, pastikan setiap tindakan memiliki perintah yang unik—misalnya, dengan menambahkan awalan atau akhiran yang berbeda.
  • Pop-up stylus akan muncul saat keyboard dimuat untuk kedua kalinya di emulator baru. Pop-up ini biasanya menyebabkan pengujian yang berinteraksi dengan kolom teks gagal. Jika hal ini terjadi, tutup pop-up dan jalankan kembali perjalanan.
  • Artefak crawler aplikasi terkadang muncul dalam alasan agen.
  • Eksekusi perjalanan terkadang gagal dengan IllegalStateException. Jika hal ini terjadi, Anda dapat mengklik Hasil Pengujian untuk melihat error lengkapnya.

  • Jika Plugin Android Gradle (com.android.application) tidak ditentukan dalam file build.gradle tingkat teratas, Anda mungkin melihat error berikut saat menjalankan perjalanan:

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

    Untuk mengatasinya, pastikan plugin ditentukan dalam file build.gradle tingkat teratas. Lihat Mengonfigurasi sistem build Android untuk mengetahui informasi selengkapnya.