Affichage des articles dont le libellé est Debug. Afficher tous les articles
Affichage des articles dont le libellé est Debug. Afficher tous les articles

lundi 5 octobre 2009

Atelier 01 - Créer sa première solution avec Visual C#

Comme on l'a constaté, il est possible de développer avec un simple éditeur de texte comme notepad++, mais le codage peut être fortement simplifié avec un environnement de développement comme Visual Studio pour le C#

Nous allons donc continuer notre première application en créant une solution contenant deux projets pour gérer nos fichiers de code.

Pour bien comprendre la différence entre une solution et un projet, chaque projet développé avec l’IDE va donner un assemblage .Net avec l’extension .dll ou .exe. Dans le cadre d’un développement, il arrive souvent que la compilation doive donner plusieurs assemblages, comme dans le cas de l’exercice précédent où nous avons un fichier .exe et un fichier .dll. Une solution va contenir des codes de projets différents mais relatifs à une même problématique de codage. Une solution contient donc au minimum un projet.



Organiser la solution

On va commencer par créer un nouveau projet "application console", avec pour nom Coach et l'enregistrer dans notre dossier de travail. Si l'explorateur de solution n'est pas visible, il faut aller dans le menu view -> Solution explorer

On va à présent ajouter à la solution un nouveau projet. Pour ce faire, on clique avec le bouton droite sur Solution (Coach) et on ajoute un nouveau projet. On va sélectionner Class Library que l'on va appeler Coach.Calculateur

L'explorateur de solution affiche à présent deux projet, Coach et Coach.Calculateur

Visual C# est fourni avec (entre autres) les modèles de projet suivants :
- Application Windows : Ce modèle est utilisé pour développer des applications avec une interface utilisateur Windows à base de formulaire ;
- Bibliothèque de classes : Il s’agit ici de développer une bibliothèque de classes qui sera compilée sous forme d’un assemblage d’extension .dll ;
- Application Console : Ce modèle aide à la création d’une application en ligne de commande, très utilisé pour tester des services ou des librairies de classes ;
- Projet vide : Ce modèle sert de base à la création de tout type de programme, les différents éléments et paramètres devant être configurés manuellement ;

Si on regarde sur le disque les fichiers qui ont été créés, on retrouve notre dossier Coach, et à l'intérieur les dossiers Coach et Coach.Calculateur (nos deux projets)

Le fichier Coach.sln est le fichier de solution. On peut l’ouvrir avec le bloc-notes. Il contient la définition de tous les projets composants la solution.

Dans chacun des sous-répertoires de projet, on voit un fichier d’extension .csproj. Il s’agit de notre fichier de projet, qui est utilisé par le compilateur (et MSBuild.exe) pour générer l’assemblage. On peut l’ouvrir avec le Bloc-notes, il est au format XML.

On va récupérer notre fichier Calculateur.cs créé dans l'exercice précédent et le copier dans le répertoire Coach.Calculateur. Dans l'explorateur de solution, on supprime le Class1.cs qui se crée par défaut. On clique sur le bouton en haut qui nous indique Show all files et on va retrouver notre fichier Calculateur.cs que l'on va inclure au projet (bouton droit sur le fichier, Include to Project) car il est pour l'instant grisé.

On va à présent modifier le projet Coach pour utiliser la librairie de calcul (click droit sur le projet Coach et le menu Add reference. Dans l'onglet Project, on va retrouver notre autre projet.

L’ajout d’une référence indique à l’IDE les noms d’objets à prendre en compte pour la vérification des noms lors du codage, et indique au compilateur les librairies à référencer et à copier.

On retrouve dans notre projet Coach, dans le référence, le projet que l'on vient d'ajouter.

Les références déjà présentes ont été ajoutées par le modèle de projet Application Console référencé lors de la création du projet Coach.

On va afficher le code de Program.cs qui se trouve dans le projet Coach en cliquant avec le bouton droit de la souris.

On ajoute le code suivant dans Main() :
System.Console.
WriteLine("L'addition de 10 et 5 est : {0}.",
Calculateur.Ajouter(10, 5));
System.Console.ReadKey();
On sauve, et on peut générer la solution (F6 ou Build -> Build Solution). Normalement, il ne devrait pas y'avoir d'erreur (on le voit tout de suite dans la fenêtre output)

On va ensuite lancer le debugger pour exécuter l'application (Debug -> Start debugging). La console doit s'ouvrir avec notre calcul et son résultat.

Le code aurait aussi pu être généré en utilisant la touche F6. L’application aurait pu aussi être lancée en tapant la touche F5

Les projets compilés sont sous le répertoire bin\debug de chaque projet respectif.

Sous chaque répertoire de compilation bin\debug, le programme [nom de projet].vshost.exe (par exemple Coach.vshost.exe) est le programme qui est utilisé par l’IDE en mode de débogage.

Sous chaque projet, dans le sous répertoire Properties, nous avons un fichier AssemblyInfo.cs qui contient les informations relatives à l’assemblage comme les numéros de version ou le copyright.

Parmi ces propriétés, on retrouvera sur l’onglet Signature celle qui permet de signer avec un nom fort l’assemblage. Cela nous évite d’avoir à générer avec l’utilitaire sn.exe le fichier de paire de clés, et de l’associer en ligne de commande lors de la compilation.



Apprivoiser l'environnement de développement

On va essayer d'utiliser IntelliSense. On ouvre le code de Program.cs et après la ligne System.Console.ReadKey(); on fait un retour de chariot.

On commence à taper le mot sys
Une fenêtre proposant les différents objets est ouverte sous le curseur, en surlignant le mot le plus proche du début que nous venons de taper. C’est l’IntelliSense...
Etant donné que System sera en surbrillance, on peut taper à présent un point (.) et on continuer à taper cons qui nous permettra de saisir le mot Console (avec la touche tabulation le mot sera complété)

IntelliSense est un mécanisme automatique d’auto-sélection qui intervient comme une aide à la programmation et un accès à la documentation. Il propose sans ambiguïté les noms des types, des méthodes, des fonctions et des objets accessibles dans le contexte, et aussi des aides au codage sous forme de blocs de codes préprogrammés.

Les touches à connaître avec IntelliSense sont :
  • Le point (.), pour afficher les membres d'un type
  • Le Tab (Tabulation), pour sélectionner l'élément surligné dans IntelliSense
  • Le Ctrl Espace pour vérifier l'écriture d'un terme présent dans IntelliSense, et en finir la tape si le mot (ou le début de mot) tapé n'a pas d'ambiguïté
  • Le Tab Tab (double tabulation) pour insérer un extrait de code
Lors de la programmation, si IntelliSense ne reconnaît pas un terme alors que nous nous attendions à ce qu’il soit reconnu, c’est que :
  • Ou nous sommes positionné au mauvais endroit
  • Ou la portée de l'objet le rend inaccessible dans notre contexte
  • Ou nous avons oublié de référencer la librairie fournissant cet objet dans notre projet
Dans tous les cas, si IntelliSense ne nous propose pas le terme attendu, nous obtiendrons une erreur de compilation.



Utilisation des extraits de code

Un extrait de code est un bloc préprogrammé reprenant les structures de base de C# pour nous aider à aller plus vite dans nos développements.

Nous allons reprendre le code de notre fichier Program.cs du projet Coach. On ajoute une ligne vierge après l'accolade fermante de la méthode static void Main() et on tape le début de mot prop et on va faire un Tab Tab pour insérer un extrait de code.

Pour visualiser et gérer l’ensemble des extraits de code, on sélectionne le menu Outils > Gestionnaire des extraits de code. Cette fenêtre nous indique notamment l’endroit où ces extraits de code sont installés.



Debuggage


Très pratique, la fonction qui nous permet de debugger notre application. On ouvre le code du fichier que l'on veut débugger (Program.cs dans notre cas) et on va cliquer dans la marge à gauche pour obtenir un point d'arrêt (rouge). Tout le code de la ligne ou de l'instruction (si elle est sur plusieurs lignes) va être en surbrillance.

On fait tourner le debugger (touche F5) et le programme va s'arrêter sur cette ligne. En laissant posée la souris sur une variable, nous aurons sa valeur.