In questo tutorial, imparerai a conoscere il responsabile delle dipendenze di CocoaPods e come implementarlo nella tua app. Passeremo attraverso i passaggi dalla creazione di un progetto Xcode fino all'importazione di framework. Lungo la strada, scopriremo alcuni comandi di base del terminale e quello che fanno.
Prima di iniziare a implementare CocoaPods nel nostro progetto Xcode, parliamo un po 'di cosa è e perché dovresti usarlo in primo luogo.
CocoaPods è un manager delle dipendenze per i progetti di cacao Swift e Objective-C. Ha oltre 35 mila librerie e viene utilizzato in oltre 2,4 milioni di app. CocoaPods può aiutarti a ridimensionare elegantemente i tuoi progetti. - Sito Web CocoaPods
CocoaPods sta diventando sempre più popolare al giorno d'oggi per lo sviluppo Cocoa Touch, e con buone ragioni. CocoaPods è un gestore delle dipendenze facile da usare e facile da implementare per le tue app scritte in Swift o Objective-C.
Sono contento che l'abbiate chiesto! In breve, un manager delle dipendenzeè uno strumento utilizzato per gestire framework di terze parti. In CocoaPods, le dipendenze sono elencate in un file di testo chiamato a podfile(che arriveremo a breve) con semplici dichiarazioni a una riga.
Questo risolve il problema di dover scaricare e aggiungere ogni framework manualmente al progetto Xcode e quindi eliminare e reinstallare i framework obsoleti (è solo un problema). Alcune librerie utilizzano persino i propri framework nel loro SDK (come Firebase), e ogni volta che fanno un piccolo aggiornamento, devi reinstallare manualmente tutto!
Mentre ci sono altri manager delle dipendenze (come Cartagine), CocoaPods è ancora il più utilizzato e, quindi, ha la maggior parte delle librerie disponibili per il tuo uso. Dal momento che è il più popolare, ci sono anche altre discussioni su di esso su StackOverflow e altri forum, che è utile nel caso in cui ti trovi bloccato.
Pensiamo a uno scenario comune: qualcosa che CocoaPods (o qualsiasi responsabile delle dipendenze) può risolvere. Hai deciso di costruire un'app. Questa app è enorme, e non vuoi riscrivere il codice che qualcun altro ha già scritto, quindi crei un elenco di librerie che ritieni siano utili nel tuo progetto. Sarebbe quasi impossibile essere in grado di installarli tutti manualmente e a prova di futuro del codice allo stesso tempo!È qui che entra in gioco CocoaPods.
CocoaPods è costruito con Ruby, che viene installato di default sulle versioni di macOS. In questo tutorial, useremo gemma
per installare le gemme Ruby necessarie per configurare CocoaPods. Le gemme sono pacchetti Ruby e poiché CocoaPods è un programma Ruby, deve essere installato con il gestore pacchetti di Ruby.
Per iniziare, apri una nuova finestra di terminale. Puoi trovarlo in applicazioni > Utilità oppure puoi semplicemente cercarlo in Spotlight Search (Comando-Space).
Inserisci la seguente riga di codice nel tuo terminale.
$ sudo gem installa cocoapods
Quindi, premere accedere. Ti verrà richiesto di inserire la password e, quando lo avrai fatto, premi accedere ancora. Dopo averlo fatto, CocoaPods si installerà e, una volta terminato, il tuo terminale dovrebbe assomigliare a questo:
CocoaPods può essere aggiunto a qualsiasi progetto Xcode esistente, ma per gli scopi di questo tutorial, creiamo uno nuovo. Non esitate a seguire il vostro progetto Xcode e saltare questo passaggio.
Dopo aver lanciato Xcode, vedrai tre opzioni. Clicca sulla seconda opzione che dice Crea un nuovo progetto Xcode. Se hai usato Xcode in passato, i tuoi progetti recenti appariranno sulla destra.
Per questo progetto, sceglieremo un'applicazione a vista singola, ma puoi scegliere qualsiasi modello necessario per i tuoi scopi specifici.
Adesso dai un nome al tuo progetto e scegli Swift come lingua. Qui puoi anche impostare l'identificatore del gruppo e scegliere i dispositivi che la tua app supporterà. Di nuovo, spetta a te, ma lo chiamerò CocoaPods.
Dopo aver creato un progetto Xcode, il passo successivo è quello di navigare verso di esso utilizzando il terminale. Molti di voi potrebbero avere familiarità con questo, ma affrontiamolo insieme; dopotutto, la pratica rende perfetti!
Prima di poter accedere alla directory del progetto utilizzando la riga di comando, è una buona idea individuare il progetto prima di utilizzare il Finder. In questo caso, il mio progetto è sul mio desktop in una cartella denominata Tuts+.
sudo
-un modo per ignorare i privilegi dell'utente e diventare un superutente del computer. Questo è il motivo per cui richiede una password di amministratore quando lo si utilizza. Abbiamo usato questo comando durante l'installazione di CocoaPods in precedenza.ls
-elenca tutti i contenuti nella directory corrente. Questo comando è utile se non si desidera utilizzare il Finder per sfogliare i file; puoi semplicemente elencarli usando questo comando nel tuo Terminale.CD
-questo comando è usato per cambiare directory. Se scrivi CD
da solo, uscirai dalla directory corrente. Dopo aver usato ls
(per vedere le directory), puoi scrivere il nome della directory che vuoi inserire.vim
-Questo è uno dei miei preferiti. Ricorda il podfile che ho menzionato prima? Puoi modificare questo file usando il TextEdit predefinito, ma mi piace usare il terminale. vim
è un editor di testo da riga di comando che useremo per modificare il nostro podfile.Alcuni bonus: Non sono necessari in questo momento, ma hey, perché non imparare alcune cose interessanti mentre ci sei?
mkdir
-puoi dire che cosa fa questo con il suo nome; crea una directory (ora non era così difficile, vero?). Devi digitare il nome della directory dopo la parola chiave mkdir
e voilà, ecco apparire una cartella (quasi) all'istante.Aiuto
-questo comando è bello perché (come suggerisce il nome), ti aiuta se dimentichi un comando. Basta digitare Aiuto
nella finestra del Terminale, e un elenco di comandi di base mostrerà il loro significato.Dato che hai già installato CocoaPods sul tuo computer, la prossima cosa da fare è in realtà inizializzare il tuo progetto Xcode. Trova dove si trova il tuo progetto sul tuo disco rigido e segui nella tua directory.
Dopo aver terminato la navigazione verso il tuo progetto tramite il terminale, la tua finestra dovrebbe apparire così. Ho evidenziato il nome del mio progetto e il tuo dovrebbe apparire nello stesso punto. Dovrebbe assomigliare a qualcosa di simile a questo:
Una volta nella directory del progetto, sarà necessario inizializzare CocoaPods, con conseguente a podfile in fase di creazione. Per fare ciò, digitare la seguente riga nella finestra del terminale:
$ pod init
Questo inizializzerà CocoaPods nella cartella del tuo progetto e vedrai un file chiamato podfile mostrare.
Evviva! CocoaPods è ora pronto per gestire le dipendenze del progetto. Il prossimo passo è quello di aggiungere effettivamente le librerie desiderate nel tuo progetto Xcode - dopo tutto, questo è ciò per cui siamo qui.
Ricorda vim
, l'editor di testo? Lo useremo per aggiungere i framework desiderati all'app. Digita la seguente riga per modificare il tuo file pod:
$ vim podfile
Per entrare in modalità di modifica, basta digitare io
, come in "inserire".
In CocoaPods, ci sono due modi per ottenere il comando per il framework che desideri. Di solito è possibile trovare la linea podfile nella descrizione del progetto GitHub del framework. In caso contrario, vai al sito Web di CocoaPods e cerca la libreria lì e le loro linee di file pod.
Sotto, ho una linea per Firebase.
pod 'Firebase / Core'
Come ho detto, non importa da dove li prendi. Trova uno di questi e segui i passaggi seguenti. Ora inserisci la tua riga sotto il commento che dice:
# Pods per
Questo è tutto ciò che è necessario per aggiungere framework. Vedi com'è stato facile? Ora, dobbiamo uscire dal vim
editor e andare al passaggio successivo.
vim
editoreAl fine di salvare le modifiche e uscire dal vim
editor, è necessario:
:X
(il comando salva e chiudi).Questo passaggio è un altro one-liner. Tutto quello che devi fare è, nella tua directory di progetto, digitare il seguente comando:
$ pod install
Questo scaricherà qualsiasi framework che hai elencato nel tuo podfile e installalo nel tuo progetto Xcode. I pod dovrebbero essere ora disponibili per l'importazione proprio come farebbe un normale framework (usando importare
nella parte superiore del file sorgente).
Spero che questo tutorial sia stato utile. Abbiamo coperto l'installazione di CocoaPods, i comandi di base del terminale e come aggiungere pod al tuo file pod. CocoaPods è uno strumento veloce, facile da usare ed efficace per la gestione delle dipendenze ed è molto usato.
E ricorda:
.xcworkspace
e non .xcodeproj
.installazione pod
dal terminale dopo aver cambiato il tuo file pod in modo che le dipendenze vengano rimosse o aggiunte.Mentre sei qui, dai uno sguardo ai nostri altri post sulla codifica delle app iOS!