MobileFirst-SDK mit CocoaPods zu einem iOS-Xcode-Projekt hinzufügen

Sie können MobileFirst-Funktionen mit CocoaPods zu Ihrem vorhandenen oder neuen Xcode-Projekt hinzufügen. Sobald Ihr Projekt eingerichtet ist, können Sie mit der Entwicklung Ihres Codes fortfahren.

1. Wenn noch kein Xcode-Projekt vorhanden ist, erstellen Sie eines.
2. Öffnen Sie im Xcode-Projektordner eine Befehlszeile.
3. Führen Sie den Befehl pod init aus, um eine Podfile zu erstellen.
4. Öffnen Sie die neue Podfile im Stammverzeichnis des Xcode-Projekts.
5. Setzen Sie den gesamten Inhalt auf Kommentar oder entfernen Sie ihn.
6. Fügen Sie die folgenden Zeilen, einschließlich der iOS-Version, hinzu und speichern Sie die Änderungen:

   use_frameworks!
   platform :ios, 9.0
   pod 'IBMMobileFirstPlatformFoundation'

7. Optional: Falls Sie weitere optionale Features wünschen, fügen Sie zusätzliche Pods hinzu. Eine Liste der verfügbaren Features finden Sie unter Tabelle 1. Fügen Sie für jeden Pod eine weitere Zeile hinzu. Beispiel:

   pod 'IBMMobileFirstPlatformFoundationJSONStore'

   Anmerkung: Mit der oben dargestellten Syntax wird die neueste Version des Pods IBMMobileFirstPlatformFoundation importiert. Wenn Sie nicht die neueste Version von MobileFirst verwenden, müssen Sie die vollständige Versionsnummer (einschließlich der übergenordneten Version, der untergeordneten Version und des Patches) angeben. Die Patch-Nummer hat das Format AAAAMMDDHH. Für den Import der Patch-Version 8.0.2016021411 des Pods IBMMobileFirstPlatformFoundation würde die Zeile wie folgt aussehen:

   pod 'IBMMobileFirstPlatformFoundation', '8.0.2016021411'

   Zum Abrufen des neuesten Patch für die untergeordnete Versionsnummer lautet die Syntax wie folgt:

   pod 'IBMMobileFirstPlatformFoundation', '~>8.0.0'

8. Optional: Wenn Sie für watchOS entwickeln, muss Ihre Podfile Abschnitte entsprechend der Haupt-App und der watchOS-Erweiterung enthalten:

# Namen der App verwenden
xcodeproj 'MyWatchApp'

use_frameworks!

# Namend es iOS-Ziels verwenden
target :MyWatchApp do
    platform :ios, 9.0
    pod 'IBMMobileFirstPlatformFoundation'
    end
# Namen des watch-Erweiterungsziels verwenden
target :MyWatchApp WatchKit Extension' do
    platform :watchos, 2.0
    pod 'IBMMobileFirstPlatformFoundation'
end

Die obigen Ziele müssen Ihrer iOS-Haupt-App und watchOS-Erweiterung entsprechen.

Der Abschnitt mit der Haupt-App kann alle in Tabelle 1 dokumentierten Frameworks enthalten. Für die watchOS-Erweiterung wird jedoch nur der Pod IBMMobileFirstPlatformFoundation unterstützt. Weitere Informationen zu watchOS finden Sie unter Entwicklung für watchOS 2.

9. Vergewissern Sie sich, dass das Xcode-Projekt geschlossen ist.
10. Führen Sie den Befehl pod install aus. Dieser Befehl installiert den Pod IBMMobileFirstPlatformFoundation und alle anderen in der Podfile angegebenen Pods sowie deren Abhängigkeiten. Anschließend generiert er das Pods-Projekt und integriert das MobileFirst-SDK in das Clientprojekt. Der Befehl fügt auch alle anderen erforderlichen Abhängigkeiten hinzu.
11. Öffnen Sie Ihre Datei Projektname.xcworkspace in Xcode. Geben Sie dazu in einer Befehlszeile open Projektname.xcworkspace ein. Die Datei befindet sich in demselben Verzeichnis wie die Datei Projektname.xcodeproj.
12. Das Hauptframework wird wie folgt importiert:

    Swift:

    import IBMMobileFirstPlatformFoundation

    Objective-C

    #import <IBMMobileFirstPlatformFoundation/IBMMobileFirstPlatformFoundation.h>

13. Ab iOS9 muss TLS durchgesetzt werden (siehe TLS-gesicherte Verbindungen in iOS-Apps erzwingen).