Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengintegrasikan XCTest UI untuk iOS dengan Device Farm
Device Farm menyediakan dukungan untuk framework pengujian XCTest UI. [Secara khusus, Device Farm mendukung pengujian XCTest UI yang ditulis dalam Objective-C dan Swift.](https://developer.apple.com/swift/)
Kerangka kerja XCTest UI memungkinkan pengujian UI dalam pengembangan iOS, dibangun di atasnya XCTest. Untuk informasi selengkapnya, lihat [Pengujian Antarmuka Pengguna](https://developer.apple.com/library/prerelease/ios/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/09-ui_testing.html#//apple_ref/doc/uid/TP40014132-CH13-SW1) di Pustaka Pengembang iOS.
Untuk informasi umum tentang pengujian di Device Farm, lihat[Uji kerangka kerja dan pengujian bawaan di AWS Device Farm](test-types.md).
Gunakan petunjuk berikut untuk mengintegrasikan Device Farm dengan framework pengujian XCTest UI untuk iOS.
**Topics**
+ [Siapkan pengujian XCTest UI iOS Anda](#test-types-ios-xctest-ui-prepare)
+ [Opsi 1: Membuat XCTest paket.ipa UI](#how-to-use-create-XCTestUI-ipa-package)
+ [Opsi 2: Membuat paket XCTest UI.zip](#how-to-use-create-XCTestUI-zip-package)
+ [Unggah pengujian XCTest UI iOS Anda](#test-types-ios-xctest-ui-upload)
## Siapkan pengujian XCTest UI iOS Anda
Anda dapat mengunggah `.ipa` file atau `.zip` file untuk paket pengujian XCTEST\_UI Anda.
`.ipa`File adalah arsip aplikasi yang berisi aplikasi iOS Runner dalam format bundel. *File tambahan tidak dapat disertakan di dalam `.ipa` file.*
Jika Anda mengunggah `.zip` file, file tersebut dapat berisi aplikasi iOS Runner secara langsung atau `.ipa` file. Anda juga dapat menyertakan file lain dalam `.zip` file jika Anda ingin menggunakannya selama pengujian. Misalnya Anda dapat menyertakan file seperti`.xctestrun`, `.xcworkspace` atau `.xcodeproj` di dalam `.zip` file untuk menjalankan Rencana Uji XCUI di peternakan perangkat. Instruksi terperinci tentang cara menjalankan Rencana Uji tersedia di file spesifikasi pengujian default untuk jenis Uji XCUI.
## Opsi 1: Membuat XCTest paket.ipa UI
Bundel *yourAppName*UITest-Runner.app diproduksi oleh Xcode saat Anda membangun proyek untuk pengujian. Hal ini dapat ditemukan di direktori Produk untuk proyek Anda.
Untuk membuat file.ipa:
1. Buat direktori yang disebut{{Payload}}.
1. Tambahkan direktori aplikasi Anda ke direktori Payload.
1. Arsipkan direktori Payload ke dalam `.zip` file dan kemudian ubah ekstensi file menjadi`.ipa`.
Struktur folder berikut menunjukkan bagaimana contoh aplikasi bernama {{my-project-nameUITest-Runner.app}} akan dikemas sebagai `.ipa` file:
```
.
└── my-project-nameUITest.ipa
└── Payload (directory)
└── my-project-nameUITest-Runner.app
```
## Opsi 2: Membuat paket XCTest UI.zip
Device Farm secara otomatis menghasilkan `.xctestrun` file untuk Anda untuk menjalankan rangkaian pengujian XCTest UI lengkap Anda. Jika Anda ingin menggunakan `.xctestrun` file Anda sendiri di Device Farm, Anda dapat mengompres `.xctestrun` file dan direktori aplikasi menjadi `.zip` file. Jika Anda sudah memiliki `.ipa` file untuk paket pengujian Anda, Anda dapat memasukkannya di sini alih-alih{{\*-Runner.app}}.
```
.
└── swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
├── SampleTestPlan_2.xctestrun
├── SampleTestPlan_1.xctestrun
└── (any other files)
```
Jika Anda ingin menjalankan rencana pengujian Xcode untuk pengujian XCUI di Device Farm, Anda dapat membuat zip yang berisi file *my-project-nameUITest-Runner.app **atau my-project-name** *UITest.ipa** dan file kode sumber xcode yang diperlukan untuk menjalankan XCTEST\_UI dengan rencana pengujian, termasuk file atau file. `.xcworkspace` `.xcodeproj`
Berikut adalah contoh zip menggunakan `.xcodeproj` file:
```
.
└── swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
├── (any directory)
└── {{SampleXcodeProject.xcodeproj}}
├── Testplan_1.xctestplan
├── Testplan_2.xctestplan
└── (any other source code files created by xcode with .xcodeproj)
```
Berikut adalah contoh zip menggunakan `.xcworkspace` file:
```
.
└──swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
└── (any directory)
│ ├── SampleXcodeProject.xcodeproj
│ ├── Testplan_1.xctestplan
│ ├── Testplan_2.xctestplan
| └── (any other source code files created by xcode with .xcodeproj)
└── {{SampleWorkspace.xcworkspace}}
└── contents.xcworkspacedata
```
**catatan**
Harap pastikan bahwa Anda tidak memiliki direktori bernama “Payload” di dalam paket XCTest UI.zip Anda.
## Unggah pengujian XCTest UI iOS Anda
Gunakan konsol Device Farm untuk mengunggah pengujian Anda.
1. Masuk ke konsol Device Farm di [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).
1. Pada panel navigasi Device Farm, pilih **Pengujian Perangkat Seluler**, lalu pilih **Proyek**.
1. Dalam daftar proyek, pilih proyek yang ingin Anda unggah pengujian.
**Tip**
Anda dapat menggunakan bilah pencarian untuk memfilter daftar proyek berdasarkan nama.
Untuk membuat proyek, ikuti instruksi di [Membuat proyek di AWS Device Farm](how-to-create-project.md)
1. Pilih **Buat jalankan**.
1. Di bawah **Run settings**, di bagian **Run type**, pilih **iOS app**.
1. Di bawah **Pilih aplikasi**, di bagian **Opsi pemilihan aplikasi**, pilih **Unggah aplikasi sendiri**. Kemudian, pilih **Pilih file** di bawah **Unggah aplikasi**.
1. Jelajahi dan pilih file aplikasi iOS Anda. File harus berupa file.ipa.
**catatan**
Pastikan file.ipa Anda dibuat untuk perangkat iOS dan bukan untuk simulator.
1. Di bawah **Configure test**, di bagian **Select test framework**, pilih **XCTest UI**. Kemudian, pilih **Pilih file** di bawah **Unggah aplikasi**.
1. Jelajahi dan pilih file.ipa atau.zip yang berisi runner uji XCTest UI iOS Anda.
1. Selesaikan langkah-langkah yang tersisa dalam proses pembuatan run. Anda akan memilih perangkat yang ingin Anda uji dan secara opsional menentukan konfigurasi tambahan.
1. Pilih **Buat jalankan**. Device Farm menjalankan pengujian Anda dan menunjukkan hasilnya di konsol.