{"id":3010,"date":"2017-03-21T07:51:25","date_gmt":"2017-03-21T11:51:25","guid":{"rendered":"\/cours\/xcode\/wp\/?page_id=3010"},"modified":"2021-04-29T19:06:35","modified_gmt":"2021-04-29T19:06:35","slug":"gestion-de-versions-introduction-a-git","status":"publish","type":"page","link":"https:\/\/ve2cuy.com\/xcode\/gestion-de-versions-introduction-a-git\/","title":{"rendered":"Gestion de versions – Introduction \u00e0 git"},"content":{"rendered":"

git:<\/h1>\n

git<\/b> est un logiciel de gestion de versions qui, contrairement \u00e0 svn<\/a> ou csv<\/a>,  est d\u00e9centralis\u00e9. C’est un logiciel libre cr\u00e9\u00e9 par Linus Torvalds<\/a>, auteur du noyau Linux, et distribu\u00e9 selon les termes de la licence publique g\u00e9n\u00e9rale GNU version 2. En 2016, il s\u2019agit du logiciel de gestion de versions le plus populaire qui est utilis\u00e9 par plus de douze millions de personnes. (r\u00e9f: https:\/\/fr.wikipedia.org\/wiki\/Git<\/a>).
\nEn gros, c’est une application qui permet de garder plusieurs versions d’un fichier ou d’un projet et au besoin, de revenir \u00e0 une version pr\u00e9c\u00e9dente.
\nGit permet aussi de travailler sur des fonctionnalit\u00e9s additionnelles en parall\u00e8le au projet principal (branch) et de les r\u00e9int\u00e9grer (merge) une fois qu’elles sont au point.
\nL’application ‘git’ est install\u00e9e par d\u00e9faut sur MacOS et disponible \u00e0 partir d’une fen\u00eatre ‘terminal’.
\nSur Windows il faut l’installer: https:\/\/git-scm.com\/download\/win<\/a>
\nVoici un exemple d’utilisation de git sous MacOS:
\n\"\"<\/a><\/p>\n

Voici un sommaire des commandes disponibles \u00e0 partir de ‘terminal’:
\n[pdf-embedder url=\u00a0\u00bb\/xcode\/wp-content\/uploads\/2017\/03\/github-git-cheat-sheet.pdf\u00a0\u00bb]
\nNote<\/span><\/strong>: Heureusement pour nous, les fonctionnalit\u00e9s de base sont int\u00e9gr\u00e9es \u00e0 m\u00eame Xcode<\/strong>.  Dans la plupart des cas, il ne sera pas n\u00e9cessaire de recourir \u00e0 l’application ‘terminal’.<\/p>\n

\n

1 – Premiers pas avec ‘git’<\/h1>\n

Action.1.1<\/span><\/strong> – Cr\u00e9er un nouveau projet iOS ‘single View’ nomm\u00e9  ‘git-premiers-pas’ et cocher l’option ‘create git repository on my Mac<\/strong>‘ \u00e0 la fen\u00eatre de cr\u00e9ation du projet:
\n\"\"<\/a><\/p>\n

Action.1.2<\/span><\/strong> – Afficher le navigateur de contr\u00f4le de sources:
\n\"\"<\/a>
\nAction.1.3<\/span><\/strong> – V\u00e9rifier l’\u00e9tat ‘git’ du projet via le terminal.
\n\"\"<\/a>
\nAction.1.4<\/span> <\/strong>– Modifier le fichier AppDelegate.swift<\/p>\n

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {\n        \/\/ Override point for customization after application launch.\n        print(\"application:didFinishLaunchingWithOptions\")\n        return true\n    }<\/pre>\n
Note<\/span><\/strong>:  Remarquez le ‘M’ qui est apparu \u00e0 droite du nom du fichier:
\n\"\"<\/a>
\nIl nous indique que le fichier a \u00e9t\u00e9 modifi\u00e9 depuis le dernier ‘commit’.
\nL’\u00e9diteur de version permet permet d’observer les modifications entre les ‘commits’:
\n\"\"<\/a>
\nAction.1.5<\/strong><\/span> – Renseigner un nouveau commit:
\n\"\"<\/a> \"\"<\/a> \"\"<\/a> \"\"<\/a>
\nAction.1.6<\/strong><\/span> – Ajouter une ligne de code dans viewDidLoad et faire un commit:<\/p>\n
    override func viewDidLoad() {\n        super.viewDidLoad()\n        \/\/ Do any additional setup after loading the view, typically from a nib.\n        print(\"ViewController:viewDidLoad\")\n    }\n<\/pre>\n
\"\"<\/a><\/p>\n
\n
2 – Les branches<\/h1>\n
Les branches permettent de tester de nouvelles fonctionnalit\u00e9s \u00e0 l’ext\u00e9rieur de la branche principale (master) et de les r\u00e9int\u00e9grer lorsqu’elles sont au point.
\nNous allons cr\u00e9er une nouvelle branche pour r\u00e9aliser le design de l’application.
\nAction.2.1 –<\/span> <\/strong>Cr\u00e9er une nouvelle branche ‘design’
\n\"\"<\/a> \"\"<\/a>
\nAction<\/strong><\/span> – Compl\u00e9ter la cr\u00e9ation de la branche en cliquant sur le bouton ‘Create’
\nNote<\/span><\/strong>: Observer l’ajout de la nouvelle branche dans la fen\u00eatre suivante.  De plus, cette branche est devenue la branche courante.  Si nous apportons des modifications au projet, ils n’affecteront pas la branche de d\u00e9part (master).
\n\"\"<\/a><\/p>\n
Action.2.2<\/span><\/strong> – R\u00e9aliser le design de d\u00e9part:
\n\"\"<\/a>
\n\"\"<\/a>
\nAction.2.3<\/span><\/strong> – R\u00e9aliser le commit:
\n\"\"<\/a>
\nAction: Tester l’application!<\/span><\/strong>
\nAction.2.4<\/span><\/strong> – Retourner sur la branche ‘master’, l’option ‘checkout’
\n\"\"<\/a>
\n\"\"<\/a>
\nAction: Tester l’application!<\/span><\/strong>
\nAction.2.5<\/span><\/strong> – Ajouter la m\u00e9thode ‘afficher’ \u00e0 la class ViewController, appeler dans viewDidLoad et r\u00e9aliser un commit<\/p>\n
    func afficher(_ msg:String, fois:Int = 1) {\n        for i in 0...fois {\n            print(i, msg)\n        } \/\/ for\n    } \/\/ afficher<\/pre>\n
    override func viewDidLoad() {\n        super.viewDidLoad()\n        \/\/ Do any additional setup after loading the view, typically from a nib.\n        print(\"ViewController:viewDidLoad\")\n        afficher(\"Test\", fois: 3)\n    }\n<\/pre>\n
Note<\/strong><\/span>: Message du ‘commit’: Ajout de la m\u00e9thode afficher()
\nAction – Tester l’application.<\/span><\/strong><\/p>\n
\n
3. La fusion de deux branches<\/h1>\n
Nous allons maintenant fusionner la version ‘design’ dans la version ‘master’.
\nComme r\u00e9sultat, la version ‘master’ va h\u00e9riter de toutes les modifications apport\u00e9es au UI.
\nAction.3.1 – <\/span><\/span><\/strong>C<\/span><\/span>liquer<\/span><\/span> droit sur la branche \u00ab\u00a0design<\/strong>\u00a0\u00bb et s\u00e9lectionner l’option ‘Merge \u00ab\u00a0design\u00a0\u00bb into \u00ab\u00a0master\u00a0\u00bb‘<\/strong><\/span><\/span>
\n\"\"<\/a>
\nAction<\/span><\/strong> – Observer les changements propos\u00e9s
\n\"\"<\/a>
\nAction<\/strong><\/span> – Observer l’\u00e9tat du projet de la branche ‘master’.  Le travail de design a \u00e9t\u00e9 incorpor\u00e9 \u00e0 la branche ‘master’.
\n\"\"<\/a>
\nNote<\/span>: Il ne doit pas y avoir de ‘commits’ en suspends pour pouvoir r\u00e9aliser la fusion.
\n—<\/p>\n
\n
4 – Fusion avec conflits<\/h1>\n
Action.4.1<\/span><\/strong> version ‘master<\/strong>‘ ajouter la ligne suivante, suivi du commit \u00ab\u00a0Ajout de ‘je suis la ligne 15<\/strong>‘\u00a0\u00bb
\n\"\"<\/a>
\nAction.4.2<\/span><\/strong> – Passer \u00e0 la branche ‘design<\/strong>‘ et ajouter la ligne suivante , suivi du commit \u00ab\u00a0Ajout de ‘je suis aussi la ligne 15<\/strong>‘\u00a0\u00bb
\n\"\"<\/a>
\nAction.4.3<\/span><\/strong> – Fusionner ‘design’ dans master.
\n\"\"<\/a>
\nR\u00e9sultat, fusion automatique impossible, il faut intervenir:
\n\"\"<\/a>
\nChoix 1:
\n\"\"<\/a> Choix 2:
\n\"\"<\/a> Choix 3:
\n\"\"<\/a> Choix 4:
\n\"\"<\/a><\/p>\n
\n
5 – GitHub<\/h1>\n
GitHub propose un service ‘git’ en nuage.  Cela permet \u00e0 plusieurs personnes, de lieux diff\u00e9rents, de collaborer \u00e0 un m\u00eame projet.
\nVoici des exemples de projets disponibles sur GitHub:
\nswift<\/a>
\nlinux<\/a>
\natom<\/a>
\nbrackets<\/a>
\nreact<\/a>
\nbootstrap<\/a>
\nAlamofire<\/a>
\nlaravel<\/a><\/p>\n
\n
Nous allons maintenant envoyer notre projet sur gitHub.
\nAction 5.1 –<\/span><\/strong> Renseigner les param\u00e8tres de votre compte gitHub dans les pr\u00e9f\u00e9rences de Xcode:
\n\"\"<\/a> \"\"<\/a> \"\"<\/a> \"\"<\/a>
\nAction.5.2<\/span><\/strong> – Transf\u00e9rer le projet vers gitHub
\n\"\"<\/a> \"\"<\/a> \"\"<\/a> \"\"<\/a>
\nAction – V\u00e9rifier l’\u00e9tat du compte sur gitHub:
\n\"\"<\/a> \"\"<\/a>
\nNote<\/span><\/strong>:  Il n’y a que la branche courante qui a \u00e9t\u00e9 envoy\u00e9e sur GitHub.  Il faudra pousser (Push) les autres branches vers GitHub.<\/p>\n
Action.5.3<\/span><\/strong> – Changer de branche (checkout) et transf\u00e9rer la nouvelle branche courante (push)
\n\"\"<\/a><\/p>\n
Note<\/strong><\/span>:  Remarquez qu’Xcode propose de cr\u00e9er la nouvelle branche sur le site distant.
\n\"\"<\/a><\/p>\n
Action<\/span><\/strong> – V\u00e9rifier l’\u00e9tat du projet sut GitHub.  Entre autres, la liste des branches.
\n\"\"<\/a>
\nAction.5.4<\/span><\/strong> – Modification d’un fichier du projet via gitHub
\nNous allons ajouter un commentaire dans le fichier ViewController.swift en utilisant GitHub.
\nAction<\/span><\/strong> – Naviguer vers le fichier ‘ViewController.swift’
\n\"\"<\/a>
\nAction<\/span><\/strong> – Cliquer sur l’ic\u00f4ne du crayon pour \u00e9diter le fichier
\n\"\"<\/a><\/p>\n
Action<\/span><\/strong> – Ajouter le commentaire de la ligne 7
\n\"\"<\/a>
\nAction<\/span><\/strong> – Descendre au bas de la page web d’\u00e9dition et compl\u00e9ter le ‘commit’
\n\"\"<\/a>
\nNote<\/span><\/strong>: Le changement a \u00e9t\u00e9 effectu\u00e9 dans la branche ‘design’<\/p>\n
\n
Nous allons maintenant inclure ce changement \u00e0 notre copie locale.<\/h2>\n
Note<\/span><\/strong>: Assurez-vous d’\u00eatre sur la branche design.
\nAction.5.5<\/span><\/strong> – Synchroniser une branche avec la version sur gitHub (pull)
\n\"\"<\/a> \"\"<\/a><\/p>\n
Action<\/span><\/strong> – Observer les changements au fichier ViewController.swift
\n\"\"<\/a>
\nExtra<\/span><\/strong>: Introduction de 10 minutes \u00e0 gitHub<\/a><\/p>\n
\n
6 – Restaurer le projet \u00e0 un point dans le pass\u00e9.<\/h1>\n
Il est possible de d\u00e9placer la t\u00eate du projet \u00e0 n’importe quel ‘commit’ du projet.  Par contre, c’est une d\u00e9licate op\u00e9ration qu’il n’est pas possible de r\u00e9aliser \u00e0 partir de Xcode.
\nNote<\/span><\/strong>: Pour pr\u00e9venir une situation de d\u00e9placement de la t\u00eate – HEAD – vers l’arri\u00e8re, il est une bonne pratique de d\u00e9velopper des nouvelles fonctionnalit\u00e9s \u00e0 l’application sur une branche secondaire et de fusionner lorsque les tests de contr\u00f4le qualit\u00e9 auront \u00e9t\u00e9 r\u00e9alis\u00e9s.
\nRetournons voir l’historique des ‘commits’ de la branches ‘master’:
\nAction.6.1<\/span><\/strong> – A) Au besoin, r\u00e9aliser un ‘checkout<\/strong>‘ sur la branche ‘master<\/strong>‘.<\/p>\n
$ git checkout master<\/pre>\n
B) Entrer les 2 commandes suivantes:<\/p>\n
$ git log > gitlog.txt\n$ ls -l<\/pre>\n
\"\"<\/a>
\nAction.6.2<\/span> <\/strong>– Observer le contenu du fichier gitlog.txt<\/strong><\/p>\n
commit 5c6532f1d445d3e06ecd2dfc1c1896923d5a0b1e\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 14:52:55 2017 -0400\n    Ajout d'une autre ligne 15 suite au merge\ncommit 5d32c805d06f190fc226e08b4dfb9618c9789f22\nMerge: 7b68b44 c9d86f6\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 14:37:04 2017 -0400\n    Merge branch 'design'\ncommit c9d86f67587daa01bb0371d158b08097abb46a42\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 14:32:54 2017 -0400\n    Ajout de 'Je suis aussi la ligne 15'\ncommit 7b68b44be4fa2f21778c5e8fec02410f81574d9f\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 14:31:23 2017 -0400\n    Ajout de 'je suis la ligne 15'\ncommit 19d25f7400670aa8c01d36c8faea7ae611e1d6ac\nMerge: 2d87e2b 5572efa\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 14:25:16 2017 -0400\n    Merge branch 'design'\ncommit 2d87e2bc82636875c82da817c251c2a3bf1014b2        <------------------------\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 14:24:08 2017 -0400\n    Ajout de la m\u00e9thode afficher()                     <------------------------\ncommit 5572efa768c65553dce70d8d646ae1e355e86e28\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 14:03:35 2017 -0400\n    Prototype du design\ncommit c9c14277e279cb74de500ef4740212251a8a4ece\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 13:37:41 2017 -0400\n    Ajout d'une trace dans viewDidLoad\ncommit dfb787b201bfe96532c36d96570a5a17920481b4\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 13:25:11 2017 -0400\n    Ajout d'un message dans didFinishLaunching\ncommit 6d9c4fc1fcfd84d163cf92e5c80f03d24a420d99\nAuthor: Alain <alain@MacBook-Pro-de-Alain.local>\nDate:   Sat Oct 14 12:37:17 2017 -0400\n    Initial Commit\n<\/pre>\n
Note<\/span><\/strong>: Votre fichier gitlog.txt sera probablement diff\u00e9rent.
\nAction.6.3<\/span> <\/strong>– Identifier le SHA  du commit ‘Ajout de la m\u00e9thode afficher()<\/strong>‘
\nNote<\/span><\/strong>: Dans mon cas le SHA est \u00ab\u00a02d87e2bc8<\/strong>2636875c82da817c251c2a3bf1014b2<\/span>\u00a0\u00bb
\nAttention:  Il faut fermer le projet Xcode avant d’effectuer la prochaine op\u00e9ration.<\/span><\/strong>
\nAction.6.4<\/span> <\/strong>– D\u00e9placer la t\u00eate (HEAD) de la branche master en utilisant le SHA identifi\u00e9 \u00e0 l’\u00e9tape pr\u00e9c\u00e9dente.<\/p>\n
$ git reset --hard 2d87e2bc8\n$ git log<\/pre>\n
\"\"<\/a>
\n\"\"<\/a>
\n\"\"<\/a>
\nVoila!
\nNote:  Les commits qui suivaient SHA sont \u00ab\u00a02d87e2bc8<\/strong>2636875c82da817c251c2a3bf1014b2<\/span>\u00a0\u00bb toujours disponibles.  C’est pour cette raison que nous avons cr\u00e9\u00e9 le fichier gitlog.txt, au cas ou il faudrait revenir vers l’avant.<\/p>\n
\n
7 – Ouvrir, \u00e0 partir de Xcode, un projet stock\u00e9 sur gitHub<\/h1>\n
Action.7.1 – <\/span><\/strong>S\u00e9lectionner l’option ‘Clone<\/strong>‘ du menu ‘Source Control<\/strong>‘<\/span><\/span>
\n\"\"<\/a><\/p>\n
Action.7.2 – <\/span><\/strong>S\u00e9lectionner, dans la liste, le projet d\u00e9sir\u00e9.<\/span>
\n\"\"<\/a><\/p>\n
Action.7.3 –<\/span><\/strong> Renseigner le dossier d’enregistrement<\/span><\/span>
\n\"\"<\/a><\/p>\n
Action.7.4 – <\/span><\/strong>Travailler dans le projet local.<\/span>
\n\"\"<\/a>
\nNote<\/span><\/strong>:  Le projet clon\u00e9 est li\u00e9 au projet stock\u00e9 sur GitHub.  C-a-d, qu’il est possible de faire des ‘push’\/’pull’.
\nDe plus, vous avez seulement clon\u00e9 la branche active de GitHub.
\nIl faudra faire un ‘checkout’ pour pouvoir travailler sur d’autres branches du projet.
\n\"\"<\/a>
\n\"\"<\/a>
\n\"\"<\/a><\/p>\n
\n
\n
\n
Informations g\u00e9n\u00e9rales<\/h1>\n
1 – homebrew<\/strong> (gestionnaire de packages)<\/p>\n
ruby -e \"$(curl -fsSL https:\/\/raw.github.com\/Homebrew\/homebrew\/go\/install)\"<\/pre>\n
2 – git<\/strong> (devrait \u00eatre d\u00e9j\u00e0 install\u00e9 sur Mac OS)
\n3 – Git bash-completion<\/strong> (avec homebrew)<\/p>\n
brew install git bash-completion<\/pre>\n