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.
# Démarrez avec Device Farm
Cette procédure pas à pas vous montre comment utiliser Device Farm pour tester une application Android ou iOS native. Vous utilisez la console Device Farm pour créer un projet, télécharger un fichier .apk ou .ipa, exécuter une suite de tests standard, puis afficher les résultats.
**Note**
Device Farm est disponible uniquement dans la AWS région `us-west-2` (Oregon).
**Topics**
+ [Conditions préalables](#getting-started-prepare)
+ [Étape 1 : Se connecter à la console](#getting-started-console)
+ [Étape 2 : Création d'un projet](#getting-started-create-project)
+ [Étape 3 : Création et démarrage d'une course](#getting-started-create-run)
+ [Étape 4 : Afficher les résultats de la course](#getting-started-view-run-results)
+ [Étapes suivantes](#getting-started-next-steps)
## Conditions préalables
Avant de commencer, assurez-vous de respecter les prérequis suivants :
+ Suivez les étapes de [Configuration](setting-up.md). Vous devez disposer d'un AWS compte et d'un utilisateur Gestion des identités et des accès AWS (IAM) autorisé à accéder à Device Farm.
+ Pour Android, vous pouvez apporter un fichier .apk (package d'applications Android) ou utiliser l'exemple d'application que nous fournissons. Pour iOS, vous avez besoin d'un fichier .ipa (archive d'application iOS). Vous téléchargerez le fichier sur Device Farm plus loin dans cette procédure pas à pas.
**Note**
Assurez-vous que votre fichier .ipa est conçu pour un appareil iOS et non pour un simulateur.
+ (Facultatif) Vous avez besoin d'un test provenant de l'un des frameworks de test pris en charge par Device Farm. Vous chargez ce package de test dans Device Farm, puis vous exécutez le test plus loin dans cette procédure pas à pas. Si aucun package de test n'est disponible, vous pouvez spécifier et exécuter une suite de tests intégrée standard. Pour de plus amples informations, veuillez consulter [Frameworks de test et tests intégrés dans AWS Device Farm](test-types.md).
## Étape 1 : Se connecter à la console
Vous pouvez utiliser la console Device Farm pour créer et gérer des projets et les exécuter à des fins de test. Vous découvrirez les projets et les exécutions ultérieurement dans cette procédure.
+ Connectez-vous à la console Device Farm à l'adresse [ https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).
## Étape 2 : Création d'un projet
Pour tester une application dans Device Farm, vous devez d'abord créer un projet.
1. Dans le volet de navigation, choisissez ** Mobile Device Testing**, puis choisissez ** Projets**.
1. Sous Projets de test d'appareils ** mobiles**, choisissez ** Créer un projet**.
1. Dans ** Créer un projet**, entrez un nom de ** projet ** (par exemple,**MyDemoProject**).
1. Choisissez **Créer**.
La console ouvre la ** page Tests ** automatisés du projet que vous venez de créer.
## Étape 3 : Création et démarrage d'une course
Maintenant que vous disposez d'un projet, vous pouvez créer et démarrer une exécution. Pour de plus amples informations, veuillez consulter [Exécutions](test-runs.md).
1. Dans l'**onglet Tests ** automatisés, choisissez ** Créer une exécution**. Vous pouvez également suivre le didacticiel intégré à la console en sélectionnant ** Créer une exécution avec le didacticiel**.
1. Sous ** Sélectionnez l'application et le type d'exécution**, dans la ** section Type d'**exécution, sélectionnez votre type d'exécution. Sélectionnez une application ** Android ** si aucune application n'est prête à être testée ou si vous testez une application Android (.apk). Sélectionnez une application ** iOS ** si vous testez une application iOS (.ipa).
1. Sous ** Sélectionner une application**, dans la ** ** section Options de sélection des applications, choisissez ** Sélectionner un exemple d'application fourni par Device Farm ** si aucune application n'est disponible pour les tests. Si vous apportez votre propre application, sélectionnez ** Télécharger votre propre application**, puis choisissez votre dossier de candidature. Si vous chargez une application iOS, veillez à choisir **iOS device (Appareil iOS)** et non un simulateur.
1. Sous ** Configurer le test**, dans la ** section ** Sélectionner un framework de test, choisissez l'un des frameworks de test ou des suites de tests intégrées. Pour plus d’informations sur chaque option, consultez [Frameworks de test et tests intégrés dans AWS Device Farm](test-types.md).
+ Si vous n'avez pas encore empaqueté vos tests pour Device Farm, choisissez ** Built-in : Fuzz ** pour exécuter une suite de tests standard intégrée. Vous pouvez conserver les valeurs par défaut pour ** Event count**, ** Event throttle ** et ** Randomizer seed. ** Pour de plus amples informations, veuillez consulter [Exécution du test de fuzz intégré à Device Farm (Android et iOS)](test-types-built-in-fuzz.md).
+ Si vous disposez d'un package de test provenant de l'un des frameworks de test pris en charge, choisissez le framework de test correspondant, puis téléchargez le fichier contenant vos tests.
1. Sous ** Sélectionner les appareils**, choisissez ** Utiliser le pool d'appareils ** et les ** meilleurs appareils**.
1. (Facultatif) Pour ajouter une configuration supplémentaire, ouvrez la ** liste déroulante Configuration ** supplémentaire. Dans cette section, vous pouvez effectuer l'une des opérations suivantes :
+ Pour fournir d'autres données que Device Farm pourra utiliser pendant l'exécution, à côté de ** Ajouter des données supplémentaires**, ** choisissez Choisir un fichier**, puis recherchez et choisissez le fichier .zip qui contient les données.
+ Pour installer une application supplémentaire que Device Farm pourra utiliser pendant l'exécution, à côté de ** Installer d'autres applications**, ** choisissez Choisir un fichier**, puis recherchez et choisissez le fichier .apk ou .ipa qui contient l'application. Répétez cette procédure pour les autres applications que vous voulez installer. Vous pouvez modifier l'ordre d'installation en faisant glisser et en déposant les applications après les avoir chargées.
+ Pour spécifier si Bluetooth Wi-Fi, GPS ou NFC est activé pendant la course, cochez les cases appropriées à côté de ** Définir les états ** radio.
+ Pour prédéfinir la latitude et la longitude de l'appareil pour l'exécution, saisissez les coordonnées en regard de **Device location (Emplacement de l'appareil)**.
+ Pour prédéfinir les paramètres régionaux de l'appareil pour l'exécution, dans Paramètres régionaux de l'**appareil**, choisissez les paramètres régionaux.
+ Sélectionnez ** Activer l'enregistrement vidéo ** pour enregistrer une vidéo pendant les tests.
**Note**
Le réglage de l'état radio et des paramètres régionaux de l'appareil sont des options uniquement disponibles pour les tests natifs Android pour le moment.
**Note**
Si vous possédez des appareils privés, la configuration spécifique aux appareils privés est également affichée.
1. (Facultatif) Pour configurer les propriétés au niveau de l'exécution, mettez à jour la section Paramètres d'**exécution. ** Ici, vous pouvez effectuer les opérations suivantes :
+ Attribuez à votre course un nom de ** course personnalisé**. Si aucun nom n'est fourni, la console Device Farm appellera votre exécution « My Device Farm run » par défaut.
+ Choisissez ** Générer un rapport de ** test ** sous Test Insights ** pour obtenir un rapport de test structuré détaillé pour chaque tâche et un résumé agrégé au niveau de l'exécution. Ces informations sont générées en plus de tout rapport de test que vous pourriez générer dans le cadre de l'exécution de votre test.
+ Attribuez un délai ** d'expiration à une tâche**, qui correspond au nombre maximum de minutes pendant lequel une tâche peut être exécutée sur un appareil. Si vos tests sont terminés avant la fin de la tâche, celle-ci est terminée et vous n'êtes pas facturé pour le reste de la durée de la tâche. La valeur par défaut est de 150 minutes.
+ Choisissez un mode ** de facturation**. Par défaut, si aucune machine à sous n'a été achetée sur votre compte, la console Device Farm sélectionne Metered. Si vous avez des emplacements, la console est réglée par défaut sur Unmetered.
1. Au bas de la page, choisissez ** Confirmer et lancez l'exécution ** pour planifier l'exécution.
Device Farm démarre l'exécution dès que les appareils sont disponibles, généralement en quelques minutes. Pour consulter l'état de l'exécution, sur la ** page Tests ** automatisés de votre projet, choisissez le nom de votre exécution. Sur la page d'exécution, sous ** Appareils**, chaque appareil commence par l'icône en attente  dans le tableau des appareils, puis passe à l'icône en cours  lorsque le test commence. À la fin de chaque test, la console affiche une icône de résultat de test à côté du nom de l'appareil. Lorsque tous les tests sont terminés, l'icône en attente à côté de l'exécution devient une icône de résultat de test.
## Étape 4 : Afficher les résultats de la course
Pour afficher les résultats des tests de l'exécution, sur la ** page Tests ** automatisés de votre projet, choisissez le nom de votre exécution. Une page récapitulative affiche :
+ Le nombre total de tests, par résultat.
+ Des listes des tests comportant des avertissements ou des échecs uniques.
+ Une liste des appareils avec les résultats des tests pour chacun d'entre eux.
+ Toutes les captures d'écran effectuées pendant l'exécution, regroupées par appareil.
+ Une section pour télécharger le résultat de l'analyse.
Pour de plus amples informations, veuillez consulter [Affichage des rapports de test dans Device Farm](how-to-use-reports.md).
## Étapes suivantes
Pour plus d'informations sur Device Farm, consultez [Concepts](concepts.md).