Come iniziare con CocoaPods

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.

Informazioni su CocoaPods

Prima di iniziare a implementare CocoaPods nel nostro progetto Xcode, parliamo un po 'di cosa è e perché dovresti usarlo in primo luogo.

Cos'è CocoaPods?

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.

Che diavolo è un Responsabile delle dipendenze?

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!

Perché dovrei usare CocoaPods?

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.

Utilizzando 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).

1. Installazione

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:

2. Creare un progetto Xcode

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.

Avvia Xcode

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.

Scegli il tipo di applicazione

Per questo progetto, sceglieremo un'applicazione a vista singola, ma puoi scegliere qualsiasi modello necessario per i tuoi scopi specifici.

Configura il tuo progetto

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.

3. Creare un Podfile

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!

Trova la directory del progetto

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+.

Comandi di base

  • 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.

Inizializza CocoaPods

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.

4. Impostare le librerie

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.

Modifica il file Pod

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".

Aggiungi pod al file Pod

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.

Uscendo dal vim editore

Al fine di salvare le modifiche e uscire dal vim editor, è necessario:

  1. premi il Esc chiave per uscire dalla modalità di modifica.
  2. genere :X (il comando salva e chiudi).
  3. stampa accedere.

Installa CocoaPods

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).

5. conclusione

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:

  • Avrai bisogno di accedere al tuo progetto solo attraverso .xcworkspace e non .xcodeproj.
  • Il podfile può essere modificato utilizzando qualsiasi editor di testo e può anche essere modificato all'interno del tuo Xcode.
  • Correre 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!