Memasang Maestro dan Menjalankan Aliran Pertama Anda

Aliran Maestro ialah fail YAML. appId peringkat teratas menentukan app yang hendak diuji — gunakan pengecam himpunan untuk iOS (contohnya, com.example.myapp) atau nama pakej untuk Android. Pemisah --- memulakan senarai perintah.

Mulakan dengan perintah launchApp untuk membuka app dari keadaan baharu. Kemudian tambahkan penegasan dan tindakan. Aliran pertama yang paling ringkas hanya membuka app dan mengesahkan bahawa skrin alu-aluan dipaparkan.

Jalankan aliran Maestro dengan maestro test path/to/flow.yaml. Pastikan simulator atau emulator sedang berjalan dan app telah dipasang padanya sebelum melaksanakan perintah tersebut. Maestro bersambung kepada simulator yang sedang berjalan secara automatik — pemilihan peranti tidak diperlukan apabila hanya terdapat satu peranti.

Maestro memaparkan setiap perintah semasa perintah itu dilaksanakan. Jika berjaya, setiap langkah menunjukkan tanda semak hijau. Jika gagal, Maestro memaparkan perintah yang gagal, tangkapan skrin antara muka pada saat kegagalan, serta mesej ralat. Tangkapan skrin itu amat berguna untuk menyahpepijat sebab penegasan gagal.

Perintah tapOn mensimulasikan ketikan jari. Anda boleh mengetik berdasarkan teks (label yang kelihatan), berdasarkan id (testID elemen), atau berdasarkan titik pada skrin yang ditentukan dalam bentuk peratusan. Mengetik berdasarkan teks ialah kaedah yang paling mudah dibaca dan paling tahan terhadap perubahan susun atur.

Jika beberapa elemen mempunyai teks yang sama, tambahkan index untuk menentukan elemen yang hendak digunakan (berindeks bermula daripada 0). Gunakan optional: true untuk menjadikan ketikan bersyarat — ketikan akan dilangkau tanpa menyebabkan kegagalan jika elemen tersebut tiada, yang berguna untuk menutup dialog kebenaran pilihan.

Gunakan inputText untuk menaip teks ke dalam medan input yang sedang difokuskan. Ketik TextInput terlebih dahulu untuk memfokuskannya, kemudian gunakan inputText untuk menaip. Maestro menaip keseluruhan rentetan sekali gus, bukannya aksara demi aksara.

Bagi medan yang memerlukan teks sedia ada dipadamkan terlebih dahulu, gunakan clearText sebelum inputText. Gunakan hideKeyboard selepas menaip untuk menutup papan kekunci perisian, yang mungkin menutupi elemen lain yang perlu anda gunakan.

Maestro menjana keputusan ujian dalam beberapa format: teks biasa dalam terminal, XML JUnit (untuk sistem penyepaduan berterusan seperti GitHub Actions), atau laporan HTML interaktif. Laporan HTML menyertakan tangkapan skrin bagi setiap langkah, supaya anda boleh menyemak secara visual perkara yang berlaku pada setiap titik dalam aliran dengan mudah.

Apabila ujian gagal, Maestro menyimpan tangkapan skrin skrin pada saat kegagalan. Cari tangkapan skrin kegagalan dalam output untuk memahami sebab penegasan gagal — selalunya skrin menunjukkan pemutar pemuatan dan bukannya kandungan yang dijangka, sekali gus mendedahkan masalah masa.

Perintah dalam aliran Maestro dilaksanakan secara berurutan. Maestro menunggu setiap perintah selesai secara automatik sebelum beralih kepada perintah seterusnya. Ketikan menunggu sehingga elemen kelihatan dan stabil sebelum berinteraksi dengannya, manakala penegasan akan dicuba semula sehingga elemen muncul (dengan had masa yang boleh dikonfigurasi).

Had masa lalai untuk assertVisible ialah 5 saat. Jika app anda mengambil masa lebih lama untuk memuatkan skrin (contohnya, app mendapatkan data daripada API yang perlahan), tingkatkan had masa dengan pilihan timeout atau tambahkan perintah waitForAnimationToEnd.

Secara lalai, launchApp membawa app ke latar depan jika app itu sudah berjalan (pelancaran hangat). Bagi ujian yang mesti bermula dengan keadaan bersih — tiada pengguna yang telah log masuk dan cache pangkalan data kosong — gunakan clearState: true untuk memadamkan semua data app sebelum membukanya.

Ini sama seperti menyahpasang dan memasang semula app. Gunakannya dalam aliran ujian anda yang paling kritikal untuk memastikan aliran tersebut bermula daripada asas yang boleh dijangka dan tidak bergantung pada data yang ditinggalkan oleh aliran terdahulu.

Bagi langkah berulang seperti log masuk sebelum setiap ujian, keluarkan langkah tersebut ke dalam fail YAML subaliran dan rujukkannya dengan runFlow. Dengan ini, setiap aliran ujian kekal tertumpu pada senario khususnya dan persediaan log masuk menjadi satu langkah yang boleh digunakan semula dalam satu baris.

Subaliran berfungsi seperti panggilan fungsi dalam kod — subaliran dilaksanakan sebaris bersama aliran induk. Anda boleh menghantar parameter kepada subaliran menggunakan bahagian env supaya subaliran boleh digunakan semula dengan data yang berbeza (pengguna yang berbeza dan nilai input yang berbeza).

Maestro Studio ialah antara muka web interaktif yang menstrim skrin simulator anda dan membolehkan anda merakam aliran dengan mengklik elemen. Jalankan maestro studio dan penyemak imbas akan dibuka supaya anda boleh mengklik untuk menjana perintah YAML secara automatik.

Ini ialah cara terpantas untuk mencipta aliran pertama anda — rakam laluan berjaya secara interaktif, kemudian semak dan sunting YAML yang dijana untuk menambahkan penegasan serta mengendalikan kes pinggiran. Studio turut menunjukkan pepohon elemen bagi setiap skrin, yang membantu anda mencari testID atau teks terbaik untuk disasarkan.

Dalam pelajaran ini, anda telah mempelajari: cara memasang Maestro dan menulis fail aliran YAML yang membuka app serta membuat penegasan terhadap kandungan yang kelihatan, cara menggunakan tapOn, inputText dan assertVisible untuk mengendalikan interaksi pengguna dalam aliran, serta cara menggunakan subaliran untuk berkongsi langkah berulang seperti log masuk merentas beberapa aliran ujian. Seterusnya, kita akan menulis penegasan Maestro yang lebih maju dan mengendalikan keadaan antara muka yang dinamik.