Så här börjar du med kakao

I denna handledning lär du dig information om chefen för beroende av CocoaPod och hur du implementerar den i din app. Vi går igenom stegen från att skapa ett Xcode-projekt hela vägen för att importera ramar. Längs vägen kommer vi att lära oss om några grundläggande Terminalkommandon och vad de gör.

Om CocoaPods

Innan vi går in på att faktiskt implementera CocoaPods i vårt Xcode-projekt, låt oss prata lite om vad det är och varför ska du använda det i första hand.

Vad är kakaoPods?

CocoaPods är en dependence manager för Swift och Objective-C Cocoa-projekt. Den har över 35 tusen bibliotek och används i över 2,4 miljoner apps. CocoaPods kan hjälpa dig att skala dina projekt elegant. - CocoaPods hemsida

CocoaPods blir alltmer populär idag för Cocoa Touch-utveckling och med god anledning. CocoaPods är en enkel att använda, lätt att implementera dependency manager för dina appar skrivna i Swift eller Objective-C.

Vad heck är en Dependency Manager?

Glad att du frågade! Kort sagt, en dependency managerär ett verktyg som används för att hantera ramar från tredje part. I CocoaPods anges beroenden i en textfil kallad a podfile(som vi kommer att få till kort) med enkla enlinjedeklarationer. 

Detta löser problemet med att ladda ner och lägga till varje ram manuellt till ditt Xcode-projekt och sedan radera och installera omoderna ramar (det är bara en smärta). Vissa bibliotek använder även sina egna ramar i deras SDK (t.ex. Firebase), och varje gång de gör en liten uppdatering måste du manuellt installera om allt!

Varför ska jag använda CocoaPods??

Även om det finns andra beroendeförvaltare där ute (som Carthage) är CocoaPods fortfarande den mest använda, och har därför de flesta bibliotek tillgängliga för din användning. Eftersom det är mest populärt finns det också fler diskussioner om StackOverflow och andra forum, vilket är användbart om du någonsin fastnar.

Låt oss tänka på ett gemensamt scenario: något som CocoaPods (eller någon dependence manager) kan lösa. Du bestämde dig för att bygga en app. Den här appen är enorm, och du vill inte skriva om kod som någon annan redan har skrivit, så du skapar en lista över bibliotek som du tycker är bra att ha i ditt projekt. Det skulle vara nästan omöjligt att kunna installera dem manuellt och i framtiden korrekt i koden samtidigt!Det här är där CocoaPods kommer in.

Använda CocoaPods

CocoaPods är byggd med Ruby, som installeras som standard på versioner av macOS. I denna handledning kommer vi att använda pärla att installera de nödvändiga Ruby-ädelstenarna för att få CocoaPods upprättad. Gems är Ruby-paket, och eftersom CocoaPods är ett Ruby-program, måste det installeras med Rubys paketchef.

För att starta, öppna ett nytt terminalfönster. Du hittar det här i tillämpningar > verktyg eller du kan helt enkelt söka efter det i Spotlight Search (Kommando-Space).

1. Installation

Ange följande rad kod i din terminal.

$ sudo pärla installera cocoapods

Tryck sedan på Stiga på. Du kommer att uppmanas att ange ditt lösenord, och när du har gjort det, tryck på Stiga på igen. När du gör det kommer CocoaPods installera, och när det är klart ska din terminal se något ut så här:

2. Skapa ett Xcode-projekt

KakaoPods kan läggas till i ett existerande Xcode-projekt, men med tanke på denna handledning, låt oss skapa en ny. Tveka inte följa med ditt eget Xcode-projekt och hoppa över det här steget.

Starta Xcode

Efter att du startat Xcode ser du tre alternativ. Klicka på det andra alternativet som säger Skapa ett nytt Xcode-projekt. Om du har använt Xcode tidigare så kommer dina senaste projekt att visas till höger.

Välj din applikationstyp

För det här projektet väljer vi en enda visningsprogram, men du kan välja vilken mall du behöver för dina specifika ändamål.

Konfigurera ditt projekt

Nämna ditt projekt och välj Swift som språk. Här kan du också ställa in buntidentifieraren och välja de enheter som din app skulle stödja. Återigen är det upp till dig, men jag kommer att namnge det CocoaPods.

3. Skapa en Podfile

När du har skapat ett Xcode-projekt är nästa steg att navigera till det med terminalen. Många av er kanske bekanta med detta, men låt oss gå över det tillsammans; Trots allt övar praktiken perfekt!

Hitta projektkatalogen

Innan du kan navigera till projektkatalogen med kommandoraden är det en bra idé att hitta ditt projekt med hjälp av Finder först. I det här fallet är mitt projekt på min skrivbord i en mapp som heter tuts+.

Grundläggande kommandon

  • sudo-ett sätt att åsidosätta användarens privilegier och bli en superanvändare av datorn. Det är därför det kräver ett administratörslösenord när du använder det. Vi använde detta kommando när du installerade CocoaPods tidigare.
  • ls-listar allt innehåll i den aktuella katalogen. Det här kommandot är till nytta om du inte vill använda Finder för att bläddra i filer. du kan helt enkelt lista dem med hjälp av det här kommandot i din terminal.
  • CD -Detta kommando används för att ändra kataloger. Om du skriver CD ensam kommer du att flytta ur den aktuella katalogen. Efter användning ls (för att se katalogerna) kan du skriva namnet på den katalog du vill skriva in.
  • vim-Detta är en av mina favoriter. Kom ihåg det podfile som jag nämnde tidigare? Du kan redigera den här filen med standard TextEdit, men jag gillar att använda terminalen. vim är en kommandorads textredigerare som vi ska använda för att redigera vår podfile.

Några bonusar: Dessa är inte nödvändiga just nu, men hej, varför inte lära dig några mer coola saker medan du är på den?

  • mkdir -du kan snälla berätta vad den här gör med sitt namn; det gör en katalog (nu var det inte så svårt, var det?). Du måste skriva namnet på katalogen efter sökordet mkdir och voila, där har du en mapp som visas (nästan) direkt.
  • hjälp-Detta kommando är trevligt för att det (som namnet antyder) hjälper dig ut om du någonsin glömmer ett kommando. Bara Skriv hjälp i ditt Terminal-fönster, och en lista med grundläggande kommandon kommer att dyka upp med deras mening.

Initialisera CocoaPods

Eftersom du redan har installerat CocoaPods på din maskin, är nästa sak att göra faktiskt att initiera ditt Xcode-projekt. Ta reda på var ditt projekt ligger på din hårddisk och följ med i din egen katalog.

När du är färdig med att navigera till ditt projekt via terminalen ska ditt fönster se ut så här. Jag har markerat mitt projektnamn, och ditt ska visas på samma plats. Det borde se ut så här:

När du är i din projektkatalog måste du initialisera CocoaPods, vilket resulterar i en podfile skapas. För att göra detta skriver du följande rad i ditt terminalfönster:

$ pod init

Detta kommer att initiera CocoaPods i din projektmapp, och du kommer att se en fil som heter podfile dyka upp.

4. Ställ in biblioteken

hurra! CocoaPods är nu redo att hantera ditt projekt beroenden. Nästa steg är att faktiskt lägga till de önskade biblioteken i ditt Xcode-projekt - det är ju det vi är här för.

Redigera Podfile

Kom ihåg vim, Textredigeraren? Vi kommer att använda det för att lägga till de önskade ramarna till appen. Skriv följande rad för att redigera din podfile:

$ vim podfile

För att komma in i redigeringsläge skriver du bara jag, som i "insert."

Lägg till Pods till Podfile

I CocoaPods finns det två sätt att få kommandot för den ram du vill ha. Du kan vanligtvis hitta podfile-linjen i rammens GitHub-projektbeskrivning. Om inte, gå till CocoaPods hemsida och sök efter biblioteket där och deras podfile linjer.

Nedan har jag en linje för Firebase. 

pod 'Firebase / Core'

Som jag sa, spelar det ingen roll om var du får dem ifrån. Hitta en av dessa och följ stegen nedan. Ange nu din rad under kommentaren som säger:

# Pods för 

Det är allt som behövs för att lägga till ramar. Se hur lätt det var? Nu måste vi avsluta vim redaktör och gå vidare till nästa steg.

Avsluta vim Redaktör

För att spara dina ändringar och avsluta vim redaktör, du behöver:

  1. tryck på Esc nyckeln för att komma ur redigeringsläget.
  2. Typ : x (spara och avsluta kommandot).
  3. Tryck Stiga på.

Installera CocoaPods

Detta steg är ett annat en-liner. Allt du behöver göra är att skriva följande kommando i din projektkatalog:

$ pod installera

Detta laddar ner alla ramar du listade i din podfile och installerar dem i ditt Xcode-projekt. Båtarna ska nu vara tillgängliga för import, precis som en vanlig ram skulle vara (genom att använda importera längst upp i din källfil).

5. Sammanfattning

Jag hoppas att denna handledning var till hjälp. Vi täckte installera CocoaPods, grundläggande terminalkommandon, och hur du lägger till podar i din podfile. CocoaPods är ett snabbt, lättanvänt och effektivt verktyg för att hantera dina beroende, och det är mycket vanligt förekommande.

Och kom ihåg:

  • Du behöver bara komma åt ditt projekt via .xcworkspace och inte .xcodeproj.
  • Podfilen kan redigeras med någon textredigerare, och kan också redigeras i din Xcode.
  • Springa pod installera från terminalen efter att du har ändrat din podfile så att beroenden kommer att tas bort eller läggas till.

Medan du är här, kolla in några av våra andra inlägg på kodande iOS-appar!