Comment débuter avec CocoaPods

Dans ce didacticiel, vous découvrirez le gestionnaire de dépendances CocoaPods et comment l’implémenter dans votre application. Nous allons suivre les étapes de la création d'un projet Xcode jusqu'à l'importation de frameworks. En cours de route, nous découvrirons quelques commandes de base du terminal et leur rôle..

À propos de CocoaPods

Avant de commencer à implémenter CocoaPods dans notre projet Xcode, parlons un peu de ce que c'est et de la raison pour laquelle vous devriez l'utiliser dès le départ..

Qu'est-ce que CocoaPods??

CocoaPods est un gestionnaire de dépendance pour les projets Swift et Objective-C Cocoa. Il compte plus de 35 000 bibliothèques et est utilisé dans plus de 2,4 millions d'applications. CocoaPods peut vous aider à dimensionner vos projets avec élégance. - Site CocoaPods

CocoaPods devient de plus en plus populaire pour le développement de Cocoa Touch - et pour cause. CocoaPods est un gestionnaire de dépendances facile à utiliser et à mettre en œuvre pour vos applications écrites en Swift ou Objective-C.

Qu'est-ce que le diable est un Gestionnaire de dépendances?

Content que tu aies demandé! En bref, un gestionnaire de dépendanceest un outil utilisé pour gérer les frameworks tiers. Dans CocoaPods, les dépendances sont répertoriées dans un fichier texte appelé podfile(que nous verrons tout à l'heure) avec de simples énoncés d'une ligne. 

Cela résout le problème du téléchargement et de l'ajout manuel de chaque infrastructure à votre projet Xcode, puis de la suppression et de la réinstallation des infrastructures obsolètes (ce n'est qu'un problème). Certaines bibliothèques utilisent même leur propre framework dans leur SDK (tel que Firebase), et chaque fois qu’elles effectuent une petite mise à jour, vous devez tout réinstaller manuellement.!

Pourquoi devrais-je utiliser CocoaPods?

Bien qu'il existe d'autres gestionnaires de dépendances (tels que Carthage), CocoaPods est toujours le plus utilisé et, par conséquent, il contient le plus grand nombre de bibliothèques disponibles. Comme c'est le plus populaire, il y a aussi plus de discussions à ce sujet sur StackOverflow et d'autres forums, ce qui est utile en cas de blocage..

Pensons à un scénario commun: quelque chose que CocoaPods (ou tout gestionnaire de dépendance) peut résoudre. Vous avez décidé de créer une application. Cette application est énorme, et vous ne voulez pas réécrire du code déjà écrit par quelqu'un d'autre. Vous créez donc une liste de bibliothèques que vous pensez pouvoir utiliser dans votre projet. Il serait presque impossible de tous les installer correctement et de protéger votre code pour le futur en même temps.!C'est ici qu'intervient CocoaPods.

Utiliser CocoaPods

CocoaPods est construit avec Ruby, qui est installé par défaut sur les versions de macOS. Dans ce tutoriel, nous utiliserons gemme pour installer les gemmes Ruby nécessaires à la configuration de CocoaPods. Les gemmes sont des paquets Ruby, et comme CocoaPods est un programme Ruby, il doit être installé avec le gestionnaire de paquets de Ruby..

Pour commencer, ouvrez une nouvelle fenêtre de terminal. Vous pouvez le trouver dans Applications > Utilitaires ou vous pouvez simplement le rechercher dans Spotlight Search (Command-Space).

1. Installation

Entrez la ligne de code suivante dans votre terminal.

$ sudo gem installer des cocoapods

Puis appuyez Entrer. Vous serez invité à entrer votre mot de passe, puis appuyez sur Entrer encore. Après cela, CocoaPods s’installera et, une fois terminé, votre terminal devrait ressembler à ceci:

2. Créer un projet Xcode

CocoaPods peut être ajouté à n’importe quel projet Xcode existant, mais pour les besoins de ce tutoriel, créons-en un nouveau. N'hésitez pas à suivre votre propre projet Xcode et à ignorer cette étape..

Lancer Xcode

Après avoir lancé Xcode, vous verrez trois options. Cliquez sur la deuxième option qui dit Créer un nouveau projet Xcode. Si vous avez utilisé Xcode par le passé, vos projets récents apparaîtront à droite..

Choisissez votre type d'application

Pour ce projet, nous choisirons une application à vue unique, mais vous pouvez choisir le modèle dont vous avez besoin pour vos besoins spécifiques..

Configurez votre projet

Maintenant, nommez votre projet et choisissez Swift comme langue. Ici, vous pouvez également définir l'identifiant de l'ensemble et choisir les appareils que votre application prendrait en charge. Encore une fois, c'est à vous de décider, mais je vais le nommer CacaoPods.

3. Créer un podfile

Une fois que vous avez créé un projet Xcode, l'étape suivante consiste à y accéder à l'aide du terminal. Beaucoup d’entre vous sont peut-être au courant de cela, mais examinons-le ensemble; après tout, la pratique rend parfait!

Trouver le répertoire du projet

Avant de pouvoir accéder au répertoire du projet à l'aide de la ligne de commande, il est conseillé de commencer par localiser votre projet à l'aide du Finder. Dans ce cas, mon projet est sur mon bureau dans un dossier nommé Tuts+.

Commandes de base

  • sudo-un moyen de remplacer les privilèges de votre utilisateur et de devenir un super-utilisateur de l'ordinateur. C'est pourquoi il nécessite un mot de passe administrateur pour l'utiliser. Nous avons utilisé cette commande en installant CocoaPods plus tôt.
  • ls-répertorie tout le contenu du répertoire en cours. Cette commande est pratique si vous ne souhaitez pas utiliser le Finder pour parcourir les fichiers; vous pouvez simplement les lister en utilisant cette commande dans votre terminal.
  • CD -cette commande est utilisée pour changer de répertoire. Si vous écrivez CD seul, vous sortirez du répertoire en cours. Après avoir utilisé ls (pour voir les répertoires), vous pouvez écrire le nom du répertoire que vous voulez entrer.
  • vim-c'est l'un de mes favoris. Se souvenir du podfile que j'ai mentionné plus tôt? Vous pouvez éditer ce fichier en utilisant le TextEdit par défaut, mais j'aime bien utiliser le terminal. vim est un éditeur de texte en ligne de commande que nous utiliserons pour éditer notre podfile.

Quelques bonus: Celles-ci ne sont pas nécessaires pour le moment, mais pourquoi ne pas apprendre des choses plus cool pendant que vous y êtes?

  • mkdir -vous pouvez en quelque sorte dire ce que celui-ci fait par son nom; cela crée un répertoire (maintenant ce n'était pas si difficile, n'est-ce pas?). Vous devez taper le nom du répertoire après le mot clé mkdir et voila, vous avez un dossier qui apparaît (presque) instantanément.
  • Aidez-moi-cette commande est agréable car (comme son nom l'indique), elle vous aide si vous oubliez jamais une commande. Il suffit de taper Aidez-moi dans votre fenêtre de terminal, et une liste de commandes de base apparaîtra avec leur signification.

Initialiser CocoaPods

Puisque vous avez déjà installé CocoaPods sur votre machine, la prochaine chose à faire est d’initialiser votre projet Xcode. Recherchez l'emplacement de votre projet sur votre disque dur et suivez-le dans votre propre répertoire..

Une fois que vous avez terminé la navigation vers votre projet via le terminal, votre fenêtre devrait ressembler à ceci. J'ai mis en évidence le nom de mon projet et le vôtre devrait apparaître au même endroit. Ça devrait ressembler a quelque chose comme ca:

Une fois dans le répertoire de votre projet, vous devrez initialiser CocoaPods, ce qui entraînera une podfile Étant créé. Pour ce faire, tapez la ligne suivante dans la fenêtre de votre terminal:

$ pod init

Ceci initialisera CocoaPods dans votre dossier de projet et vous verrez un fichier appelé podfile arriver.

4. Configurer les bibliothèques

Hourra! CocoaPods est maintenant prêt à gérer les dépendances de votre projet. La prochaine étape consiste à ajouter les bibliothèques souhaitées dans votre projet Xcode. Après tout, nous sommes là pour vous aider..

Editer le podfile

Rappelles toi vim, l'éditeur de texte? Nous allons l'utiliser pour ajouter les cadres souhaités à l'application. Tapez la ligne suivante pour éditer votre podfile:

$ vim podfile

Pour entrer en mode édition, il vous suffit de taper je, comme dans "insérer".

Ajouter des pods au podfile

Dans CocoaPods, il existe deux méthodes pour obtenir la commande correspondant à la structure que vous souhaitez. Vous pouvez généralement trouver la ligne podfile dans la description du projet GitHub du framework. Sinon, allez sur le site CocoaPods et cherchez la bibliothèque et les lignes de podfiles.

Ci-dessous, j'ai une ligne pour Firebase. 

pod 'Firebase / Core'

Comme je l'ai dit, peu importe d'où vous les tirez. Trouvez-en un et suivez les étapes ci-dessous. Maintenant, entrez votre ligne sous le commentaire qui dit:

# Pods pour 

C'est tout ce qui est nécessaire pour ajouter des cadres. Vous avez vu comme c'était facile? Maintenant, nous devons sortir du vim éditeur et passez à l'étape suivante.

En sortant du vim Éditeur

Afin de sauvegarder vos modifications et quitter le vim éditeur, vous devez:

  1. appuyez sur la Esc touche pour sortir du mode édition.
  2. Type :X (les commandes save et exit).
  3. presse Entrer.

Installez CocoaPods

Cette étape est un autre one-line. Tout ce que vous avez à faire est de taper dans le répertoire de votre projet la commande suivante:

$ pod install

Cela téléchargera tous les frameworks que vous avez listés dans votre podfile et les installera dans votre projet Xcode. Les pods devraient maintenant être disponibles à l'importation, comme le ferait un cadre standard (en utilisant importation en haut de votre fichier source).

5. Conclusion

J'espère que ce tutoriel a été utile. Nous avons expliqué comment installer CocoaPods, les commandes de base du terminal et comment ajouter des pods à votre podfile. CocoaPods est un outil rapide, facile à utiliser et efficace pour gérer vos dépendances. Il est très couramment utilisé.

Et rappelez-vous:

  • Vous devrez accéder à votre projet uniquement via .xcworkspace et ne pas .xcodeproj.
  • Le podfile peut être édité à l’aide de n’importe quel éditeur de texte, mais également dans votre Xcode..
  • Courir installation de pod depuis le terminal après avoir changé votre podfile afin que les dépendances soient supprimées ou ajoutées.

Pendant que vous êtes ici, consultez certains de nos autres articles sur le codage des applications iOS.!