Menggunakan Azure DevOps untuk Pengujian UI

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang mungkin Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

Panduan ini menjelaskan cara memodifikasi build Azure Pipelines yang sudah ada yang membuat biner aplikasi (.apk atau .ipa file) untuk menambahkan tugas Uji App Center yang menjalankan rangkaian pengujian Anda di Uji App Center.

Azure Pipelines tersedia sebagai bagian dari Azure DevOps Services. Azure Pipelines membantu Anda menerapkan alur build, pengujian, dan penyebaran untuk aplikasi apa pun. Untuk informasi selengkapnya tentang Azure DevOps Services atau Azure Pipelines, lihat Dokumentasi Azure DevOps atau Azure Pipelines.

Tugas Uji App Center untuk Azure Pipelines memungkinkan Anda menjalankan rangkaian pengujian di Pengujian App Center. Anda dapat menggunakan kerangka kerja Appium, XCUItest, Espresso, dan Xamarin.UITest. Baca selengkapnya tentang kerangka kerja di halaman Kerangka kerja yang didukung Pengujian App Center.

Setiap kerangka kerja memiliki bagiannya sendiri dalam panduan ini, di mana Anda dapat membaca tentang persyaratan dasar untuk menyiapkan definisi tugas Uji App Center di Azure Pipelines.

Langkah-langkah konfigurasi umum

Sebelum memulai

Anda memerlukan hal-hal berikut sebelum Anda dapat mulai menguji,

• Build Azure Pipelines yang membuat biner aplikasi Anda (.apk atau .ipa file).
• Akun Uji App Center aktif. Anda dapat mengaktifkan uji coba untuk App Center Test di App Center. Pertama pilih aplikasi Anda lalu pilih Uji di menu sebelah kiri.
• Konfigurasikan alur untuk menggunakan Node 10.x.x. Baca cara pada dokumentasi Azure DevOps, dokumentasinya adalah tentang Javascript tetapi prinsipnya juga berlaku di sini.

Konfigurasi umum Azure Pipelines

Temukan proyek Azure Pipelines Anda dan buka untuk Edit. Klik + untuk menambahkan tugas baru, lalu cari Pusat aplikasi.

Klik Tambahkan di samping tugas Uji App Center. Di sisi kiri layar, klik tugas Uji dengan Visual Studio App Center yang ditambahkan untuk memilih dan memodifikasinya. Tugas Uji App Center dibagi menjadi beberapa bagian.

Di bagian atas, sisipkan jalur ke biner aplikasi Anda (.apk atau .ipa) di bidang Jalur file aplikasi biner.

Menyambungkan ke Pengujian App Center

Masuk ke App Center sebelum menggunakan layanan; ada dua metode autentikasi yang tersedia untuk Anda.

Metode pertama menggunakan token API; untuk memperoleh token API akun Anda:

• Masuk ke App Center dan klik ikon pengaturan pengguna di sudut kiri atas portal App Center.
• Di menu yang muncul, pilih Pengaturan Akun.
• Di panel Pengaturan , pilih Token API.
• Klik tombol Token API baru di sudut kanan atas panel.
• Beri nama token API baru - misalnya, Anda dapat menyebutnya Azure DevOps. Di masa mendatang, nama ini akan membantu Anda mengidentifikasi layanan mana yang menggunakan layanan.
• Klik tombol Tambahkan token API baru. Pop-up menampilkan token API baru; pop-up ini adalah satu-satunya waktu App Center akan menampilkan token ini. Klik tombol clipboard untuk menyalin Token API ke clipboard browser. Simpan token API di suatu tempat (Azure Key Vault, misalnya) tempat Anda dapat mereferensikannya lagi dengan aman nanti jika diperlukan.

Dengan Token API di clipboard:

• Beralih ke jendela Layanan Azure DevOps Anda. Di bidang Koneksi App Center, di bagian Jalankan tugas Uji App Center, klik tombol Tambahkan.
• Isi bidang Nama formulir dengan nama yang sesuai untuk koneksi (misalnya: App Center).
• Tempelkan Token API App Center ke bidang token API.
• Selesaikan penyetelan dengan mengklik tutup.

Pastikan koneksi yang baru dibuat muncul di bidang Koneksi Pusat Aplikasi.

Metode kedua menggunakan kredensial akun App Center Anda:

• Pilih Kredensial dari menu dropdown Metode Autentikasi.
• Isi bidang Nama Pengguna App Center dan Kata Sandi App Center dengan kredensial dari akun App Center Anda.

Catatan

Nama pengguna App Center Anda ada di profil akun App Center Anda. Jika masuk menggunakan kredensial Microsoft Anda, siapkan akun Anda dengan kata sandi atau tugas tidak dapat masuk. Anda dapat menyiapkan kata sandi di App Center.

Appium

• Sebelum membuat uji coba, selesaikan langkah-langkah di bagian Sebelum Anda memulai panduan ini.
• Siapkan repositori Anda untuk Pengujian App Center, Pengujian Appium.

Konfigurasi Azure Pipelines untuk Appium

Mulailah dengan menambahkan tugas Uji App Center ke definisi build seperti yang dijelaskan sebelumnya di konfigurasi umum Azure Pipelines.

Di bagian Siapkan Pengujian, pastikan kotak centang Siapkan Pengujian dicentang, lalu untuk Kerangka Kerja Pengujian, pilih Kerangka Kerja Pengujian Appium. Masukkan jalur ke appium test-classes, dependency-jars, dan pom.xml file ke dalam bidang Build directory . Ketiga artefak ini biasanya ada di upload folder .

Sekarang Anda dapat mengonfigurasi uji coba. Semua informasi yang Anda butuhkan ditemukan dengan membuat pengujian baru di bawah Uji di App Center. Ikuti instruksi di Memulai Uji Coba. Biarkan halaman kirim (halaman terakhir pada penyiapan uji coba) terbuka, sehingga Anda dapat menggunakan informasi tersebut saat menyiapkan tugas Uji App Center.

appcenter test run appium --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir target/upload

• Pada halaman kirim, simpul aplikasi adalah --app parameter . Sisipkan ke dalam bidang App Slug .
• Pilihan perangkat adalah --devices parameter . Sisipkan ke dalam bidang Perangkat .
• Seri pengujian adalah bidang teks gratis - bisa apa saja. Ini parameternya --test-series .
• Bahasa Sistem adalah menu drop-down. Jika Lainnya dipilih, bidang Lokal Lain muncul di mana Anda bisa memasukkan kode bahasa dan negara seperti format ini: en_US.

Simpan konfigurasi dan Anda semua diatur untuk memulai build dan Eksekusi Pengujian App Center.

Espresso

• Sebelum membuat uji coba, selesaikan langkah-langkah di bagian Sebelum Anda memulai panduan ini.
• Baca cara menyiapkan repositori Anda untuk Pengujian App Center, pengujian Espresso.

Konfigurasi Azure Pipelines untuk Espresso

Mulailah dengan menambahkan tugas Uji App Center ke definisi build seperti yang dijelaskan sebelumnya di konfigurasi umum Azure Pipelines.

Di bagian Siapkan Pengujian, pastikan kotak centang Siapkan Pengujian dicentang, lalu untuk Kerangka Kerja Pengujian, pilih Kerangka Kerja Pengujian Espresso.

Sekarang Anda dapat mengonfigurasi uji coba. Semua informasi yang Anda butuhkan ditemukan dengan membuat pengujian baru di bawah Uji di App Center. Ikuti instruksi di Memulai Uji Coba. Biarkan halaman kirim (halaman terakhir pada penyiapan uji coba) terbuka, sehingga Anda dapat menggunakan informasi tersebut saat menyiapkan tugas Uji App Center.

appcenter test run espresso --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir pathToEspressoBuildFolder

• Pada halaman kirim, simpul aplikasi adalah --app parameter . Sisipkan ke dalam bidang App Slug .
• Pilihan perangkat adalah --devices parameter . Sisipkan ke dalam bidang Perangkat .
• Seri pengujian adalah bidang teks gratis - bisa apa saja. Ini parameternya --test-series .
• Bahasa Sistem adalah menu drop-down. Jika Lainnya dipilih, bidang Lokal Lain muncul di mana Anda bisa memasukkan kode bahasa dan negara seperti format ini: en_US.

Simpan konfigurasi dan Anda semua diatur untuk memulai build dan Eksekusi Pengujian App Center.

Xamarin.UITest

• Sebelum membuat uji coba, selesaikan langkah-langkah di bagian Sebelum Anda memulai panduan ini.
• Baca cara menyiapkan repositori Xamarin.Android Anda untuk Pengujian App Center, pengujian Xamarin.UITest.
• Baca cara menyiapkan repositori Xamarin.iOS Anda untuk Pengujian App Center, pengujian Xamarin.UITest.

Konfigurasi Azure Pipelines untuk Xamarin.UITest

Mulailah dengan menambahkan tugas Uji App Center ke definisi build seperti yang dijelaskan sebelumnya di konfigurasi umum Azure Pipelines.

Di bagian Siapkan Pengujian, pastikan kotak centang Siapkan Pengujian dicentang dan Uji UI Xamarin dipilih di bawah Kerangka Kerja Pengujian. Sisipkan jalur ke direktori build Anda; dalam kebanyakan kasus folder build adalah: <ProjectName>/bin/<configuration>.

Sekarang Anda dapat mengonfigurasi uji coba. Semua informasi yang Anda butuhkan ditemukan dengan membuat pengujian baru di bawah Uji di App Center. Ikuti instruksi di Memulai Uji Coba. Biarkan halaman kirim (halaman terakhir pada penyiapan uji coba) terbuka, sehingga Anda dapat menggunakan informasi tersebut saat menyiapkan tugas Uji App Center.

appcenter test run uitest --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir pathTUITestBuildDir

• Pada halaman kirim, simpul aplikasi adalah --app parameter . Sisipkan ke dalam bidang App Slug .
• Pilihan perangkat adalah --devices parameter . Sisipkan ke dalam bidang Perangkat .
• Seri pengujian adalah bidang teks gratis - bisa apa saja. Ini parameternya --test-series .
• Bahasa Sistem adalah menu drop-down. Jika Lainnya dipilih, bidang Lokal Lain muncul di mana Anda bisa memasukkan kode bahasa dan negara seperti format ini: en_US.

Simpan konfigurasi dan Anda semua diatur untuk memulai build dan Eksekusi Pengujian App Center.

XCUITest

• Sebelum membuat uji coba, selesaikan langkah-langkah di bagian Sebelum Anda memulai panduan ini.
• Baca cara menyiapkan repositori Anda untuk Pengujian App Center, pengujian XCUITest.

Catatan

Di alur Anda, sebelum tugas Uji App Center, Anda memerlukan langkah tugas Xcode dengan tindakan build-for-testing untuk membangun aplikasi runner pengujian yang diperlukan untuk pengujian. Dalam tugas itu, di bawah Argumen di bagian Tingkat Lanjut, tentukan jalur data turunan, biasanya menggunakan -derivedDataPath DerivedData . Anda juga akan memerlukan .ipa file untuk aplikasi Anda. Anda dapat membuat .ipa file dalam tugas Xcode build-for-testing yang sama dengan mencentang Create app package opsi, atau dalam langkah build Xcode terpisah atau dalam langkah skrip Bash.

Konfigurasi Azure Pipelines untuk XCUITest

Mulailah dengan menambahkan tugas Uji App Center ke definisi build seperti yang dijelaskan sebelumnya di konfigurasi umum Azure Pipelines.

Di bagian Siapkan Pengujian, pastikan kotak centang Siapkan Pengujian dicentang dan XCUITest dipilih di bawah Kerangka Kerja Pengujian. Sisipkan jalur ke direktori build Anda dari langkah Xcode build-for-testing . Biasanya, folder build adalah: DerivedData/Build/Products/Debug-iphoneos/.

Sekarang Anda dapat mengonfigurasi uji coba. Semua informasi yang Anda butuhkan ditemukan dengan membuat pengujian baru di bawah Uji di App Center. Ikuti instruksi di Memulai Uji Coba. Biarkan halaman kirim (halaman terakhir pada penyiapan uji coba) terbuka, sehingga Anda dapat menggunakan informasi tersebut saat menyiapkan tugas Uji App Center.

appcenter test run xcuitest --app "username/appname" --devices 209ed689 --test-series "main" --locale "en_US" --build-dir pathToXCUItestBuildFolder

• Pada halaman kirim, simpul aplikasi adalah --app parameter . Sisipkan ke dalam bidang App Slug .
• Pilihan perangkat adalah --devices parameter . Sisipkan ke dalam bidang Perangkat .
• Seri pengujian adalah bidang teks gratis - bisa apa saja. Ini parameternya --test-series .
• Bahasa Sistem adalah menu drop-down. Jika Lainnya dipilih, bidang Lokal Lain muncul di mana Anda bisa memasukkan kode bahasa dan negara seperti format ini: en_US.

Simpan konfigurasi dan Anda semua diatur untuk memulai build dan Eksekusi Pengujian App Center.