View a markdown version of this page

Migrazione degli ambienti di test personalizzati ai nuovi host di test iOS - AWS Device Farm
Tutorial: migrazione dei file delle specifiche di test iOS con la consoleDifferenze tra gli host di test nuovi e quelli precedenti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Migrazione degli ambienti di test personalizzati ai nuovi host di test iOS

Per l'elenco completo degli host di test disponibili e come selezionarne uno, consultaHost per ambienti di test personalizzati.

Per migrare i test esistenti dall'host legacy al nuovo host di test macOS, dovrai sviluppare nuovi file delle specifiche di test basati su quelli preesistenti.

L'approccio consigliato è iniziare con il file delle specifiche di test di esempio per i tipi di test desiderati, quindi migrare i comandi pertinenti dal vecchio file delle specifiche di test a quello nuovo. Ciò consente di sfruttare nuove funzionalità e ottimizzazioni delle specifiche di test di esempio per il nuovo host riutilizzando frammenti di codice esistente.

Tutorial: migrazione dei file delle specifiche di test iOS con la console

In questo esempio, la console Device Farm verrà utilizzata per integrare una specifica di test del dispositivo iOS esistente per utilizzare il nuovo host di test.

Passaggio 1: creazione di un nuovo file delle specifiche di test con la console

  1. Decidi quale host di test vuoi usare. Per l'elenco degli host di test iOS disponibili e come selezionarne uno, consultaHost per ambienti di test personalizzati.

  2. Accedi alla console AWS Device Farm.

  3. Accedi al progetto Device Farm contenente i test di automazione.

  4. Scarica una copia delle specifiche di test esistenti con cui desideri iniziare.

    1. Fai clic sull'opzione «Impostazioni del progetto» e vai alla scheda Caricamenti.

    2. Passa al file delle specifiche di test con cui desideri eseguire l'onboarding.

    3. Fai clic sul pulsante Download per creare una copia locale di questo file.

  5. Torna alla pagina del progetto e fai clic su Crea esecuzione.

  6. Compila le opzioni della procedura guidata come se dovessi iniziare una nuova esecuzione, ma fermati all'opzione Seleziona le specifiche del test.

  7. Utilizzando la specifica di test iOS selezionata per impostazione predefinita, fai clic sul pulsante Crea una specifica di test.

  8. Modifica la specifica di test selezionata per impostazione predefinita nell'editor di testo.

    1. Imposta ios_test_host l'host di test che soddisfa i tuoi requisiti di test. Ad esempio: 

      ios_test_host: macos_tahoe

    2. Dai un'occhiata alla copia delle specifiche di test scaricata in una fase precedente. phase

    3. Copia i comandi dalle fasi della vecchia specifica di test in ciascuna rispettiva fase della nuova specifica di test, ignorando i comandi relativi all'installazione o alla selezione di Java, Python, Ruby, Appium o Node.js Xcode.

  9. Inserisci un nuovo nome di file nella casella di testo Salva con nome.

  10. Fai clic sul pulsante Salva come nuovo per salvare le modifiche.

Per un esempio di file delle specifiche di test che puoi usare come riferimento, vedi l'esempio fornito inEsempi di specifiche di test.

Fase 2: Selezione del software preinstallato

Nel nuovo host di test, le versioni software preinstallate vengono selezionate utilizzando un nuovo strumento di gestione delle versioni standardizzato chiamato. devicefarm-cli Questo strumento è ora l'approccio consigliato per l'utilizzo dei vari software che forniamo sugli host di test.

Ad esempio, aggiungete la riga seguente per utilizzare JDK 25 nel vostro ambiente di test: 

- devicefarm-cli use java 25

Per ulteriori informazioni sul software supportato disponibile, consulta:. Software supportato all'interno di ambienti di test personalizzati

Passo 3: Utilizzo di Appium e delle sue dipendenze tramite gli strumenti di selezione del software

Seleziona esplicitamente la versione di Appium utilizzando. devicefarm-cli Sull'host macos_tahoe di test, Appium 3 è la versione predefinita: 

- devicefarm-cli use appium 3 # Selects the version
- appium --version            # Prints the version

La versione di Appium selezionata con devicefarm-cli viene preinstallata con una versione compatibile del driver XcuiTest per iOS.

Quando si utilizzano le specifiche di test predefinite, Device Farm seleziona automaticamente WebDriverAgent (WDA) in modo che corrisponda al driver XCUITest installato. Per ulteriori informazioni su come funziona questa selezione, vedere e. Selezione di una versione per i test iOS WebDriverAgent Variabili di ambiente per i test di Appium

Differenze tra gli host di test nuovi e quelli precedenti

Quando modifichi il file delle specifiche di test per utilizzare il nuovo host di test iOS e trasferisci i test dall'host di test precedente, tieni presente queste principali differenze di ambiente:

  • Versioni Xcode: nell'ambiente host di test precedente, la versione Xcode disponibile era basata sulla versione iOS del dispositivo utilizzato per i test. Ad esempio, i test sui dispositivi iOS 18 utilizzavano Xcode 16 nell'host precedente, mentre i test su iOS 17 utilizzavano Xcode 15. Nel nuovo ambiente host, tutti i dispositivi possono accedere alle stesse versioni di Xcode, consentendo un ambiente coerente per i test su dispositivi con versioni diverse. Per un elenco delle versioni Xcode attualmente disponibili, consulta. Software supportato

  • Selezione delle versioni del software: in molti casi, le versioni predefinite del software sono cambiate, quindi se prima non selezionavi esplicitamente la versione del software nell'host di test precedente, potresti volerla specificare ora nel nuovo host di test utilizzando. devicefarm-cli Nella maggior parte dei casi d'uso, consigliamo ai clienti di selezionare esplicitamente le versioni del software che utilizzano. Selezionando una versione del software, devicefarm-cli avrai un'esperienza prevedibile e coerente e riceverai numerosi avvisi nel caso in cui Device Farm intenda rimuovere quella versione dall'host di test.

    Inoltre, strumenti di selezione software comenvm, pyenv avm, e rvm sono stati rimossi a favore del nuovo devicefarm-cli sistema di selezione del software.

  • Versioni software disponibili: molte versioni del software precedentemente preinstallato sono state rimosse e sono state aggiunte molte nuove versioni. Quindi, assicurati che quando usi devicefarm-cli per selezionare le versioni del software, selezioni le versioni che sono nell'elenco delle versioni supportate.

  • La libimobiledevice suite di strumenti è stata rimossa a favore di strumenti più recenti e proprietari per tenere traccia degli attuali test dei dispositivi iOS e degli standard di settore. Per iOS 17 e versioni successive, puoi migrare la maggior parte dei comandi per utilizzare strumenti Xcode simili, chiamati. devicectl Per informazioni sudevicectl, è possibile eseguire xcrun devicectl help da una macchina su cui è installato Xcode.

  • I percorsi di file codificati nel file delle specifiche di test dell'host precedente come percorsi assoluti molto probabilmente non funzioneranno come previsto nel nuovo host di test e generalmente non sono consigliati per l'uso dei file delle specifiche di test. Ti consigliamo di utilizzare percorsi relativi e variabili di ambiente per tutto il codice del file delle specifiche di test. Per ulteriori informazioni, consulta l'argomento su. Le migliori pratiche per l'esecuzione di ambienti di test personalizzati

  • Versione e architettura del sistema operativo: gli host di test precedenti utilizzavano una varietà di versioni di macOS e architetture CPU in base al dispositivo assegnato. Di conseguenza, gli utenti potrebbero notare alcune differenze nelle librerie di sistema disponibili nell'ambiente. Per ulteriori informazioni sulla versione precedente del sistema operativo host, consultaHost di test iOS precedente.

  • Per gli utenti di Appium, la modalità di selezione WebDriverAgent è stata modificata utilizzando il prefisso della variabile di ambiente DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V anziché il vecchio prefisso. DEVICEFARM_WDA_DERIVED_DATA_PATH_V Per ulteriori informazioni sulla variabile aggiornata, consulta. Variabili di ambiente per i test di Appium

  • Per gli utenti di Appium Java, il nuovo host di test non contiene alcun file JAR preinstallato nel percorso di classe, mentre l'host precedente ne conteneva uno per il framework TestNG (tramite una variabile di ambiente). $DEVICEFARM_TESTNG_JAR Consigliamo ai clienti di impacchettare i file JAR necessari per i propri framework di test all'interno del pacchetto di test e di rimuovere le istanze della variabile dai file delle $DEVICEFARM_TESTNG_JAR specifiche di test.

Ti consigliamo di contattare il team di assistenza tramite un caso di supporto in caso di feedback o domande sulle differenze tra gli host di test dal punto di vista del software.