Perjalanan untuk Android Studio

Membuat perjalanan untuk Android Studio membantu membuat pengujian end-to-end mudah ditulis dan dikelola 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 dikonversi menjadi tindakan yang dijalankan Gemini di aplikasi Anda, sehingga perjalanan Anda mudah ditulis dan dipahami. Selain itu, Anda dapat menulis dan mendeskripsikan pernyataan yang lebih kompleks, yang dievaluasi Gemini berdasarkan apa yang dilihatnya di perangkat untuk menentukan apakah perjalanan Anda berhasil atau gagal.

Karena Gemini menentukan 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 tidak stabil saat dijalankan terhadap berbagai versi aplikasi dan konfigurasi perangkat yang berbeda.

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

Menulis perjalanan

Android Studio menyediakan template file dan pengalaman editor baru yang menyederhanakan pembuatan dan pengeditan perjalanan. Perjalanan ditulis menggunakan sintaksis Extensible Markup Language (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. Dalam 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 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", "Nyatakan bahwa", atau "Periksa bahwa" untuk menunjukkan kepada Gemini bahwa langkah ini dimaksudkan sebagai pernyataan.
• Mengarahkan Gemini dengan gesekan: Selain interaksi dasar, seperti mengetuk atau input keyboard, Gemini mendukung tindakan yang mengharuskannya menggeser layar ke arah tertentu. Misalnya, untuk men-scroll konten atau menutup beberapa UI, deskripsikan arah dan maksud tindakan geser Anda. Secara default, Gemini digeser dari tengah layar, tetapi Anda dapat menentukan bahwa Gemini harus digeser di bagian lain layar perangkat.
• Hindari interaksi dan perubahan konfigurasi yang rumit: Gemini 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 dalam tampilan Code, klik Run test 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.

Arahkan kursor ke thumbnail di editor untuk melihat informasi selengkapnya. Hal ini dapat membantu 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 interpretasi dan penalaran Gemini tentang perjalanan Anda, serta cara Gemini melaksanakannya.
• Screenshot yang dikirim ke Gemini ditampilkan sebagai bantuan visual di setiap tindakan dalam langkah ini.
• Setiap tindakan yang diambil dan alasan Gemini untuk 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 "AndroidX Crawler". 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 di 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 tersebut yang terakhir diperbarui. Untuk mengatasi hal 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.