Rangkaian Deskripsi Langkah untuk Android Studio

Journeys untuk Android Studio memanfaatkan kemampuan visi dan penalaran AI untuk menavigasi dan menguji aplikasi Anda berdasarkan petunjuk bahasa alami Anda. Kumpulan petunjuk Anda, yang disebut perjalanan, dikonversi menjadi tindakan yang dilakukan AI pada aplikasi Anda. Selain itu, Anda dapat menulis dan mendeskripsikan pernyataan yang lebih kompleks, yang dievaluasi AI berdasarkan apa yang dilihatnya di perangkat.

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

Anda dapat menulis dan menjalankan rangkaian deskripsi langkah langsung dari Android Studio atau dari command line terhadap perangkat yang didukung Android lokal atau jarak jauh. IDE memberikan pengalaman editor baru saat membuat rangkaian deskripsi langkah serta hasil multimedia yang membantu Anda lebih memahami alasan dan eksekusi rangkaian deskripsi langkah Anda oleh Gemini.

Menulis rangkaian deskripsi langkah

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

Untuk membuat dan mulai mengedit rangkaian deskripsi langkah, lakukan hal berikut:

1. Dari panel Project di Android Studio, klik kanan modul aplikasi yang ingin Anda tulis rangkaian deskripsi langkahnya.
2. Pilih New > Journey Test.

3. Dalam dialog yang muncul, berikan nama dan deskripsi rangkaian deskripsi langkah Anda.

   

4. Klik Finish. Android Studio membuat file XML untuk rangkaian deskripsi langkah Anda dengan nama yang Anda pilih. Anda dapat menggunakan tampilan Code untuk mengedit XML secara langsung, atau tampilan Design untuk pengalaman pengeditan yang lebih sederhana.

5. Saat melihat rangkaian deskripsi langkah Anda dalam tampilan Design, gunakan kolom teks untuk mendeskripsikan setiap langkah rangkaian deskripsi langkah Anda. Setiap langkah dapat mencakup tindakan deskriptif yang ingin Anda lakukan oleh Gemini atau pernyataan yang ingin Anda evaluasi oleh Gemini.

6. Tekan Enter di keyboard untuk memulai langkah baru dalam rangkaian deskripsi langkah yang sama. Anda dapat mengulanginya sesuai kebutuhan untuk setiap langkah rangkaian deskripsi langkah yang ingin Anda tentukan.

Mengonfigurasi varian build

Journeys berjalan terhadap varian build tertentu dari aplikasi Anda. Saat pertama kali membuat rangkaian deskripsi langkah menggunakan wizard, rangkaian pengujian yang dihasilkan dikonfigurasi untuk berjalan terhadap varian build yang aktif di Android Studio.

Namun, jika Anda kemudian mengganti varian build aktif di Android Studio (misalnya, ke varian produk lain seperti demoDebug) tanpa mengupdate konfigurasi, menjalankan rangkaian deskripsi langkah akan gagal. Untuk memperbaikinya, Anda harus menambahkan varian baru ke properti targetVariants di blok testSuites pada file build.gradle.kts (atau build.gradle) level modul Anda.

Misalnya, untuk mengonfigurasi rangkaian journeysTest untuk varian demoDebug:

android {
    // ...
    testSuites {
        create("journeysTest") {
            // ...
            targetVariants += listOf("demoDebug")
        }
    }
}

Tips untuk menulis rangkaian deskripsi langkah

Meskipun AI dapat memahami sebagian besar langkah yang ditulis dalam bahasa yang didukung, mengikuti tips berikut untuk menulis rangkaian deskripsi langkah dapat menghasilkan hasil yang lebih akurat dan diharapkan:

• Asumsikan aplikasi Anda sudah berada di latar depan: Menjalankan rangkaian deskripsi langkah akan otomatis meluncurkan aplikasi Anda. Langkah-langkah rangkaian deskripsi langkah Anda harus dimulai setelah aplikasi diluncurkan sepenuhnya. Artinya, Anda tidak perlu menyertakan "launch app" sebagai langkah.
• Gunakan bahasa yang tidak ambigu: Bersikap presisi akan meminimalkan kesalahan interpretasi dan meningkatkan keandalan.

• Sertakan kriteria keberhasilan sebagai bagian dari langkah: Hal ini membantu Gemini memahami maksud Anda dengan lebih baik dan mengklarifikasi kapan tindakan selesai dan tindakan berikutnya dapat dimulai.

• Optimalkan rangkaian deskripsi langkah Anda: Jika rangkaian deskripsi langkah Anda tidak dieksekusi seperti yang diharapkan, Anda dapat melihat hasilnya dan memeriksa 'Action Taken' dan 'Reasoning' yang sesuai untuk memahami alasan Gemini mungkin tidak menjalankan langkah-langkah seperti yang Anda harapkan. Gunakan informasi ini untuk memberikan kejelasan tambahan pada petunjuk Anda.
• Bagi rangkaian deskripsi langkah Anda menjadi langkah-langkah yang lebih spesifik: Meskipun AI dapat menafsirkan langkah-langkah multi-tindakan, terkadang langkah-langkah diskrit yang lebih mendetail dapat meningkatkan akurasi dan kemampuan pengulangan rangkaian deskripsi langkah.
  • "Error: Could not successfully complete the action in max allowed attempt": Jika Anda mengalami error ini, coba bagi langkah yang gagal menjadi dua langkah atau lebih yang lebih kecil. Hal ini karena error ini terjadi jika AI tidak dapat menyelesaikan tindakan setelah mencoba jumlah interaksi maksimum dengan aplikasi Anda.

Kemampuan yang didukung dan tidak didukung

Berikut adalah ringkasan kemampuan yang didukung dan belum sepenuhnya didukung saat menulis rangkaian deskripsi langkah. Daftar berikut tidak lengkap.

Tindakan berikut didukung dalam rangkaian deskripsi langkah:

• Tap pada elemen UI.
• Type untuk memasukkan teks ke dalam kolom teks.
• Swipe/Scroll ke arah tertentu untuk menavigasi UI.

Kemampuan berikut tidak sepenuhnya didukung saat ini atau mungkin berperforma tidak konsisten:

• Gestur multi-jari (misalnya, cubit untuk memperbesar) - Interaksi yang memerlukan dua atau lebih titik kontak di layar secara bersamaan, seperti mencubit untuk memperbesar atau memperkecil, atau menggeser dengan dua jari.
• Long-press - Menekan dan menahan jari selama durasi yang lebih lama dari ketukan standar.
• Ketuk dua kali - Mengetuk lokasi yang sama di layar dua kali secara cepat dalam suksesi cepat.
• Rotasi/pelipatan layar - Menangani perubahan orientasi perangkat (misalnya, antara potret dan lanskap) atau status fisik perangkat foldable (misalnya, membuka atau menutup).
• Memori - Mempertahankan dan mengingat informasi, konteks, atau input pengguna tertentu di seluruh interaksi atau langkah sebelumnya.
• Counting - Melacak kuantitas, frekuensi, atau progres secara akurat.
• Pernyataan bersyarat - Menjalankan tindakan berdasarkan apakah kondisi lain yang ditentukan terpenuhi.

Fitur dan kemampuan terus ditingkatkan. Sebaiknya periksa halaman ini nanti untuk mempelajari fitur dan kemampuan tambahan. Untuk membantu kami meningkatkan Journeys, bagikan masukan Anda.

Menjalankan rangkaian deskripsi langkah

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

Untuk menguji rangkaian deskripsi langkah, lakukan hal berikut:

1. Pilih perangkat target dari toolbar utama, seperti yang Anda lakukan saat menjalankan pengujian berinstrumen.
2. Buka file XML rangkaian deskripsi langkah yang ingin Anda uji dan buka di editor.
3. Di editor, lakukan salah satu hal berikut:
   1. Jika Anda berada dalam tampilan Design, klik Run Journey.
   2. Jika Anda berada dalam tampilan Code, klik Run 'test' di gutter di samping tempat nama rangkaian deskripsi langkah ditentukan dalam XML.

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

Menjalankan rangkaian deskripsi langkah terhadap aplikasi yang telah diinstal sebelumnya

Anda dapat menjalankan rangkaian deskripsi langkah pada aplikasi yang telah diinstal sebelumnya di perangkat pengujian Anda. Hal ini berguna jika Anda ingin menguji versi produksi aplikasi Anda, atau jika Anda belum mengupdate aplikasi ke Android Gradle Plugin 9.0.0 atau yang lebih tinggi.

1. Buka atau buat project baru yang diupdate ke Android Gradle Plugin 9.0.0 atau yang lebih tinggi.
2. Tulis rangkaian deskripsi langkah.
3. Edit konfigurasi run untuk rangkaian deskripsi langkah dan tambahkan variabel lingkungan berikut. Konfigurasi run dibuat secara otomatis saat Anda mencoba menjalankan rangkaian deskripsi langkah dari Android Studio.
   • Tetapkan JOURNEYS_CUSTOM_APP_ID ke ID paket aplikasi target.
4. Jalankan rangkaian deskripsi langkah yang Anda edit. Android Studio akan menjalankan langkah-langkah rangkaian deskripsi langkah pada aplikasi target yang Anda tentukan.

Menjalankan rangkaian deskripsi langkah dari command line

Untuk menjalankan Journeys dari command line, gunakan Android CLI.

Melihat hasilnya

Saat Android Studio menyelesaikan pengujian rangkaian deskripsi langkah 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 rangkaian deskripsi langkah ditampilkan.

• Panel Tests membagi rangkaian deskripsi langkah menjadi langkah-langkah diskrit. Anda dapat mengklik setiap langkah untuk mengetahui informasi selengkapnya tentang cara Gemini menjalankannya.
• Panel Results menampilkan informasi multimedia untuk membantu Anda memahami cara Gemini memahami dan mempertimbangkan rangkaian deskripsi langkah Anda, serta cara rangkaian deskripsi langkah tersebut dijalankan.
  • Screenshot yang dikirim ke Gemini ditampilkan untuk bantuan visual di setiap tindakan dalam langkah.
  • Setiap tindakan yang diambil dan penalaran Gemini untuk alasan tindakan tersebut diambil dijelaskan di samping setiap screenshot.
  • Setiap tindakan dalam langkah diberi nomor.

Masalah umum

• Saat menguji rangkaian deskripsi langkah, semua izin untuk aplikasi Anda akan diberikan secara default.
• Saat menguji rangkaian deskripsi langkah di perangkat yang menjalankan Android 15 (level API 35), Anda mungkin melihat peringatan di perangkat yang bertuliskan "Unsafe App Blocked" untuk "AndroidX Crawler". Anda dapat mengklik Install anyway untuk melewati pemeriksaan ini. Atau, Anda dapat Mengonfigurasi opsi developer di perangkat dan menonaktifkan opsi untuk Verify apps over USB.