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à. # Host per ambienti di test personalizzati Device Farm supporta una serie di sistemi operativi con software preconfigurato tramite l'uso di un ambiente host di test. Durante l'esecuzione del test, Device Farm utilizza istanze (host) gestite da Amazon che si connettono dinamicamente al dispositivo selezionato in fase di test. Questa istanza viene completamente ripulita e non riutilizzata tra un'esecuzione e l'altra e viene terminata con gli artefatti generati al termine dell'esecuzione del test. **Topics** + [Host di test disponibili per ambienti di test personalizzati](#custom-test-environments-hosts-available) + [Selezione di un host di test per ambienti di test personalizzati](#test-host-selection) + [Software supportato in ambienti di test personalizzati](custom-test-environments-hosts-software.md) + [Ambiente di test per dispositivi Android](custom-test-environments-hosts-android.md) + [Ambiente di test per dispositivi iOS](custom-test-environments-hosts-ios.md) ## Host di test disponibili per ambienti di test personalizzati Gli host di test sono completamente gestiti da Device Farm. La tabella seguente elenca gli host di test Device Farm attualmente disponibili e supportati per ambienti di test personalizzati. | Piattaforma del dispositivo | Host di test | Sistema operativo | Architettura/e | Dispositivi supportati | | --- | --- | --- | --- | --- | | Android | amazon\$1linux\$12 | Amazon Linux 2 | x86\$164 | Android6 e versioni successive | | iOS | macos\$1sequoia | macOS Sequoia(versione 15) | arm64 | iOSda 15 a 26 | **Nota** Periodicamente, Device Farm aggiunge nuovi host di test per una piattaforma di dispositivi per supportare le versioni più recenti del sistema operativo del dispositivo e le relative dipendenze. Quando ciò si verifica, gli host di test precedenti per la rispettiva piattaforma di dispositivi sono soggetti alla fine del supporto. ### Versione del sistema operativo Ogni host di test disponibile utilizza una versione specifica del sistema operativo supportata in quel momento da Device Farm. Sebbene cerchiamo di utilizzare la versione più recente del sistema operativo, questa potrebbe non essere l'ultima versione distribuita pubblicamente disponibile. Device Farm aggiornerà periodicamente il sistema operativo con aggiornamenti di versione minori e patch di sicurezza. Per conoscere la versione specifica (inclusa la versione secondaria) del sistema operativo in uso durante l'esecuzione del test, puoi aggiungere il seguente frammento di codice a qualsiasi fase del file delle specifiche di test. **Example** ``` phases: install: commands: # The following example prints the instance's operating system version details - |- if [[ "Darwin" == "$(uname)" ]]; then echo "$(sw_vers --productName) $(sw_vers --productVersion) ($(sw_vers --buildVersion))"; else echo "$(. /etc/os-release && echo $PRETTY_NAME) ($(uname -r))"; fi ``` ## Selezione di un host di test per ambienti di test personalizzati Puoi specificare l'host di test Android e iOS nelle `ios_test_host` variabili appropriate `android_test_host` del [file delle specifiche di test](custom-test-environment-test-spec.md#custom-test-environment-test-spec-syntax). Se non si specifica una selezione di host di test per una determinata piattaforma di dispositivi, i test verranno eseguiti sull'host di test che Device Farm ha impostato come predefinito per il dispositivo e la configurazione di test specificati. **Importante** Durante i test su iOS 18 e versioni precedenti, verrà utilizzato un host di test legacy quando non è selezionato un host. Per ulteriori informazioni, consulta l'argomento su[Host di test iOS legacy](custom-test-environments-hosts-ios.md#legacy-ios-host). Ad esempio, esamina il seguente frammento di codice: **Example** ``` version: 0.1 android_test_host: amazon_linux_2 ios_test_host: macos_sequoia phases: # ... ``` # Software supportato in ambienti di test personalizzati Device Farm utilizza macchine host preinstallate con molte delle librerie software necessarie per eseguire i framework di test supportati dal nostro servizio, fornendo un ambiente di test pronto all'avvio. Device Farm supporta più lingue tramite l'uso del nostro meccanismo di selezione del software e aggiornerà periodicamente le versioni delle lingue incluse nell'ambiente. Per qualsiasi altro software richiesto, puoi modificare il file delle specifiche di test per installarlo dal tuo pacchetto di test, scaricarlo da Internet o accedere a fonti private all'interno del tuo VPC (vedi [VPC](https://docs.aws.amazon.com//devicefarm/latest/developerguide/vpc-eni.html) ENI per ulteriori informazioni). Per ulteriori informazioni, consulta [Esempi di specifiche di test](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example). ## Software preconfigurato Per facilitare il test dei dispositivi su ciascuna piattaforma, sull'host di test sono disponibili i seguenti strumenti: | Tools (Strumenti) | Piattaforme per dispositivi | | --- | --- | | Android SDK Build-Tools | Android | | Android SDK Platform-Tools(include`adb`) | Android | | Xcode | iOS | ## Software selezionabile Oltre al software preconfigurato sull'host, Device Farm offre un modo per selezionare determinate versioni del software supportato tramite gli `devicefarm-cli` strumenti. La tabella seguente contiene il software selezionabile e gli host di test che li contengono. | Software/Strumento | Host che supportano questo software | Comando da utilizzare nelle specifiche di test | | --- | --- | --- | | Java 17 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 17` | | Java 11 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 11` | | Java 8 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 8` | | Node.js 20 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use node 20` | | Node.js 18 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use node 18` | | Node.js 16 | amazon\$1linux\$12 | `devicefarm-cli use node 16` | | Python 3.11 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.11` | | Python 3.10 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.10` | | Python 3.9 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.9` | | Python 3.8 | amazon\$1linux\$12 | `devicefarm-cli use python 3.8` | | Ruby 3.2 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use ruby 3.2` | | Ruby 2.7 | amazon\$1linux\$12 | `devicefarm-cli use ruby 2.7` | | Appium 3 | amazon\$1linux\$12 | `devicefarm-cli use appium 3` | | Appium 2 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use appium 2` | | Appium 1 | amazon\$1linux\$12 | `devicefarm-cli use appium 1` | | Xcode 26 | macos\$1sequoia | `devicefarm-cli use xcode 26` | | Xcode 16 | macos\$1sequoia | `devicefarm-cli use xcode 16` | L'host di test include anche strumenti di supporto di uso comune per ogni versione del software, come i `pip` gestori di `npm` pacchetti (inclusi rispettivamente in Python e Node.js) e le dipendenze (come il UIAutomator2 driver Appium) per strumenti come Appium. Ciò garantisce di disporre degli strumenti necessari per lavorare con i framework di test supportati. # Utilizzo dello strumento devicefarm-cli in ambienti di test personalizzati L'host di test utilizza uno strumento di gestione delle versioni standardizzato chiamato a selezionare le versioni del software. ` devicefarm-cli` Questo strumento è separato dall'host di test Device Farm AWS CLI ed è disponibile solo sull'host di test Device Farm. Con`devicefarm-cli`, è possibile passare a qualsiasi versione software preinstallata sull'host di test. Ciò offre un modo semplice per mantenere il file delle specifiche di test di Device Farm nel tempo e offre un meccanismo prevedibile per aggiornare le versioni del software in futuro. **Importante** Questo strumento da riga di comando non è disponibile sugli host iOS precedenti. Per ulteriori informazioni, consulta l'argomento su[Host di test iOS legacy](custom-test-environments-hosts-ios.md#legacy-ios-host). Il frammento seguente mostra la `help` pagina di: `devicefarm-cli` ``` $ devicefarm-cli help Usage: devicefarm-cli COMMAND [ARGS] Commands: help Prints this usage message. list Lists all versions of software configurable via this CLI. use Configures the software for usage within the current shell's environment. ``` Esaminiamo un paio di esempi di utilizzo di. `devicefarm-cli` Per utilizzare lo strumento per modificare la versione di Python da *3.10* a *3.9* nel file delle specifiche di test, esegui i seguenti comandi: ``` $ python --version Python 3.10.12 $ devicefarm-cli use python 3.9 $ python --version Python 3.9.17 ``` Per cambiare la versione di Appium da a: *1* *2* ``` $ appium --version 1.22.3 $ devicefarm-cli use appium 2 $ appium --version 2.1.2 ``` **Suggerimento** Nota che quando selezioni una versione del software, cambia `devicefarm-cli` anche gli strumenti di supporto per quei linguaggi, come `pip` Python `npm` e NodeJS. Per ulteriori informazioni sul software preinstallato sull'host di test, consulta. [Software supportato in ambienti di test personalizzati](custom-test-environments-hosts-software.md) # Ambiente di test per dispositivi Android AWS Device Farm utilizza macchine host Amazon Elastic Compute Cloud (EC2) che eseguono Amazon Linux 2 per eseguire test Android. Quando pianifichi un'esecuzione di test, Device Farm assegna un host dedicato per ciascun dispositivo per eseguire i test in modo indipendente. Le macchine host si interrompono dopo l'esecuzione del test insieme a tutti gli artefatti generati. L'host Amazon Linux 2 offre diversi vantaggi: + **Test più veloci e affidabili**: rispetto all'host precedente, il nuovo host di test migliora significativamente la velocità dei test, in particolare riducendo i tempi di inizio dei test. L'host Amazon Linux 2 dimostra inoltre una maggiore stabilità e affidabilità durante i test. + **Accesso remoto avanzato per i test manuali**: gli aggiornamenti all'host di test più recente e i miglioramenti comportano una minore latenza e migliori prestazioni video per i test manuali Android. + **Selezione della versione software standard**: Device Farm ora standardizza il supporto dei principali linguaggi di programmazione sull'host di test e sulle versioni del framework Appium. Per i linguaggi supportati (attualmente Java, Python, Node.js e Ruby) e Appium, il nuovo host di test fornisce versioni stabili a lungo termine subito dopo il lancio. La gestione centralizzata delle versioni tramite `devicefarm-cli` lo strumento consente lo sviluppo di file con specifiche di test con un'esperienza coerente tra i framework. **Topics** + [Intervalli IP supportati per l'ambiente di test Amazon Linux 2 in Device Farm](amazon-linux-2-ip-ranges.md) # Intervalli IP supportati per l'ambiente di test Amazon Linux 2 in Device Farm I clienti spesso hanno bisogno di conoscere l'intervallo di IP da cui proviene il traffico di Device Farm, in particolare per configurare i firewall e le impostazioni di sicurezza. Per gli host di test Amazon EC2, l'intervallo IP comprende l'intera regione. `us-west-2` Per gli host di test di Amazon Linux 2, che è l'opzione predefinita per le nuove esecuzioni di Android, gli intervalli sono stati limitati. Il traffico ora proviene da un set specifico di gateway NAT, limitando l'intervallo IP ai seguenti indirizzi: **** | Intervalli IP | | --- | | **44.236.137,143** | | **5213,151,44** | | **5235,189,1991** | | **54201.250,26** | Per ulteriori informazioni sugli ambienti di test Android in Device Farm, consulta[Ambiente di test per dispositivi Android](custom-test-environments-hosts-android.md). # Ambiente di test per dispositivi iOS Device Farm utilizza istanze macOS (host) gestite da Amazon che si connettono dinamicamente al dispositivo iOS durante l'esecuzione del test. Ogni host è preconfigurato con un software che consente il test dei dispositivi su varie piattaforme di test popolari, come UI e Appium. XCTest L'attuale iterazione dell'host di test iOS ha migliorato l'esperienza di test rispetto alle versioni precedenti, tra cui: + **Sistema operativo host e strumenti coerenti per iOS 15 e iOS 26** In precedenza, l'host di test veniva determinato dal dispositivo in uso, il che portava a un ambiente software frammentato durante l'esecuzione su più versioni di iOS. L'esperienza attuale consente una semplice selezione dell'host per consentire un ambiente coerente su tutti i dispositivi. Ciò consentirà di rendere disponibili la stessa versione e gli stessi strumenti di macOS (come Xcode) su ogni dispositivo iOS. + **Miglioramenti delle prestazioni per i test di iOS 15 e 16** Utilizzando un'infrastruttura aggiornata, i tempi di configurazione sono notevolmente migliorati per i test di iOS 15 e 16. + **Versioni software selezionabili standardizzate per le dipendenze supportate** Ora disponiamo del sistema di selezione del `devicefarm-cli` software sugli host di test iOS e Android, che consente di selezionare la versione preferita delle nostre dipendenze supportate. Per le dipendenze supportate (come Java, Python, Node.js, Ruby e Appium), le versioni saranno selezionabili tramite le specifiche di test. Per un'idea di come funziona questa funzionalità, consulta l'argomento su. [Software supportato in ambienti di test personalizzati](custom-test-environments-hosts-software.md) **Importante** Se esegui su iOS 18 e versioni precedenti, i test verranno eseguiti su host di test legacy per impostazione predefinita. Consulta l'argomento seguente su come migrare da host legacy. ## Host di test iOS legacy Per i test esistenti su iOS 18 e versioni precedenti, gli host di test legacy sono selezionati per impostazione predefinita per gli ambienti di test personalizzati. La tabella seguente contiene la versione dell'host di test eseguita con la versione del dispositivo iOS. | Sistema operativo | Architettura/e | Impostazione predefinita per i dispositivi | | --- | --- | --- | | macOS Sonoma(versione 14) | arm64 | iOS 18 | | macOS Ventura(versione 13) | arm64 | iOS 17 | | macOS Monterey(versione 12) | x86\$164 | iOS 16e di seguito | Per selezionare gli host di test più recenti, consulta l'argomento relativo[Migrazione degli ambienti di test personalizzati ai nuovi host di test iOS](ios-host-migration.md). ## Software supportato per dispositivi iOS Per supportare i test dei dispositivi iOS, gli host di test Device Farm per dispositivi iOS sono preconfigurati con Xcode e gli strumenti a riga di comando associati. Per altri software disponibili, consulta l'argomento relativo. [Software supportato in ambienti di test personalizzati](custom-test-environments-hosts-software.md) # Migrazione degli ambienti di test personalizzati ai nuovi host di test iOS Per migrare i test esistenti dall'host legacy al nuovo host di test macOS, dovrai sviluppare nuovi file di specifiche di test basati su quelli preesistenti. L'approccio consigliato consiste nell'iniziare con il file di test spec 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 le nuove funzionalità e ottimizzazioni delle specifiche di test di esempio per il nuovo host riutilizzando al contempo gli snippet del codice esistente. **Topics** + [Tutorial: migrazione dei file delle specifiche di test iOS con la console](#ios-host-migration-console-tutorial) + [Differenze tra gli host di test nuovi e quelli precedenti](#ios-host-migration-differences) ## Tutorial: migrazione dei file delle specifiche di test iOS con la console In questo esempio, la console Device Farm verrà utilizzata per integrare le specifiche di test di un dispositivo iOS esistente per utilizzare il nuovo host di test. ### Passaggio 1: creazione di nuovi file delle specifiche di test con la console 1. Accedi alla [console AWS Device Farm](https://console.aws.amazon.com/devicefarm). 1. Vai al progetto Device Farm contenente i tuoi test di automazione. 1. Scarica una copia delle specifiche di test esistenti che desideri utilizzare. 1. Fai clic sull'opzione «Impostazioni del progetto» e vai alla scheda **Caricamenti**. 1. Vai al file delle specifiche di test con cui desideri effettuare l'onboarding. 1. Fai clic sul pulsante **Download** per creare una copia locale di questo file. 1. Torna alla pagina del progetto e fai clic su **Crea esegui**. 1. Compila le opzioni della procedura guidata come se dovessi iniziare una nuova esecuzione, ma fermati all'**opzione Select test spec**. 1. Utilizzando la specifica di test iOS selezionata per impostazione predefinita, fai clic sul pulsante **Crea una specifica di test**. 1. Modifica la specifica del test selezionata per *impostazione predefinita nell'editor* di testo. 1. Se non è già presente, modifica il file delle specifiche di test per selezionare il nuovo host utilizzando: ``` ios_test_host: macos_sequoia ``` 1. Dalla copia delle specifiche di test scaricata in un passaggio precedente, esaminale ciascuna. ` phase` 1. 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, Node.js, Ruby, Appium o Xcode. 1. **Immettete un nuovo nome di file nella casella di testo Salva come.** 1. Fai clic sul pulsante **Salva come nuovo** per salvare le modifiche. Per un esempio di file di specifiche di test che puoi usare come riferimento, vedi l'esempio fornito in[Esempi di specifiche di test](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example). ### 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, dovresti aggiungere la riga seguente per utilizzare un JDK 17 diverso nel tuo ambiente di test: ``` - devicefarm-cli use java 17 ``` Per ulteriori informazioni sul software supportato disponibile, consulta:. [Software supportato in ambienti di test personalizzati](custom-test-environments-hosts-software.md) ### Passo 3: Utilizzo di Appium e delle sue dipendenze tramite gli strumenti di selezione del software Il nuovo host di test supporta solo Appium 2.x e versioni successive. Seleziona esplicitamente la versione di Appium utilizzando`devicefarm-cli`, rimuovendo strumenti legacy come. ` avm` Esempio: ``` # 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 ``` La versione Appium selezionata con `devicefarm-cli` viene preinstallata con una versione compatibile del driver XCUITest per iOS. Inoltre, dovrai aggiornare le specifiche del test per utilizzare invece di. ` DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9` ` DEVICEFARM_WDA_DERIVED_DATA_PATH` La nuova variabile di ambiente punta a una versione predefinita di WebDriverAgent 9.x, che è l'ultima versione supportata per i test di Appium 2. Per ulteriori informazioni, consulta e. [Selezione di una WebDriverAgent versione per i test iOS](test-types-appium.md#test-types-appium-select-wda) [Variabili di ambiente per i test di Appium](custom-test-environment-variables.md#custom-test-environment-variables-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 differenze chiave nell'ambiente: + **Versioni Xcode:** nell'ambiente host di test legacy, la versione Xcode disponibile era basata sulla versione iOS del dispositivo utilizzato per i test. Ad esempio, i test su dispositivi iOS 18 hanno utilizzato Xcode 16 nell'host legacy, mentre i test su iOS 17 hanno utilizzato Xcode 15. Nel nuovo ambiente host, tutti i dispositivi possono accedere alle stesse versioni di Xcode, garantendo un ambiente coerente per i test su dispositivi con versioni diverse. Per un elenco delle versioni di Xcode attualmente disponibili, consulta. [Software supportato](custom-test-environments-hosts-software.md) + **Selezione delle versioni del software:** in molti casi, le versioni software predefinite 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 che utilizza. [`devicefarm-cli`](custom-test-environments-hosts-software-cli.md) Nella maggior parte dei casi d'uso, consigliamo ai clienti di selezionare esplicitamente le versioni del software che utilizzano. Selezionando una versione del software con, `devicefarm-cli` avrai un'esperienza prevedibile e coerente e riceverai un'ampia quantità di avvisi se Device Farm prevede di rimuovere quella versione dall'host di test. Inoltre, strumenti di selezione del software come `nvm` `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 preinstallato in precedenza sono state rimosse e sono state aggiunte molte nuove versioni. Pertanto, assicurati che quando utilizzi `devicefarm-cli` per selezionare le versioni del software, selezioni le versioni presenti nell'[elenco delle versioni supportate](custom-test-environments-hosts-software.md). + **La `libimobiledevice` suite di strumenti è stata rimossa** a favore di strumenti più nuovi/di prima parte 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 in merito`devicectl`, puoi eseguirlo `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 di file di 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](custom-test-environments-best-practices.md). + **Versione e architettura del sistema operativo:** gli host di test precedenti utilizzavano una varietà di versioni 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, consulta[Host di test iOS legacy](custom-test-environments-hosts-ios.md#legacy-ios-host). + **Per gli utenti di Appium**, il modo di selezionare WebDriverAgent è stato modificato in un prefisso per le variabili di ambiente utilizzate ` 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](custom-test-environment-variables.md#custom-test-environment-variables-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 se hai commenti o domande sulle differenze tra gli host di test dal punto di vista del software.