OCTO 31 Cocoapods Tutoriel d’étape
Publié à 09: 00hen cocoapods, intermédiaire, Swifportporluis r
Introduction
cocoapodes. Je suis sûr que vous avez entendu parler de cet outil.
C’est le responsable de l’agence le plus connu et utilisé dans le développement iOS.
est un outil fondamental qui facilitera votre vie Pour travailler avec des bibliothèques externes dans vos projets avec Swift et Objective-c.
Si vous n’avez jamais travaillé avec des cocoapodes, ce tutoriel est pour vous.
2. Qu’allez-vous apprendre dans ce didacticiel?
Ce sont les points les plus importants dans lesquels nous allons nous concentrer:
- Qu’est-ce que les cocoapodes?
- Pourquoi devrait-il Vous utilisez des cocoapodes sur vos projets iOS?
- Comment configurer un projet iOS avec cocoapodes?
Nous avons commencé!
3. Qu’est-ce que les cocoapodes?
Comme nous l’avons commenté au début, Cocoapods est un gestionnaire de dépendance pour les projets iOS. Mais commençons par base de base.
Qu’est-ce qu’un gestionnaire de dépendance?
Lorsque nous parlons de dépendances, nous nous référons aux bibliothèques externes que nous souhaitons intégrer dans nos projets. Si vous n’avez jamais intégré à une bibliothèque externe avant de vos projets IOS, je vous recommande de jeter un coup d’œil à l’un de nos derniers tutoriels, où vous pouvez voir étape par étape Ce processus:
Intégration des librairies externes dans votre Projets
Maintenant que vous comprenez déjà que nous parlons de lorsque nous parlons de dépendances, nous pourrions arriver à la conclusion que si Cocoapodes est un gestionnaire de dépendance, sa mission sera automatisée une partie de ce processus d’intégration et de maintenance. des bibliothèques externes dans nos projets.
Exactement, c’est sa fonction.
4. Pourquoi devriez-vous utiliser des cocoapodes dans vos projets iOS?
Si vous avez examiné le didacticiel que j’ai recommandé dans la section précédente, vous aurez vu étape par étape le processus manuel d’ajout d’une bibliothèque externe à Un projet iOS.
Fondamentalement, le processus comprend ceci:
- Recherchez le lien de téléchargement de la dernière version de la bibliothèque.
- Télécharger ladite librairie .
- Ajoutez le dossier avec la bibliothèque à notre projet en Xcode.
- Vérifiez si notre bibliothèque dépend des autres librairies.
- Si oui, téléchargez-les aussi.
- ajoutez-les à notre projet en Xcode.
Tout ce processus peut être effectué rapidement et facilement à l’aide de cocoapodes.
Si cela ne semble pas Assez avantage, je vais vous montrer un problème très courant qui peut survenir si vous n’utilisez pas de cocoapodes.
La malédiction des librairies
Imaginez que vous avez fabriqué manuellement ( sans utiliser de cocoapodes) la bibliothèque d’Afnetworking Dans l’un de vos projets.
Afnetworking est associé à Alamofire la bibliothèque de communication la plus importante et utilisée dans le développement iOS. Nous allons l’utiliser comme exemple dans le tutoriel Cocoapodes
Votre application fonctionne parfaitement avec Afnetworking. Un jour, Matt Thompson Le développeur principal de la librairie de la librairie libère une nouvelle version qui améliore la sécurité et corrige certains bugs importants détectés dans les versions précédentes.
Que faites-vous? C’est une nouvelle version qui augmente la sécurité des communications de la bibliothèque.
Ummm … Sécurité … On dirait que je dois mettre à jour la librairie si ou si.
Vous avez Pour accéder au référentiel Afnetworking, téléchargez à nouveau le SDK complet et ajoutez-le à votre projet iOS.
et si un mois après le retour de Matt Retour à la liberté d’une autre version?
Nous devrait répéter le processus à nouveau.
Et si au lieu d’un projet travaille-t-il sur 5 projets? Vous devriez avoir à mettre à jour toutes vos applications avec chaque nouvelle version.
Cela vous amènerait à devenir esclave à votre code.
cocoapodes vous permettrait d’automatiser la recherche, le téléchargement et l’intégration de nouvelles versions des bibliothèques externes de vos projets iOS.
Juste pour cette raison, vous devriez sérieusement vous voir l’utiliser.
Je ne vous ai toujours pas convaincu
Eh bien, comme la dernière mesure désespérée, je vous dirai qu’il existe une société bien connue qui l’utilise de manière intensive sur ses développements: Google
Si Google utilise des cocoapodes, cela signifie qu’il s’agit d’un excellent outil. Si nous, des développeurs, avons un excellent outil et c’est aussi gratuit, je ne peux penser à aucune raison de ne pas l’utiliser.
5. Installation de cocoapodes sur votre ordinateur
Installation Cocoapodes est un processus très simple.Il vous suffit d’ouvrir le terminal de votre système et d’écrire la commande suivante:
|
|
Sudo Gem installer cocoapodes
|
cocoapodes est distribué via Ruby et comme dans OS X, Ruby est disponible par défaut sur notre système, nous pouvons utiliser cette commande pour l’installer facilement.
Après avoir tapé cette instruction, nous serons invités à notre mot de passe administrateur pour continuer. Une fois que vous vous avez introduit, vous devrez attendre quelques instants jusqu’à la fin du processus d’installation. À la fin, quelque chose de similaire à celui-ci apparaîtra dans votre terminal:
Si une erreur s’est produite lors de l’installation i Je vous recommande de mettre à jour avec la dernière version de Ruby Gems avec la commande suivante, puis réessayez pour installer cocoapodes:
|
|
SUDO GEM MISE UPDATE –System
|
>
6. Utilisation de cocoapodes sur l’un de nos projets
Une fois que nous avons installé des cocoapodes, voyons comment l’utiliser.
Nous allons créer un projet de test en XCode pour montrer comment nous pouvons installer La bibliothèque d’Afnetworking A à Cocoapodes.
Si vous êtes intéressé par l’installation d’une autre bibliothèque dans l’un de vos projets, les étapes à suivre sont exactement les mêmes que nous allons voir avec Afnetworking
crée un nouveau projet en Xcode. Choisissez le modèle « Application d’affichage unique ». Vous pouvez le nommer des testsCocods. Laissez le reste des options comme vous le voyez dans l’image:
Lorsque vous enregistrez le projet, assurez-vous de sauvegarder sur votre bureau de votre Mac. Il est important de pouvoir suivre étape par étape. Ce tutoriel.
La prochaine chose que vous ferez, une fois que vous aurez créé et enregistré le projet sur votre bureau, il sera de fermer il. Oui, comme vous entendez, fermez votre projet et fermer Xcode. La première chose que nous allons faire est de configurer des cocoapodes sur notre projet et pour cela, nous n’avons pas besoin de xcode.
Ouvrez à nouveau le terminal et tapez la commande suivante:
|
1
|
CD ~ / bureau / testcocoapods
|
Cela nous permettra de naviguer dans le terminal à la route exacte où notre projet est enregistré.
Pour pouvoir configurer des cocoapodes dans n’importe quel projet, vous devez vous placer à l’aide du terminal de la route exacte où ce projet est enregistré
Création d’un podfile
la prochaine chose Nous ferons est de créer un podfile.
Un podfile est un fichier stocké dans le répertoire racine de notre projet et est responsable de la gestion des puits que nous souhaitons installer sur notre projet.
Oui, je sais ce que votre disciple est INTE Demandez: Et qu’est-ce qu’un pod?
Un POD est simplement une référence à une bibliothèque externe que nous souhaitons ajouter à notre projet.
En résumé, Cocoapods travaille de la Formulaire suivant:
- Nous avons créé un podfile à la racine de notre projet.
- Ce podfile aura une gousse pour chacune des bibliothèques que nous allons ajouter à notre Application.
- cocoapodes avant de changer de changement, utilisez le fichier de podfile pour savoir ce qu’il a à faire.
Allons ensuite pour l’étape 1.
Pour créer le podfile dans notre projet, tapez la commande suivante dans la borne:
Comme ceci:
|
> 11 |
# Définit la ligne suivante pour définir la plate-forme globale pour votre projet
> # Plate-forme: iOS, ’10 .0 ‘
cible’ testingcocoapodes ‘faire
# commentez la ligne suivante si vous n’utilisez pas Swift et que vous ne voulez pas utiliser dynamique Cadres
utilisez_frameworks!
# pods pour les testsCocoapodes
fin
|
>
En fait, si vous accédez au répertoire racine de votre projet, vous pouvez voir comment le fichier podfile apparaît juste là.
Ce serait la structure de base du podfile. Ce que nous devons faire maintenant, c’est éditer ce fichier pour ajouter nos gousses.
Modification du podfile avec VIM
pour créer la modification de ce fichier, nous utiliserons un éditeur nommé Vim. VIM est un programme incorporé dans chaque Mac qui vous permet d’éditer des fichiers texte directement à partir du terminal.
Pour éditer le podfile écrire la commande suivante dans votre terminal:
via cette commande s’accide sur Vim. Un écran comme celui-ci sera affiché dans votre terminal:
prise en compte de la bibliothèque que nous voulons intégrer dans notre projet Est Afnetworking, vous devrez éditer le podfile et ajouter la ligne suivante juste avant l’extrémité du fichier:
|
|
POD ‘afflexeworking’, ‘~ > 3.0’
|
L’aspect que votre podfile doit avoir après avoir ajouté cette ligne est le suivant:
« 447E9C98A6 »>
|
10 |
# Définissez la ligne suivante pour définir la plate-forme globale pour votre projet
# Platform: iOS, ’10 .0 ‘
Cible’ Testingcoods ‘fait
# La ligne suivante Si vous n’utilisez pas Swift et que vous ne voulez pas utiliser des frameworks dynamiques
user_frameworks!
# pods pour les testsCocoapodes
POD ‘Affletworking’, ‘~ > 3.0’
fin >
|
Une fois que nous aurons ajouté le gousson Afnetworking, nous devrons enregistrer les modifications et sortie.
Pour ce faire dans Vim, appuyez sur la touche ESC et tapez ceci:
|
1 |
|
>
Cela signifie, écrivez et arrêtez-vous. C’est-à-dire que vous enregistrez des modifications et fermez Vim.
Résumé du podfile
Avant de continuer, voyons un petit résumé du podfile:
- les lignes qui Ils apparaissent derrière # sont des commentaires, ils n’influencent donc pas vraiment notre fichier
- la première ligne que nous voyons est la cible «testCocoapodes». Ce qui spécifie cette ligne est le nom du projet où nous ajoutons des cocoapodes. Adoptez le nom de notre projet en Xcode.
- La ligne suivante est utilisée_frameworks! Cette ligne indique des cocoapodes que nous allons utiliser des cadres au lieu de bibliothèques statiques. Restez simplement avec cela que cette ligne est obligatoire lorsque vous travaillez avec des projets à Swift.
- La dernière ligne est POD ‘Afnetworking’, ‘~ > 3.0’ et définit que nous allons utiliser une force correspondant à la bibliothèque Afnetworking, avec une certaine version. Vous pouvez spécifier différentes versions à l’aide de certains opérateurs. Vous pouvez vérifier exactement ce que l’opérateur ~ > et le reste des opérateurs de cocoapodes, sur cette page.
à ce stade que vous avez Demandez comment j’ai connu le nom du POD que je dois utiliser pour ajouter la bibliothèque d’Afnetworking.
Vous avez deux options pour ce nom:
Option 1: via le responsable de la page : cocoapods.org
du site officiel de Cocoapodes, vous pouvez effectuer une recherche sur n’importe quelle bibliothèque que vous avez Voulez-vous ajouter à votre projet. Par exemple, si nous recherchons l’Afnetworking, vous verrez que vous obtenez une série de résultats en bas.Si vous cliquez sur la première option que vous proposez (qui correspond à la bibliothèque sans autre structure ajoutée) sera affichée sur le Web une section appelée Podfile où la ligne arrive que nous devrions ajouter dans notre fichier de podfile:
Option 2: directement dans la documentation de la bibliothèque
Si, par exemple, l’accès au travail Afnet Référentiel Vous pouvez voir comment il y a une section appelée installation avec des cocoapodes où il apparaît parfaitement expliqué l’aspect que votre fichier de podfile doit avoir à ajouter cette bibliothèque. Les bibliothèques les plus connues ont cette section dans leur documentation.
Maintenant que vous avez déjà compris 100% le Fonctionnement du fichier Podfile, allons avec la dernière commande que vous devez entrer dans votre terminal afin que les cocoapodes effectuent l’installation Afnetworking:
|
|
|
Cocoapodes commencera à télécharger la bibliothèque et à installer le gousson Afnetworking sur notre projet.
dix patience car il est probable que dans votre terminal apparaisse « Configuration de Cocoapods Master Repo » Pendant quelques minutes.
Le problème qui existe à ce stade est que le terminal ne nous montre pas à aucun moment si le processus d’installation est Advanz Ando correctement. Même si Cocoapodes est un outil très fiable, comme tout autre programme, il n’est pas parfait, il est donc possible que le processus de téléchargement / installation de notre bibliothèque soit gelé par une erreur et nous ne connaissons pas.
Profitant du moniteur d’activité
Il existe une petite astuce pour savoir si le processus effectue correctement le téléchargement.
Il vous suffit d’accéder au moniteur d’activité de votre Mac, accédez au réseau. section et recherchez le processus GIT-REMOTE-HTTPS. Ce processus est celui qui fait le travail d’installation de notre bibliothèque. Si vous voyez cela au cours de quelques secondes, les octets reçus ne sont pas avancés, je vous recommande d’annuler le processus à l’aide des touches CTRL + C à partir du terminal et répétez la commande d’installation.
Après le téléchargement et l’installation, un espace de travail sera créé dans votre projet appelé testcocoapods.xcworkspace. Cet espace de travail englobera votre projet original en Xcode et la librairie Afnetworking.
À partir de maintenant, pour ouvrir votre projet, vous devrez l’ouvrir à partir du fichier de testCocoapods.xcecworkspace au lieu d’utiliser comme toujours testcoapods.xcodeproj .
7. Vivre un œil sur l’aspect final de notre projet
Comme nous venons de dire, ouvrez votre projet en double-cliquant sur le fichier de testCocoapods.xcecworkspace.
Vous pouvez voir que dans notre espace de travail, nous avons deux projets:
- testcocoapodes (notre projet original)
- PODS (le projet qui contient notre travail Afnet Bibliothèque)
de cette manière, nous avons ajouté la bibliothèque Afnetworking et nous pouvons l’utiliser n’importe où dans notre projet.
Si vous souhaitez vérifier que tout fonctionne correctement, vous pouvez ajouter la ligne de code suivante à votre fichier ViewController.swift juste après l’importation Uikit:
|
|
|
Comme vous le voyez, Xcode ne donne aucune erreur et notre projet compile parfaitement.
Le plus chose importante à propos de Tout ce processus est que, à partir de maintenant, Cocoapodes gérera automatiquement la bibliothèque d’Afnetworking de notre projet. Nous n’aurons donc pas à craindre de faire ce travail.
8. Résumé final et téléchargement du projet
Ce sont les points les plus importants que nous avons vus dans le tutoriel de cette semaine:
- Qu’est-ce que les cocoapodes?
- Que Cocoapodes est-il?
- Avantages de l’utilisation de cocoapodes
- Comment configurer des cocoapodes sur vos projets iOS étape par étape
- Comment ajouter une bibliothèque externe à votre projet iOS Utilisation de cocoapodes
Vous pouvez télécharger le projet complet que nous avons développé après ce tutoriel d’ici.
9. Vous avez terminé le tutoriel
J’espère que vous avez apprécié ce tutoriel et surtout, il vous sert de pouvoir intégrer les cocoapodes dans vos projets IOS.
Comme toujours, voici la vidéo-chorra cette semaine (active le son de votre ordinateur car si ce n’est pas drôle).
Ne fait jamais mal de rire 😉
Où aller maintenant?
Vous pouvez accéder à plus de tutoriels disponibles dans EffecLeApple d’ici.
Si cet article a une ressemblance utile, Vous me feriez une grande faveur en partageant votre réseau social.