Découvrir Xcode 7

Documenter son code

TESTEZ LINKEDIN LEARNING GRATUITEMENT ET SANS ENGAGEMENT

Tester maintenant Afficher tous les abonnements
Vous pouvez documenter votre propre code en ajoutant des commentaires. Ceux-là vont être affichés directement dans Xcode.

Transcription

Les Commentaires sont une partie importante du développement Alors on va voir comment écrire des commentaires, qui seront utilisés par Xcode, on va créer un petit projet, on va appeler Commentaires, Ça me rappelle une application que j'ai justement Comments. Si vous allez voir sur pomcast.biz, vous verrez que j'ai une app, qui s'appelle Comments Voilà, donc c'est un peu comme si je refaisais mon app, on va la mettre ici nos chapitres. Et on va voir comment créer des Commentaires déjà on va faire un truc qu'on n'a pas encore fait jusqu'à maintenant on va créer un fichier supplémentaire en elle peur. En l'occurrence alors pour ça on a deux options, soit on fait commande N, plusieurs options, soit on fait commande N, soit on fait un fichier nouveau, et le Fichier. Soit on prend un fichier ici, Swift File tout simplement. Et on glisse là, ça c’est pas mal non plus, et puis on lui donne un nom, on va l'appeler Helper. Swift. Voilà, OK. Dans ce Helper.Swift on va créer une petite fonction qu'on va appeler repeatString, une fonction globale, ce n'est pas forcément le truc le plus phénoménal au niveau beauté programmation, mais c'est pas le but du cours. Ça va retourner un String, Return, un Array, qui va retourner autant de fois, donc le times, avec la valeur str. Cet Array, on va le concatener avec un jointWithSaparator avec un espace. C'est un peu Quick and Dirty parce qu'au final ça va nous retourner par exemple Hello, puis espace, et là je vous simule les espaces avec des underscores Hello, voilà si on fait trois fois, et le dernier sera toujours un espace, donc on aurait pu faire ça de manière un peu plus élégante, mais ça suffira pour le coup. Du coup on va aller dans mon View DidLoad, ici, et je vais tout simplement me mettre à ce moment-là, un repeat String, Il apparaît ici, tout va très bien jusque pour l'instant, mais on n'a pas vraiment l'indication de ce que fait cette fonction, alors si c'est moi qui vais écrire la fonction peut-être que je saurai, mais peut-être que je ne me souviens plus d'ailleurs Et surtout si j’ai écrit cette fonction pour quelqu'un d'autre ce quelqu'un d'autre ne saura pas à quoi correspond cette fonction. Dans un premier temps on va l'utiliser quand-même, pour voir ça, reapeatstring 5. On va effacer ça en dessous pour pas que ça vous pollue l'esprit. Et là on va aller faire un tour, le simulateur ça veut pas la peine que je vous montre puisqu'au final, ce qu'on va faire c'est qu'on va imprimer ça d'ailleurs. Je ne sais pas si vous l'avez vu mais le repeatString pour l'instant il se passe rien parce que je l'ai pas affiché. On va faire un print, des repeat String, sinon il n'y a rien qui va s'afficher. On va relancer, c'est pas utile que je vous montre un simulateur qui est caché là pour le coup, ce qui est vous importe, voilà c'est ça le Hello Hello Hello Hello Hello. OK. Alors on va faire un commande clique pour aller directement à l'endroit, ça fonctionne, et là on va ajouter des commentaires. Donc il y a plusieurs façons alors, d'abord il y a comme on sait depuis 43 ans des façons écrire des commentaires, tout d'abord des commentaires one Line, comme ça ; Et ensuite des commentaires multiline, comme ça, Voilà, comme ça. Donc ça c'est rien de nouveau, ça existe depuis très très longtemps. Retenez ça deux secondes, parce que ce qu'on va faire maintenant c'est qu'on va faire comme ça, on va mettre deux au lieu d'un au départ. Et terminer comme ça, OK. Et là ça va être utile, donc on va enlever ceci, ici on va voir, ici j'hésitais entre le français ou l'anglais, on va rester en français. Fonction qui retourne times fois la str, OK Et alors ce qui est bien, c'est que quand je vais aller ensuite dans mon View Contrôleur et que je vais aller sur ma fonction, si je vais dans la Quick Help vous rappelez qu’on avait parlé de Quick Help, j'ai effectivement ici fonction qui retourne times voilà str, OK Si j’avais pas mis ce commentaire, je n'aurai rien au niveau d’inscription. Tout d'abord deux choses, la première chose c'est que si j’écris ici le repeatString, vous voyez qu'ici en dessous j'ai la fonction qui retourne times for la str, alors comment c’était pas le cas du tout. D'ailleurs c'est pas le cas de premier repeat, OK ? Et c'est pas le cas du tout, c'est pas le cas de constant, par exempte, OK. Alors il y a une façon plus simple de voir ça, c'est tout simplement d'aller dans la repeatstring, et de se mettre à l'endroit où j'ai déclaré. Voyez que là, elle est directement là, il suffit que je me mette en dessous, il se pratique parce que ça me permet de voir tout de suite. Alors il y a deux ou trois autres choses qu'on peut rajouter, c'est ce qu'on appelle du MarkDown, alors je vous laisserais rechercher le MarkDown, ça s’écrit comme ça MarkDown Le MarkDown c'est quelque chose qui a été inventé par John Gruber. John Gruber est connu pour être le postcasteur derrière un potcast assez connu, et un site WEB assez connu aussi. Mais à la base il était développeur, il y a très très très longtemps, dans une autre vie et il a développé le MarkDown pour les blogueurs en gros. Et le MarkDown c'est un système de formatage, qui par exemple me permet d'écrire par exemple avec un underscore, underscore, ça va me formater ça en gras. Voyez qu'ici le times est en gras. Ayez aussi la possibilité d'atricher un formatage de code avec ce qu'on appelle des Baptiques, voyez si je vais là, ça ce sera une autre police en gros, C'est une police qui a donc toujours la même taille, alors que l'autre pas, OK. Alors je peux combiner les deux d'ailleurs, je peux faire underscore, underscore, et là ça devrait fonctionner, ça devrait laisser les deux, OK. Donc vous voyez que c'est toujours les deux à la fois. Donc voilà je vous laisserai chercher vous-même tout ce qu'on peut faire à MarkDown, maintenant on va passer à la suite qui est de voir comment spécifier les paramètres. Pour ça on fait paraméter, times : Nombre de fois par exemple, OK. Et si je veux en mettre un deuxième, je vais le copier une fois de plus tout simplement. Faites attention avec copier coller, c'est pas toujours super smart, ça risque que vous claquez dans les doigts. Et là on va dire tout simplement A afficher OK ? On va voir ici qu'est-ce qui se passe, on va voir qu'ici on a effectivement Parameters, Times et str à afficher. Nombre de fois à afficher. Alors on continue, il ya une valeur de retour la valeur de retour, on peut la définir aussi une fois de plus avec un - et avec un returns, une valeur concaténée, OK. On va voir ici, Returns, une valeur concaténée. voyez, ça c'est quand même sympa. Alors plusieurs remarques par rapport à ce que je viens de vous montrer d'abord ne commentez pas en français, évidemment c’était pour vous montrer un peu, mais quand on commente en général on travaille plutôt dans une équipe. On sait jamais qui va rentrer dans l'equipe, donc faites-vous du mal et surtout quand vous déclarez une APE, une APE est tout ce qui est en commentaires notamment à taper en anglais. On n'est pas vraiment informaticien, si on n'a pas un minimum de base en anglais donc tapez tout en anglais. Même chose avec vos paramètres, ne les nommez pas en français, sauf s'il y a une raison vraiment spécifique. Je sais que nous on avait un produit par exemple allemand, qui avait vraiment un nom allemand donc on ne l'a pas anglicisé mais en général restez en anglais, et puis pour le reste, voilà comment définir une APE, puisque tout ça sera toujours évidemment je vous rappelle à tout moment où vous utiliserez ceci, donc dès que vous écrirez ici verrez qu'on peut faire le repeatString, voyez,qu'il y a quelque chose qui s'affiche ici, et ensuite on à chaque fois l'explication qui est donc dans l'APE ici, si vraiment se souvient plus de ce que c’est.

Découvrir Xcode 7

Explorez l’interface et les fonctionnalités d’Xcode 7. Gagnez ainsi en productivité lors du développement de vos applications iOS, OS X, watchOS et tvOS.

Aucun commentaire n´est disponible actuellement
 
Logiciel :
Spécial abonnés
Date de parution :4 mai 2016

Votre formation est disponible en ligne avec option de téléchargement. Bonne nouvelle : vous ne devez pas choisir entre les deux. Dès que vous achetez une formation, vous disposez des deux options de consultation !

Le téléchargement vous permet de consulter la formation hors ligne et offre une interface plus conviviale. Si vous travaillez sur différents ordinateurs ou que vous ne voulez pas regarder la formation en une seule fois, connectez-vous sur cette page pour consulter en ligne les vidéos de la formation. Nous vous souhaitons un excellent apprentissage avec cette formation vidéo.

N'hésitez pas à nous contacter si vous avez des questions !