Comment : configurer le déploiement d'un test

Mise à jour : novembre 2007

Le moteur de test peut exécuter les tests soit dans le dossier dans lequel vous les avez créés ou générés, soit dans un dossier de déploiement distinct. Pour plus d'informations, consultez Vue d'ensemble du déploiement de test.

Le dossier de déploiement peut être local ou distant. Le déploiement de test distant se produit lorsque vous travaillez avec des contrôleurs et des agents ; pour plus d'informations sur le déploiement distant, consultez Contrôleurs, agents et plateformes de test.

Définition d'options de déploiement

Il existe plusieurs façons de contrôler le déploiement de tests :

• Activer ou désactiver le déploiement. Vous pouvez choisir s'il faut activer ou désactiver le déploiement; autrement dit, s'il faut effectuer des tests dans un dossier de déploiement ou sur place. Pour plus d'informations, consultez Activer et désactiver le déploiement de tests.

  Remarque :
  Si vous travaillez avec les tests Smart Device, activez le déploiement de tests. Les tests Smart Device ne sont pas exécutés si le déploiement est désactivé.

• Sélectionner les éléments de déploiement. Pour le déploiement de tests locaux, le moteur de test copie les éléments du déploiement (les fichiers et les dossiers) dans un dossier sur votre ordinateur avant d'exécuter des tests. Pour plus d'informations sur l'ordre dans lequel les éléments de déploiement sont copiés, consultez Ordre de déploiement. Pour plus d'informations sur les méthodes de sélection d'éléments de déploiement supplémentaires devant être copiés, consultez Sélectionner les éléments de déploiement.

Activer et désactiver le déploiement de tests

Par défaut, le déploiement de tests est activé. Vous pouvez modifier ce paramètre dans la boîte de dialogue de configuration de série de tests, comme décrit dans les procédures suivantes.

Pour activer le déploiement de tests

1. Dans l'Explorateur de solutions, sous Éléments de solution, double-cliquez sur le fichier de configuration de série de tests à modifier.

   Une boîte de dialogue contenant un nom tel que <nom_fichier_config_série_tests>.testrunconfig s'affiche.

2. Cliquez sur Déploiement.

3. Activez la case à cocher Activer le déploiement.

   Cette modification active uniquement le déploiement pour la configuration de série de tests en cours.

Pour désactiver le déploiement de tests

1. Dans l'Explorateur de solutions, sous Éléments de solution, double-cliquez sur le fichier de configuration de série de tests à modifier.

   Une boîte de dialogue contenant un nom tel que <nom_fichier_config_série_tests>.testrunconfig s'affiche.

2. Cliquez sur Déploiement.

3. Désactivez la case à cocher Activer le déploiement.

   Tenez compte de ce qui suit à propos de ce choix :

   • Cette modification désactive uniquement le déploiement pour la configuration de série de tests en cours.

   • Ce paramètre contrôle les deux côtés du déploiement de tests : le déploiement des tests et le déploiement des éléments que vous pouvez spécifier. Pour plus d'informations sur toutes les facettes du déploiement de tests, consultez Vue d'ensemble du déploiement de test.

   • Si vous travaillez avec les tests Smart Device, ne désactivez pas le déploiement de tests. Les tests Smart Device ne sont pas exécutés si le déploiement est désactivé.

   • Désactiver le déploiement désactive également la collecte des données de couverture du code. Pour être en mesure de rassembler les données de couverture du code dans vos séries de tests, vous devez d'abord réactiver le déploiement de tests.

Sélection d'éléments de déploiement

Les procédures suivantes, dans lesquelles vous déterminez les fichiers ou dossiers à copier, diffèrent dans leur portée. La première procédure définit les éléments de déploiement pour une configuration de série de tests. Ces éléments sont copiés à chaque fois que cette configuration de série de tests est active. Les deuxième et troisième procédures s'appliquent à une seule méthode de test ; elles déterminent les fichiers copiés par Visual Studio Team System Test Edition avant qu'il n'exécute ce test spécifique.

Pour sélectionner des fichiers ou des dossiers à déployer dans la configuration de série de tests

1. Dans l'Explorateur de solutions, sous Éléments de solution, double-cliquez sur le fichier de configuration de série de tests à modifier.

   Une boîte de dialogue contenant un nom tel que <nom_fichier_config_série_tests>.testrunconfig s'affiche.

2. Cliquez sur Déploiement.

3. Sous Fichiers et répertoires à déployer supplémentaires, spécifiez des fichiers ou dossiers supplémentaires à copier. Pour ce faire, cliquez sur Ajouter un fichier pour sélectionner des fichiers ; cette opération ouvre la boîte de dialogue Ajouter des fichiers de déploiement. Vous pouvez également cliquer sur Ajouter un répertoire pour sélectionner des dossiers à l'aide de la boîte de dialogue Ajouter un répertoire de déploiement.

4. Dans la boîte de dialogue .testrunconfig, cliquez sur Enregistrer, puis sur OK.

   Ces éléments de déploiement seront copiés dans le dossier de déploiement à chaque fois que ce fichier de configuration de série de tests sera actif.

Pour déployer des éléments pour un seul test à l'aide de la propriété Éléments de déploiement

1. Sélectionnez un test dans la fenêtre Affichage de tests ou Explorateur de tests.

2. Appuyez sur F4.

   La fenêtre Propriétés du test s'affiche.

3. Cliquez sur la propriété Éléments de déploiement.

   Un bouton de sélection (...) apparaît dans la colonne Valeur.

4. Cliquez sur le bouton de sélection.

   La boîte de dialogue Éditeur de collections String s'affiche.

5. Avant que le test ne soit exécuté, tapez un chemin d'accès à un dossier ou un fichier que vous souhaitez copier dans le dossier de déploiement du test. Appuyez sur Entrée et tapez des chemins d'accès supplémentaires pour spécifier des dossiers et des fichiers supplémentaires à déployer.

   Remarque :
   Vous pouvez utiliser des variables d'environnement dans les chemins d'accès pour les éléments de déploiement. Pour voir un exemple, consultez DeploymentItemAttribute.

6. Cliquez sur OK.

   Les éléments de déploiement que vous avez spécifiés seront déployés en plus de ceux spécifiés dans la configuration de série de tests utilisée pour le test.

   Remarque :
   Pour les tests unitaires, du code qui spécifie ces éléments de déploiement est écrit dans le code source du test, dans l'attribut DeploymentItem.

Pour déployer des éléments pour un seul test à l'aide de l'attribut DeploymentItem

1. Ouvrez le fichier de code source qui contient un test unitaire. Pour plus d'informations, consultez Comment : créer un test unitaire.

2. Sous l'attribut TestMethod, ajoutez un attribut DeploymentItem.

3. Pour le paramètre de l'attribut DeploymentItem, spécifiez le dossier ou le fichier que vous souhaitez déployer pour ce test. Vous pouvez utiliser un chemin d'accès absolu ou relatif. Les chemins d'accès relatifs sont relatifs au paramètre RelativePathRoot qui figure dans le fichier .testrunconfig.

   Exemple en C# :

   [TestMethod]

   [DeploymentItem("MyTestProject\\testdatasource.mdb")]

   public void TestMethod1()

   {

   // TODO: Add test logic here

   }

   Exemple en Visual Basic :

   <TestMethod()> _

   <DeploymentItem("MyTestProject\\testdatasource.mdb")> _

   Public Sub TestMethod1()

   ' TODO: Add test logic here

   End Sub

   Remarque :
   Vous pouvez utiliser l'attribut DeploymentItem uniquement sur les méthodes de test, et non sur les classes de test.

4. Enregistrez et fermez le fichier de code source du test unitaire.

   Lorsque vous exécutez le test, les éléments de déploiement que vous avez spécifiés seront déployés en plus de ceux spécifiés dans la configuration de série de tests utilisée pour le test.

Ordre de déploiement

Les éléments de déploiement sont copiés dans un ordre spécifique. Les éléments de déploiement qui sont copiés ultérieurement remplacent ceux qui ont été copiés précédemment, s'ils ont le même nom. Par exemple, les éléments de déploiement spécifiés dans la configuration de série de tests sont copiés plus tard que les éléments spécifiés pour un test.

La liste suivante est classée de la priorité la plus élevée à la plus basse. Autrement dit, les éléments répertoriés en premier remplaceront les éléments répertoriés plus bas. Dans la liste suivante, certains éléments (parmi lesquels l'assembly de test, les binaires instrumentés et les assemblys dépendants) sont déployés automatiquement dans le dossier de déploiement.

1. Fichiers qui composent le test. Ceux-ci incluent les assemblys de test pour les tests unitaires, les fichiers texte ou .mht pour les tests manuels ou d'autres types de fichiers pour d'autres types de tests (tels que les tests génériques).

2. Binaires instrumentés. Il s'agit de fichiers binaires qui ont été instrumentés, par exemple pour activer la couverture du code.

   Remarque :
   Si vous utilisez l'instrumentation sur place, les binaires sont d'abord instrumentés, puis copiés dans le répertoire de déploiement ; sinon, ils sont d'abord copiés, puis instrumentés. L'instrumentation sur place est le paramètre par défaut pour les tests qui sont exécutés localement ; vous pouvez modifier ce paramètre dans la configuration de série de tests.

3. Éléments spécifiés dans la configuration de série de tests.

4. Dépendances, par exemple les fichiers de configuration de l'application et les assemblys dépendants.

5. Éléments de déploiement par test. Ceux-ci incluent les éléments spécifiés pour la méthode de test.

Voir aussi

Tâches

Comment : configurer la création d'un projet de test

Comment : configurer les boîtes de dialogue de Test Edition

Concepts

Vue d'ensemble du déploiement de test

Contrôleurs, agents et plateformes de test

Instrumentation et nouvelle signature d'assemblys

Référence

DeploymentItemAttribute

Autres ressources

Configuration de l'exécution de tests