Erste Schritte mit CocoaPods

In diesem Lernprogramm lernen Sie den CocoaPods-Abhängigkeitsmanager und seine Implementierung in Ihrer App kennen. Wir gehen die Schritte von der Erstellung eines Xcode-Projekts bis hin zum Importieren von Frameworks durch. Auf dem Weg erfahren wir einige grundlegende Terminalbefehle und was sie tun.

Über CocoaPods

Bevor wir CocoaPods tatsächlich in unser Xcode-Projekt implementieren, wollen wir ein wenig darüber sprechen, was es ist und warum Sie es überhaupt verwenden sollten.

Was ist CocoaPods??

CocoaPods ist ein Abhängigkeitsmanager für Swift- und Objective-C-Cocoa-Projekte. Es verfügt über mehr als 35.000 Bibliotheken und wird in über 2,4 Millionen Apps verwendet. Mit CocoaPods können Sie Ihre Projekte elegant skalieren. - CocoaPods-Website

CocoaPods wird heutzutage für die Entwicklung von Cocoa Touch immer beliebter - und das aus gutem Grund. CocoaPods ist ein benutzerfreundlicher, einfach zu implementierender Abhängigkeitsmanager für Ihre in Swift oder Objective-C geschriebenen Apps.

Was zum Teufel ist a Abhängigkeitsmanager?

Schön, dass Sie gefragt haben! Kurz gesagt, ein Abhängigkeitsmanagerist ein Tool zum Verwalten von Drittanbieter-Frameworks. In CocoaPods werden Abhängigkeiten in einer Textdatei mit dem Namen a aufgelistet podfile(dazu kommen wir in Kürze) mit einfachen einzeiligen Anweisungen. 

Dadurch wird das Problem gelöst, dass Sie jedes Framework manuell herunterladen und zu Ihrem Xcode-Projekt hinzufügen müssen. Anschließend müssen Sie veraltete Frameworks löschen und erneut installieren (das ist nur ein Problem). Einige Bibliotheken verwenden sogar eigene Frameworks in ihrem SDK (z. B. Firebase). Jedes Mal, wenn sie ein kleines Update durchführen, müssen Sie alles manuell neu installieren!

Warum sollte ich CocoaPods verwenden??

Es gibt zwar noch andere Abhängigkeitsmanager (z. B. Carthage), CocoaPods wird jedoch immer noch am häufigsten verwendet und verfügt daher über die meisten verfügbaren Bibliotheken. Da es das beliebteste ist, gibt es auch mehr Diskussionen über StackOverflow und andere Foren. Dies ist hilfreich, falls Sie einmal nicht weiterkommen.

Stellen wir uns ein allgemeines Szenario vor: etwas, das CocoaPods (oder jeder Abhängigkeitsmanager) lösen kann. Sie haben sich vorgenommen, eine App zu erstellen. Diese App ist enorm, Und Sie möchten keinen Code neu schreiben, den ein anderer bereits geschrieben hat. Erstellen Sie also eine Liste von Bibliotheken, die Ihrer Meinung nach in Ihrem Projekt gut sind. Es wäre fast unmöglich, alle Codes manuell und gleichzeitig zukunftssicher zu installieren!Hier kommt CocoaPods ins Spiel.

CocoaPods verwenden

CocoaPods wird mit Ruby erstellt, das standardmäßig unter MacOS-Versionen installiert wird. In diesem Tutorial werden wir verwenden Juwel um die notwendigen Ruby-Edelsteine ​​zu installieren, um CocoaPods einzurichten. Gems sind Ruby-Pakete. Da CocoaPods ein Ruby-Programm ist, muss es mit dem Paketmanager von Ruby installiert werden.

Öffnen Sie zum Starten ein neues Terminalfenster. Sie finden das in Anwendungen > Dienstprogramme oder Sie können einfach in Spotlight Search danach suchen (Befehlsraum).

1. Installation

Geben Sie die folgende Codezeile in Ihr Terminal ein.

$ sudo gem installiert cocoapods

Dann drücken Eingeben. Sie werden aufgefordert, Ihr Passwort einzugeben. Wenn Sie dies getan haben, drücken Sie Eingeben nochmal. Nachdem Sie dies getan haben, wird CocoaPods installiert, und nach Abschluss des Vorgangs sollte Ihr Terminal in etwa wie folgt aussehen:

2. Erstellen Sie ein Xcode-Projekt

CocoaPods kann zu jedem vorhandenen Xcode-Projekt hinzugefügt werden. Für dieses Lernprogramm erstellen wir jedoch ein neues. Bitte folgen Sie Ihrem eigenen Xcode-Projekt und überspringen Sie diesen Schritt.

Starten Sie Xcode

Nach dem Start von Xcode sehen Sie drei Optionen. Klicken Sie auf die zweite Option Erstellen Sie ein neues Xcode-Projekt. Wenn Sie Xcode in der Vergangenheit verwendet haben, werden rechts Ihre letzten Projekte angezeigt.

Wählen Sie Ihren Anwendungstyp

Für dieses Projekt wählen wir eine einzelne Ansichtsanwendung. Sie können jedoch jede Vorlage auswählen, die Sie für Ihre speziellen Zwecke benötigen.

Konfigurieren Sie Ihr Projekt

Benennen Sie nun Ihr Projekt und wählen Sie als Sprache Swift. Hier können Sie auch die Bundle-ID festlegen und die Geräte auswählen, die von Ihrer App unterstützt werden. Wieder liegt es an dir, aber ich werde es nennen Kakaopods.

3. Erstellen Sie eine Poddatei

Nachdem Sie ein Xcode-Projekt erstellt haben, navigieren Sie im nächsten Schritt mithilfe des Terminals. Viele von Ihnen kennen das vielleicht, aber gehen wir es gemeinsam durch; Übung macht den Meister!

Finden Sie das Projektverzeichnis

Bevor Sie mit der Befehlszeile zum Projektverzeichnis navigieren können, sollten Sie Ihr Projekt zunächst mit dem Finder suchen. In diesem Fall befindet sich mein Projekt auf meinem Desktop in einem Ordner mit dem Namen Tuts+.

Grundlegende Befehle

  • Sudo-eine Möglichkeit, die Privilegien Ihres Benutzers zu überschreiben und ein Superbenutzer des Computers zu werden. Aus diesem Grund ist für die Verwendung ein Administratorkennwort erforderlich. Wir haben diesen Befehl bereits bei der Installation von CocoaPods verwendet.
  • ls-listet den gesamten Inhalt des aktuellen Verzeichnisses auf. Dieser Befehl ist praktisch, wenn Sie den Finder nicht zum Durchsuchen von Dateien verwenden möchten. Sie können sie einfach mit diesem Befehl in Ihrem Terminal auflisten.
  • CD -Dieser Befehl wird zum Wechseln von Verzeichnissen verwendet. Wenn du schreibst CD Alleine verlassen Sie das aktuelle Verzeichnis. Nach dem Gebrauch ls (um die Verzeichnisse anzuzeigen), können Sie den Namen des Verzeichnisses eingeben, das Sie eingeben möchten.
  • vim-Dies ist einer meiner Favoriten. Erinnere dich an die podfile dass ich zuvor erwähnt habe? Sie können diese Datei mit dem Standard-TextEdit bearbeiten, aber ich benutze gerne das Terminal. vim ist ein Kommandozeilen-Texteditor, den wir zur Bearbeitung unserer verwenden werden podfile.

Einige Bonusse: Diese sind im Moment nicht notwendig, aber hey, warum lernt ihr nicht noch mehr coole Dinge, wenn ihr gerade dabei seid??

  • mkdir -Man kann sagen, was dieser an seinem Namen tut. es macht ein Verzeichnis (jetzt war das nicht so schwer, oder?). Sie müssen den Namen des Verzeichnisses nach dem Schlüsselwort eingeben mkdir und voila, da hast du einen ordner (fast) sofort.
  • Hilfe-Dieser Befehl ist nett, weil er (wie der Name schon sagt) hilft, wenn Sie einen Befehl vergessen. Schreib einfach Hilfe In Ihrem Terminalfenster wird eine Liste der grundlegenden Befehle mit ihrer Bedeutung angezeigt.

CocoaPods initialisieren

Da Sie CocoaPods bereits auf Ihrem Computer installiert haben, müssen Sie als Nächstes Ihr Xcode-Projekt initialisieren. Finden Sie heraus, wo sich Ihr Projekt auf Ihrer Festplatte befindet, und folgen Sie diesem in Ihrem eigenen Verzeichnis.

Nachdem Sie über das Terminal zu Ihrem Projekt navigiert haben, sollte Ihr Fenster so aussehen. Ich habe meinen Projektnamen hervorgehoben, und Ihr Name sollte an derselben Stelle erscheinen. Es sollte ungefähr so ​​aussehen:

Sobald Sie sich in Ihrem Projektverzeichnis befinden, müssen Sie CocoaPods initialisieren podfile erschaffen werden. Geben Sie dazu die folgende Zeile in Ihr Terminalfenster ein:

$ pod init

Dadurch werden CocoaPods in Ihrem Projektordner initialisiert, und Sie sehen eine Datei mit dem Namen podfile erscheinen.

4. Richten Sie die Bibliotheken ein

Hurra! CocoaPods ist jetzt bereit, die Abhängigkeiten Ihres Projekts zu verwalten. Der nächste Schritt ist, die gewünschten Bibliotheken tatsächlich in Ihr Xcode-Projekt einzufügen - schließlich sind wir dafür.

Bearbeiten Sie die Poddatei

Merken vim, der Texteditor? Wir werden damit die gewünschten Frameworks zur App hinzufügen. Geben Sie die folgende Zeile ein, um Ihre Pod-Datei zu bearbeiten:

$ vim podfile

Um in den Bearbeitungsmodus zu gelangen, tippen Sie einfach ich, wie in "Einfügen".

Fügen Sie der Pod-Datei Pods hinzu

In CocoaPods gibt es zwei Möglichkeiten, den Befehl für das gewünschte Framework zu erhalten. Sie finden die Podfile-Zeile normalerweise in der GitHub-Projektbeschreibung des Frameworks. Wenn nicht, gehen Sie zur CocoaPods-Website und suchen Sie dort nach der Bibliothek und ihren Podfile-Zeilen.

Unten habe ich eine Zeile für Firebase. 

pod 'Firebase / Core'

Wie gesagt, es spielt keine Rolle, woher man sie bekommt. Suchen Sie eine davon und führen Sie die folgenden Schritte aus. Geben Sie nun Ihre Zeile unter dem Kommentar ein:

# Hülsen für 

Das ist alles, was zum Hinzufügen von Frameworks benötigt wird. Sehen Sie, wie einfach das war? Nun müssen wir das beenden vim Editor und fahren Sie mit dem nächsten Schritt fort.

Verlassen der vim Editor

Um Ihre Änderungen zu speichern und die vim Editor, müssen Sie:

  1. Drücken Sie die Esc Taste, um den Bearbeitungsmodus zu verlassen.
  2. Art : x (der Befehl zum Speichern und Beenden).
  3. Drücken Sie Eingeben.

Installieren Sie CocoaPods

Dieser Schritt ist ein weiterer Einzeiler. Sie müssen lediglich in Ihrem Projektverzeichnis den folgenden Befehl eingeben:

$ pod installieren

Dadurch werden alle in Ihrer Pod-Datei aufgeführten Frameworks heruntergeladen und in Ihrem Xcode-Projekt installiert. Die Pods sollten jetzt zum Importieren verfügbar sein, genauso wie es ein regulärer Rahmen wäre (mithilfe von einführen am oberen Rand Ihrer Quelldatei).

5. Schlussfolgerung

Ich hoffe, dieses Tutorial war hilfreich. Wir befassten uns mit der Installation von CocoaPods, den grundlegenden Terminalbefehlen und dem Hinzufügen von Pods zu Ihrer Poddatei. CocoaPods ist ein schnelles, benutzerfreundliches und effektives Werkzeug zum Verwalten von Abhängigkeiten. Es wird häufig verwendet.

Und merke dir:

  • Sie müssen nur über Ihr Projekt auf Ihr Projekt zugreifen .xcworkspace und nicht .xcodeproj.
  • Die Pod-Datei kann mit einem beliebigen Texteditor bearbeitet und auch in Ihrem Xcode bearbeitet werden.
  • Lauf pod installieren Wenn Sie Ihre Pod-Datei geändert haben, werden die Abhängigkeiten entfernt oder hinzugefügt.

Während Sie hier sind, lesen Sie einige unserer anderen Beiträge zum Codieren von iOS-Apps!