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à.

# Integrazione dell'interfaccia utente di XCTest per iOS con Device Farm
<a name="test-types-ios-xctest-ui"></a>

Device Farm fornisce supporto per il framework di test dell'interfaccia utente XCTest. [In particolare, Device Farm supporta i test dell'interfaccia utente XCTest scritti sia in Swift che Objective-C in Swift.](https://developer.apple.com/swift/) 

 Il framework dell'interfaccia utente XCTest consente il test dell'interfaccia utente nello sviluppo iOS, basato su XCTest. Per ulteriori informazioni, consulta la sezione [User Interface Testing](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) nella libreria per sviluppatori di iOS.

Per informazioni generali sui test in Device Farm, vedere[Framework di test e test integrati in AWS Device Farm](test-types.md).

Usa le seguenti istruzioni per integrare Device Farm con il framework di test dell'interfaccia utente XCTest per iOS.

**Topics**
+ [Prepara i test dell'interfaccia utente di iOS XCTest](#test-types-ios-xctest-ui-prepare)
+ [Opzione 1: creazione di un pacchetto XCTest UI .ipa](#how-to-use-create-XCTestUI-ipa-package)
+ [Opzione 2: creazione di un pacchetto.zip di XCTest UI](#how-to-use-create-XCTestUI-zip-package)
+ [Carica i test dell'interfaccia utente di iOS XCTest](#test-types-ios-xctest-ui-upload)

## Prepara i test dell'interfaccia utente di iOS XCTest
<a name="test-types-ios-xctest-ui-prepare"></a>

Puoi caricare un `.ipa` file o un `.zip` file per il tuo pacchetto di test XCTEST\_UI.

Un `.ipa` file è un archivio di applicazioni contenente l'app iOS Runner in formato bundle. *Non è possibile includere file aggiuntivi all'interno del `.ipa` file.*

Se carichi un `.zip` file, può contenere direttamente l'app iOS Runner o un `.ipa` file. Puoi anche includere altri file all'interno del `.zip` file se desideri utilizzarli durante i test. Ad esempio`.xctestrun`, puoi includere file come `.xcworkspace` o `.xcodeproj` all'interno `.zip` del file per eseguire i piani di test XCUI sulla device farm. Istruzioni dettagliate su come eseguire i piani di test sono disponibili nel file delle specifiche di test predefinito per il tipo di test XCUI. 

## Opzione 1: creazione di un pacchetto XCTest UI .ipa
<a name="how-to-use-create-XCTestUI-ipa-package"></a>

Il *tuo AppName* UITest-Runner.app bundle viene prodotto da Xcode quando crei il tuo progetto per i test. Si trova nella directory Products per il progetto.

Per creare un file.ipa:

1. Crea una directory chiamata. {{Payload}}

1. Aggiungi la directory dell'app alla directory Payload.

1. Archivia la directory Payload in un `.zip` file, quindi modifica l'estensione del file in. `.ipa`

 La seguente struttura di cartelle mostra come un'app di esempio denominata {{my-project-nameUITest-Runner.app}} verrebbe impacchettata come `.ipa` file: 

```
.
└── my-project-nameUITest.ipa
    └── Payload (directory)
        └── my-project-nameUITest-Runner.app
```

## Opzione 2: creazione di un pacchetto.zip di XCTest UI
<a name="how-to-use-create-XCTestUI-zip-package"></a>

Device Farm genera automaticamente un `.xctestrun` file per eseguire la suite completa di test dell'interfaccia utente XCTest. Se desideri utilizzare il tuo `.xctestrun` file su Device Farm, puoi comprimere `.xctestrun` i file e la directory dell'app in un `.zip` file. Se hai già un `.ipa` file per il tuo pacchetto di test, puoi includerlo qui invece di{{\*-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)
```

 Se desideri eseguire un piano di test Xcode per i tuoi test XCUI su Device Farm, puoi creare uno zip contenente il UITest.ipa file *my-project-name UITest-Runner.app **o** *my-project-name** e i file di codice sorgente xcode necessari per eseguire XCTEST\_UI con piani di test, incluso un file or. `.xcworkspace` `.xcodeproj`

Ecco un esempio di zip che utilizza un file: `.xcodeproj` 

```
.
└── 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)
```

Ecco un esempio di zip che utilizza un `.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
```

**Nota**  
Assicurati di non avere una directory denominata «Payload» all'interno del pacchetto.zip di XCTest UI. 

## Carica i test dell'interfaccia utente di iOS XCTest
<a name="test-types-ios-xctest-ui-upload"></a>

Usa la console Device Farm per caricare i test.

1. Accedi alla console Device Farm all'indirizzo [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).

1. Nel pannello di navigazione di Device Farm, scegli **Mobile Device Testing**, quindi scegli **Progetti**.

1. Nell'elenco dei progetti, scegli il progetto su cui vuoi caricare i test.
**Suggerimento**  
Puoi utilizzare la barra di ricerca per filtrare l'elenco dei progetti per nome.  
Per creare un progetto, segui le istruzioni in [Creazione di un progetto in AWS Device Farm](how-to-create-project.md)

1. Scegli **Crea esegui**.

1. In **Impostazioni di esecuzione**, nella sezione **Tipo di esecuzione**, scegli **l'app iOS**.

1. In **Seleziona app**, nella sezione **Opzioni di selezione dell'app**, seleziona **Carica la tua app**. Quindi, seleziona **Scegli file** in **Carica app**.

1. Individuare e selezionare il file dell'app iOS. Il file deve essere un file .ipa.
**Nota**  
Assicurati che il file .ipa sia integrato per un dispositivo iOS e non per un simulatore.

1. In **Configura test**, nella sezione **Seleziona framework di test**, scegli **XCTest UI**. Quindi, seleziona **Scegli file** in **Carica** app.

1. Cerca e scegli il file.ipa o.zip che contiene il test runner dell'interfaccia utente iOS XCTest. 

1. Completa i passaggi rimanenti del processo di creazione dell'esecuzione. Selezionerai i dispositivi su cui desideri eseguire il test e, facoltativamente, specificherai una configurazione aggiuntiva.

1. Scegli **Crea esegui**. Device Farm esegue il test e mostra i risultati nella console.