Tutorial: Membuat pipeline yang membangun dan menguji aplikasi Android Anda AWS Device Farm

Tambahkan dan komit file yang dipanggil buildspec.ymldi root kode aplikasi Anda, dan dorong ke repositori Anda. CodeBuild menggunakan file ini untuk menjalankan perintah dan mengakses artefak yang diperlukan untuk membangun aplikasi Anda.

version: 0.2

phases:
  build:
    commands:
      - chmod +x ./gradlew
      - ./gradlew assembleDebug
artifacts:
  files:
     - './android/app/build/outputs/**/*.apk'
  discard-paths: yes

(Opsional) Jika Anda menggunakan Calabash atau Appium untuk menguji aplikasi Anda, tambahkan file definisi pengujian ke repositori Anda. Pada langkah selanjutnya, Anda dapat mengonfigurasi Device Farm untuk menggunakan definisi untuk menjalankan rangkaian pengujian Anda.

Jika Anda menggunakan pengujian bawaan Device Farm, Anda dapat melewati langkah ini.

Untuk membuat pipeline dan menambahkan tahap sumber, lakukan hal berikut:

1. Masuk ke AWS Management Console dan buka CodePipeline konsol di https://console.aws.amazon.com/codepipeline/.

2. Pada halaman Selamat Datang, halaman Memulai, atau halaman Pipelines, pilih Buat pipeline.

3. Pada Langkah 1: Pilih halaman opsi pembuatan, di bawah Opsi pembuatan, pilih opsi Build custom pipeline. Pilih Berikutnya.

4. Pada Langkah 2: Pilih halaman pengaturan pipeline, dalam nama Pipeline, masukkan nama untuk pipeline Anda.

5. CodePipeline menyediakan pipa tipe V1 dan V2, yang berbeda dalam karakteristik dan harga. Jenis V2 adalah satu-satunya jenis yang dapat Anda pilih di konsol. Untuk informasi selengkapnya, lihat jenis pipa. Untuk informasi tentang harga CodePipeline, lihat Harga.

6. Dalam peran Layanan, biarkan peran layanan baru dipilih, dan biarkan nama Peran tidak berubah. Anda juga dapat memilih untuk menggunakan peran layanan yang ada, jika Anda memilikinya.

   catatan

   Jika Anda menggunakan peran CodePipeline layanan yang dibuat sebelum Juli 2018, Anda perlu menambahkan izin untuk Device Farm. Untuk melakukannya, buka konsol IAM, temukan peran, lalu tambahkan izin berikut ke kebijakan peran. Untuk informasi selengkapnya, lihat Menambahkan izin ke peran CodePipeline layanan.

   {
        "Effect": "Allow",
        "Action": [
           "devicefarm:ListProjects",
           "devicefarm:ListDevicePools",
           "devicefarm:GetRun",
           "devicefarm:GetUpload",
           "devicefarm:CreateUpload",
           "devicefarm:ScheduleRun"
        ],
        "Resource": "*"
   }

7. Biarkan pengaturan di bawah Pengaturan lanjutan pada defaultnya, lalu pilih Berikutnya.

8. Pada Langkah 3: Tambahkan halaman tahap sumber, di penyedia Sumber, pilih GitHub (melalui GitHub Aplikasi).

9. Di bawah Koneksi, pilih koneksi yang ada atau buat yang baru. Untuk membuat atau mengelola koneksi untuk tindakan GitHub sumber Anda, lihatGitHub koneksi.

10. Di Repositori, pilih repositori sumber.

11. Di Branch, pilih cabang yang ingin Anda gunakan.

12. Biarkan default yang tersisa untuk tindakan sumber. Pilih Berikutnya.

Pada Langkah 4: Tambahkan tahap build, tambahkan tahap build:

1. Di Penyedia pembangunan, pilih AWS CodeBuild. Izinkan Wilayah ke default ke Wilayah alur.

2. Pilih Buat proyek.

3. Di Nama proyek, masukkan nama untuk proyek pembangunan ini.

4. Di Citra lingkungan, pilih Citra terkelola. Untuk Sistem operasi, pilih Ubuntu.

5. Untuk Waktu aktif, pilih Standar. Untuk Gambar, pilih:5.0aws/codebuild/standard.

   CodeBuild menggunakan image OS ini, yang telah menginstal Android Studio, untuk membangun aplikasi Anda.

6. Untuk peran Layanan, pilih peran CodeBuild layanan yang ada atau buat yang baru.

7. Untuk spesifikasi Build, pilih Gunakan file buildspec.

8. Pilih Lanjutkan ke CodePipeline. Ini kembali ke CodePipeline konsol dan membuat CodeBuild proyek yang menggunakan buildspec.yml di repositori Anda untuk konfigurasi. Proyek build menggunakan peran layanan untuk mengelola Layanan AWS izin. Langkah ini mungkin memakan waktu beberapa menit.

9. Pilih Berikutnya.

Pada Langkah 5: Tambahkan tahap pengujian, pilih Lewati tahap pengujian, lalu terima pesan peringatan dengan memilih Lewati lagi.

Pilih Berikutnya.

Pada Langkah 6: Tambahkan halaman tahap penerapan, pilih Lewati tahap penerapan, lalu terima pesan peringatan dengan memilih Lewati lagi. Pilih Berikutnya.

Pada Langkah 7: Tinjau, pilih Buat pipeline. Anda akan melihat diagram yang menunjukkan sumber dan tahap build.

Tambahkan tindakan pengujian Device Farm ke pipeline Anda:

1. Di kanan atas, pilih Edit.

2. Di bagian bawah diagram, pilih + Tambahkan tahap. Dalam nama Panggung, masukkan nama, sepertiTest.

3. Pilih + Tambahkan grup tindakan.

4. Di Nama tindakan, masukkan nama.

5. Di penyedia Action, pilih AWS Device Farm. Izinkan Wilayah ke default ke Wilayah alur.

6. Dalam artefak Input, pilih artefak input yang cocok dengan artefak keluaran dari tahap yang datang sebelum tahap pengujian, seperti. BuildArtifact

   Di AWS CodePipeline konsol, Anda dapat menemukan nama artefak keluaran untuk setiap tahap dengan mengarahkan kursor ke ikon informasi di diagram pipa. Jika pipeline menguji aplikasi langsung dari tahap Sumber, pilih SourceArtifact. Jika pipeline menyertakan tahap Build, pilih BuildArtifact.

7. Masuk ProjectId, masukkan ID proyek Device Farm Anda. Gunakan langkah-langkah di awal tutorial ini untuk mengambil ID proyek Anda.

8. Masuk DevicePoolArn, masukkan ARN untuk kumpulan perangkat. Untuk mendapatkan kumpulan perangkat yang tersedia ARNs untuk proyek, termasuk ARN untuk Perangkat Teratas, gunakan AWS CLI untuk memasukkan perintah berikut:

   aws devicefarm list-device-pools --arn arn:aws:devicefarm:us-west-2:account_ID:project:project_ID

9. Masuk AppType, masukkan Android.

   Berikut ini adalah daftar nilai yang valid untuk AppType:

   • iOS

   • Android

   • Web

10. Di App, masukkan jalur paket aplikasi yang dikompilasi. Jalur relatif terhadap akar artefak input untuk tahap pengujian. Biasanya, jalur ini mirip denganapp-release.apk.

11. Masuk TestType, masukkan jenis pengujian Anda, lalu di Uji, masukkan jalur file definisi pengujian. Jalur relatif terhadap akar artefak input untuk pengujian Anda.

    Berikut ini adalah daftar nilai yang valid untuk TestType:

    • APPIUM_JAVA_JUNIT

    • APPIUM_JAVA_TESTNG

    • APPIUM_NODE

    • APPIUM_RUBY

    • APPIUM_PYTHON

    • APPIUM_WEB_JAVA_JUNIT

    • APPIUM_WEB_JAVA_TESTNG

    • APPIUM_WEB_NODE

    • APPIUM_WEB_RUBY

    • APPIUM_WEB_PYTHON

    • BUILTIN_FUZZ

    • INSTRUMENTASI

    • XCTEST

    • XCTEST_UI

    catatan

    Node lingkungan khusus tidak didukung.

12. Di bidang yang tersisa, berikan konfigurasi yang sesuai untuk pengujian dan jenis aplikasi Anda.

13. (Opsional) Di Advanced, berikan informasi konfigurasi untuk uji coba Anda.

14. Pilih Simpan.

15. Di panggung yang Anda edit, pilih Selesai. Di AWS CodePipeline panel, pilih Simpan, lalu pilih Simpan pada pesan peringatan.

16. Untuk mengirimkan perubahan dan memulai pembuatan pipeline, pilih Rilis perubahan, lalu pilih Rilis.