Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memigrasi lingkungan pengujian kustom Anda ke host uji iOS baru
Untuk memigrasikan pengujian yang ada dari host lama ke host pengujian macOS baru, Anda perlu mengembangkan file spesifikasi pengujian baru berdasarkan yang sudah ada sebelumnya.
Pendekatan yang disarankan adalah memulai dengan contoh file spesifikasi pengujian untuk jenis pengujian yang Anda inginkan, lalu memigrasikan perintah yang relevan dari file spesifikasi pengujian lama Anda ke yang baru. Ini memungkinkan Anda memanfaatkan fitur baru dan pengoptimalan contoh spesifikasi pengujian untuk host baru saat menggunakan kembali cuplikan kode Anda yang ada.
**Topics**
+ [Tutorial: Memigrasi file spesifikasi pengujian iOS dengan konsol](#ios-host-migration-console-tutorial)
+ [Perbedaan antara host uji baru dan lama](#ios-host-migration-differences)
## Tutorial: Memigrasi file spesifikasi pengujian iOS dengan konsol
Dalam contoh ini, konsol Device Farm akan digunakan untuk onboard spesifikasi pengujian perangkat iOS yang ada untuk menggunakan host pengujian baru.
### Langkah 1: Membuat file spesifikasi pengujian baru dengan konsol
1. Masuk ke [konsol AWS Device Farm](https://console.aws.amazon.com/devicefarm).
1. Arahkan ke proyek Device Farm yang berisi pengujian otomatisasi Anda.
1. Unduh salinan spesifikasi pengujian yang ada yang ingin Anda ikuti.
1. Klik opsi “Pengaturan Proyek” dan arahkan ke tab **Unggahan**.
1. Arahkan ke file spesifikasi pengujian yang ingin Anda gunakan.
1. Klik tombol **Unduh** untuk membuat salinan lokal file ini.
1. Arahkan kembali ke halaman Project dan klik **Create run**.
1. Isi opsi pada wizard seolah-olah Anda akan memulai proses baru, tetapi berhenti di opsi **Pilih spesifikasi pengujian**.
1. Menggunakan spesifikasi pengujian iOS yang dipilih secara default, klik tombol **Buat spesifikasi pengujian**.
1. Ubah spesifikasi pengujian yang dipilih *secara default* di editor teks.
1. Jika belum ada, ubah file spesifikasi pengujian untuk memilih host baru menggunakan:
```
ios_test_host: macos_sequoia
```
1. Dari salinan spesifikasi pengujian Anda yang diunduh pada langkah sebelumnya, tinjau masing-masing` phase`.
1. Salin perintah dari fase spesifikasi pengujian lama ke setiap fase masing-masing dalam spesifikasi pengujian baru, mengabaikan perintah yang terkait dengan menginstal atau memilih Java, Python, Node.js, Ruby, Appium, atau Xcode.
1. Masukkan nama file baru di kotak teks **Simpan sebagai**.
1. Klik tombol **Simpan sebagai baru** untuk menyimpan perubahan Anda.
Untuk contoh file spesifikasi pengujian yang dapat Anda gunakan sebagai referensi, lihat contoh yang disediakan di[Contoh spesifikasi uji](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example).
### Langkah 2: Memilih perangkat lunak pra-instal perangkat lunak
Di host uji baru, versi perangkat lunak pra-instal dipilih menggunakan alat manajemen versi standar baru yang disebut. `devicefarm-cli` Perkakas ini sekarang merupakan pendekatan yang direkomendasikan untuk menggunakan berbagai perangkat lunak yang kami sediakan pada host uji.
Sebagai contoh, Anda akan menambahkan baris berikut untuk menggunakan JDK 17 yang berbeda lingkungan pengujian Anda:
```
- devicefarm-cli use java 17
```
Untuk informasi lebih lanjut tentang perangkat lunak yang didukung tersedia, silakan tinjau:[Perangkat lunak yang didukung dalam lingkungan pengujian khusus](custom-test-environments-hosts-software.md).
### Langkah 3: Menggunakan Appium dan dependensinya melalui alat pemilihan perangkat lunak
Host uji baru hanya mendukung Appium 2.x ke atas. Harap secara eksplisit pilih versi Appium menggunakan`devicefarm-cli`, sambil menghapus alat lama seperti. ` avm` Contoh:
```
# This line using 'avm' should be removed
# - avm 2.3.1
# And the following lines should be added
- devicefarm-cli use appium 2 # Selects the version
- appium --version # Prints the version
```
Versi Appium yang dipilih `devicefarm-cli` dilengkapi dengan prainstal dengan versi driver yang kompatibel XCUITest untuk iOS.
Selain itu, Anda perlu memperbarui spesifikasi pengujian Anda untuk digunakan ` DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9` alih-alih. ` DEVICEFARM_WDA_DERIVED_DATA_PATH` Variabel lingkungan baru menunjuk ke versi pra-bangun WebDriverAgent 9.x, yang merupakan versi terbaru yang didukung untuk pengujian Appium 2.
Untuk informasi lebih lanjut, tinjau [Memilih WebDriverAgent versi untuk pengujian iOS](test-types-appium.md#test-types-appium-select-wda) dan[Variabel lingkungan untuk tes Appium](custom-test-environment-variables.md#custom-test-environment-variables-appium).
## Perbedaan antara host uji baru dan lama
Saat mengedit file spesifikasi pengujian untuk menggunakan host uji iOS baru dan mentransisikan pengujian Anda dari host pengujian lama, perhatikan perbedaan lingkungan utama berikut:
+ **Versi Xcode:** Di lingkungan host uji lama, versi Xcode yang tersedia didasarkan pada versi iOS perangkat yang digunakan untuk pengujian. Misalnya, pengujian pada perangkat iOS 18 menggunakan Xcode 16 di host lama, sedangkan pengujian di iOS 17 menggunakan Xcode 15. Di lingkungan host baru, semua perangkat dapat mengakses versi Xcode yang sama, memungkinkan lingkungan yang konsisten untuk pengujian pada perangkat dengan versi berbeda. Untuk daftar versi Xcode yang tersedia saat ini, lihat[Perangkat lunak yang didukung](custom-test-environments-hosts-software.md).
+ **Memilih versi perangkat lunak:** Dalam banyak kasus, versi perangkat lunak default telah berubah, jadi jika Anda tidak secara eksplisit memilih versi perangkat lunak Anda di host uji lama sebelumnya, Anda mungkin ingin menentukannya sekarang di host uji baru menggunakan. [`devicefarm-cli`](custom-test-environments-hosts-software-cli.md) Dalam sebagian besar kasus penggunaan, kami menyarankan agar pelanggan secara eksplisit memilih versi perangkat lunak yang mereka gunakan. Dengan memilih versi perangkat lunak, `devicefarm-cli` Anda akan memiliki pengalaman yang dapat diprediksi dan konsisten dengannya dan menerima banyak peringatan jika Device Farm berencana untuk menghapus versi tersebut dari host pengujian.
Selain itu, alat pemilihan perangkat lunak seperti `nvm` `pyenv`` avm`,,, dan `rvm` telah dihapus demi sistem pemilihan ` devicefarm-cli` perangkat lunak baru.
+ **Versi perangkat lunak yang tersedia:** Banyak versi perangkat lunak pra-instal sebelumnya telah dihapus, dan banyak versi baru telah ditambahkan. Jadi, pastikan bahwa ketika menggunakan `devicefarm-cli` untuk memilih versi perangkat lunak Anda, Anda memilih versi yang ada dalam [daftar versi yang didukung](custom-test-environments-hosts-software.md).
+ **`libimobiledevice`Rangkaian alat telah dihapus** demi perkakas yang lebih baru/pihak pertama untuk melacak pengujian perangkat iOS saat ini dan standar industri. Untuk iOS 17 ke atas, Anda dapat memigrasikan sebagian besar perintah untuk menggunakan perkakas Xcode serupa, yang disebut. `devicectl` Untuk informasi tentang`devicectl`, Anda dapat menjalankan `xcrun devicectl help` dari mesin dengan Xcode diinstal.
+ **Jalur file yang dikodekan keras** dalam file spesifikasi pengujian host lama Anda sebagai jalur absolut kemungkinan besar tidak akan berfungsi seperti yang diharapkan di host pengujian baru, dan umumnya tidak direkomendasikan untuk penggunaan file spesifikasi pengujian. Kami menyarankan Anda menggunakan jalur relatif dan variabel lingkungan untuk semua kode file spesifikasi pengujian. Untuk informasi lebih lanjut, tinjau topik di[Praktik terbaik untuk eksekusi lingkungan pengujian kustom](custom-test-environments-best-practices.md).
+ **Versi dan arsitektur sistem operasi:** Host uji lama menggunakan berbagai versi macOS dan arsitektur CPU berdasarkan perangkat yang ditetapkan. Akibatnya, pengguna mungkin melihat beberapa perbedaan dalam pustaka sistem yang tersedia yang tersedia di lingkungan. Untuk informasi lebih lanjut tentang versi OS host sebelumnya, tinjau[Host uji iOS lama](custom-test-environments-hosts-ios.md#legacy-ios-host).
+ **Untuk pengguna Appium**, cara memilih WebDriverAgent telah berubah menjadi awalan variabel lingkungan penggunaan ` DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V` alih-alih awalan lama. ` DEVICEFARM_WDA_DERIVED_DATA_PATH_V` Untuk informasi lebih lanjut tentang variabel yang diperbarui, tinjau[Variabel lingkungan untuk tes Appium](custom-test-environment-variables.md#custom-test-environment-variables-appium).
+ **Untuk pengguna Appium Java**, host uji baru tidak berisi file JAR pra-instal di jalur kelasnya, sedangkan host sebelumnya berisi satu untuk kerangka TestNG (melalui variabel lingkungan). `$DEVICEFARM_TESTNG_JAR` Kami menyarankan agar pelanggan mengemas file JAR yang diperlukan untuk kerangka kerja pengujian mereka di dalam paket pengujian mereka dan menghapus instance `$DEVICEFARM_TESTNG_JAR` variabel dari file spesifikasi pengujian mereka.
Kami merekomendasikan untuk menghubungi tim layanan melalui kasus dukungan jika Anda memiliki umpan balik atau pertanyaan tentang perbedaan antara host uji dari perspektif perangkat lunak.