Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Intégration de Device Farm à XCTest pour iOS
Avec Device Farm, vous pouvez utiliser le XCTest framework pour tester votre application sur de vrais appareils. Pour plus d'informations XCTest, consultez la section [Principes de base des tests](https://developer.apple.com/library/ios/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/03-testing_basics.html) *dans Tester avec Xcode*.
Pour exécuter un test, vous créez les packages pour votre test et vous les téléchargez sur Device Farm.
Pour plus d'informations sur les tests dans Device Farm, consultez[Frameworks de test et tests intégrés dans AWS Device Farm](test-types.md).
**Topics**
+ [Créez les packages pour votre XCTest course](#test-types-ios-xctest-create-packages)
+ [Téléchargez les packages pour votre XCTest course sur Device Farm](#test-types-ios-xctest-upload)
## Créez les packages pour votre XCTest course
Pour tester votre application à l'aide du XCTest framework, Device Farm a besoin des éléments suivants :
+ Votre package d'application en tant que fichier `.ipa`.
+ Votre XCTest package sous forme de `.zip` fichier.
Vous créez ces packages en utilisant la sortie de build générée par Xcode. Procédez comme suit pour créer les packages afin de pouvoir les télécharger sur Device Farm.
**Pour générer la sortie de build pour votre application.**
1. Ouvrez votre projet d'application dans Xcode.
1. Dans le menu déroulant de méthode de la barre d'outils Xcode, choisissez **Generic iOS Device (Appareil iOS générique)** comme destination.
1. Dans le menu **Product (Produit)**, choisissez **Build For (Build pour)**, puis **Testing (Test)**.
**Pour créer le package d'application**
1. Dans le navigateur de projet dans Xcode, sous **Products (Produits)**, ouvrez le menu contextuel pour le fichier nommé `app-project-name.app`. Choisissez ensuite **Show in Finder (Afficher dans l'outil de recherche)**. L'outil de recherche s'ouvre dans un dossier nommé `Debug-iphoneos`, qui contient la sortie générée par Xcode pour votre build de test. Ce dossier inclut votre fichier `.app`.
1. Dans l'outil de recherche, créez un nouveau dossier et nommez-le `Payload`.
1. Copiez le fichier `app-project-name.app` et collez-le dans le dossier `Payload`.
1. Ouvrez le menu contextuel pour le dossier `Payload` et choisissez **Compress "Payload" (Compresser « Payload »)**. Un fichier nommé `Payload.zip` est créé.
1. Remplacez le nom de fichier et l'extension de `Payload.zip` par `app-project-name.ipa`.
Dans une étape ultérieure, vous fournirez ce fichier à Device Farm. Pour rendre le fichier plus facile à trouver, vous pouvez le déplacer vers un autre emplacement, tel que votre bureau.
1. Le cas échéant, vous pouvez supprimer le dossier `Payload` et le fichier `.app` dans celui-ci.
**Pour créer le XCTest package**
1. Dans l'outil de recherche, dans le répertoire `Debug-iphoneos`, ouvrez le menu contextuel pour le fichier `app-project-name.app`. Ensuite, choisissez **Show Package Contents (Afficher le contenu du package)**.
1. Dans le contenu du package, ouvrez le dossier `Plugins`. Ce dossier contient un fichier nommé `app-project-name.xctest`.
1. Ouvrez le menu contextuel pour ce fichier et choisissez **Compress (Compresser) "`app-project-name.xctest`"**. Un fichier nommé `app-project-name.xctest.zip` est créé.
Dans une étape ultérieure, vous fournirez ce fichier à Device Farm. Pour rendre le fichier plus facile à trouver, vous pouvez le déplacer vers un autre emplacement, tel que votre bureau.
## Téléchargez les packages pour votre XCTest course sur Device Farm
Utilisez la console Device Farm pour télécharger les packages de votre test.
1. Connectez-vous à la console Device Farm à l'adresse [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).
1. Si vous n'en possédez pas déjà un, créez un projet. Pour connaître les étapes de création d'un projet, consultez [Création d'un projet dans AWS Device Farm](how-to-create-project.md).
Sinon, dans le panneau de navigation de Device Farm, choisissez **Mobile Device Testing**, puis **Projects**.
1. Choisissez le projet que vous souhaitez utiliser pour exécuter le test.
1. Choisissez **Create run**.
1. Sous **Paramètres d'exécution**, dans la section **Type d'exécution**, choisissez **application iOS**.
1. Sous **Sélectionner une application**, dans la section **Options de sélection des applications**, sélectionnez **Télécharger votre propre application**. Sélectionnez ensuite **Choisir un fichier** sous **Télécharger l'application**.
1. Accédez au fichier `.ipa` pour votre application et chargez-le.
**Note**
Votre package `.ipa` doit être conçu pour les tests.
1. Sous **Configurer le test**, dans la section **Sélectionner le framework de test**, sélectionnez **XCTest**. Sélectionnez ensuite **Choisir un fichier** sous **Télécharger l'application**.
1. Accédez au `.zip` fichier contenant le XCTest package de votre application et téléchargez-le.
1. Effectuez les étapes restantes du processus de création de projet. Vous sélectionnerez les appareils sur lesquels vous souhaitez exécuter le test et vous spécifierez leur état.
1. Choisissez **Create run**. Device Farm exécute votre test et affiche les résultats dans la console.