Ajout du logiciel SDK de MobileFirst à un projet iOS Xcode avec CocoaPods

Vous pouvez ajouter une fonctionnalité MobileFirst à votre projet Xcode nouveau ou existant avec CocoaPods. Une fois votre projet configuré, vous pouvez poursuivre le développement de votre code.

Avant de commencer

Remarque : Le développement MobileFirst est pris en charge dans Xcode depuis la version 7.1.en utilisant iOS 8.0 et versions ultérieures.
Vous devez disposer des éléments suivants :

Pourquoi et quand exécuter cette tâche

Vous pouvez créer un projet IBM MobileFirst Platform Foundation Xcode en ajoutant des bibliothèques et des infrastructures de base avec CocoaPods. Des pods facultatifs supplémentaires de CocoaPods peuvent être ajoutés.

Procédure

  1. Créez un projet Xcode s'il n'en existe pas.
  2. Ouvrez une ligne de commande dans le dossier du projet Xcode.
  3. Exécutez la commande pod init pour créer un fichier Podfile.
  4. Ouvrez le nouveau fichier Podfile à la racine du projet Xcode.
  5. Mettez en commentaire ou supprimez l'ensemble du contenu existant.
  6. Ajoutez les lignes suivantes en incluant la version d'iOS et sauvegardez les modifications :
    use_frameworks!
    platform :ios, 9.0
    pod 'IBMMobileFirstPlatformFoundation'
  7. Facultatif : si vous voulez ajouter des fonctions facultatives, ajoutez des pods supplémentaires. Pour la liste des fonctions disponibles, voir Tableau 1. Ajoutez une ligne supplémentaire pour chaque pod, par exemple :
    pod 'IBMMobileFirstPlatformFoundationJSONStore'
    Remarque : la syntaxe précédente importe la version la plus récente du pod IBMMobileFirstPlatformFoundation. Si vous n'utilisez pas la version la plus récente de MobileFirst, vous devez ajouter le numéro de version complet, qui comprend le numéro de la version majeure, de la version mineure et du correctif. Le numéro du correctif est au format AAAAMMJJHH. Par exemple, pour importer la version de correctif spécifique 8.0.2016021411 du pod IBMMobileFirstPlatformFoundation, la ligne est similaire à :
    pod 'IBMMobileFirstPlatformFoundation', '8.0.2016021411'
    Ou bien, pour obtenir le dernier correctif pour le numéro de version mineure, entrez la syntaxe suivante :
    pod 'IBMMobileFirstPlatformFoundation', '~>8.0.0'
  8. Facultatif : Si vous procédez au développement pour watchOS, votre fichier Podfile doit contenir des sections qui correspondent à l'application principale et à l'extension watchOS :

#use the name of the app
xcodeproj 'MyWatchApp'

use_frameworks!

#use the name of the iOS target
target :MyWatchApp do
    platform :ios, 9.0
    pod 'IBMMobileFirstPlatformFoundation'
    end
#use the name of the watch extension target
target :MonAppWatch WatchKit Extension' do
    platform :watchos, 2.0
    pod 'IBMMobileFirstPlatformFoundation'
end

Les cibles précédentes doivent correspondre à votre application iOS principale et à votre extension watchOS :

Capture d'écran de la navigation pour le projet MonAppWatch avec le dossier MonAppWatch et le dossier MonAppWatch WatchKit ExtensionMyWatchApp et WatchKit Extension dans un projet Xcode

La section de l'application principale peut contenir toute infrastructure présentée ici : Tableau 1. Toutefois, le pod IBMMobileFirstPlatformFoundation seulement est pris en charge pour l'extension watchOS. Pour plus d'informations sur watchOS, voir Développement pour watchOS 2.

  1. Vérifiez que le projet Xcode est fermé.
  2. Exécutez la commande pod install. Cette commande installe le pod IBMMobileFirstPlatformFoundation et tout autre pod spécifié dans le fichier Podfile, ainsi que leurs dépendances. Ensuite, elle génère le projet pods et intègre le projet client au logiciel SDK de MobileFirst. Elle ajoute également les autres dépendances requises.
  3. Ouvrez votre fichier NomProjet.xcworkspace dans Xcode en entrant open [NomProjet].xcworkspace depuis une ligne de commande. Ce fichier se trouve dans le même répertoire que le fichier [NomProjet].xcodeproj.
  4. Vous pouvez importer l'infrastructure principale comme suit.

    Swift

    import IBMMobileFirstPlatformFoundation

    Objective C

    #import <IBMMobileFirstPlatformFoundation/IBMMobileFirstPlatformFoundation.h>
  5. Depuis iOS9, TLS doit être appliqué ; voir Etablissement de connexions sécurisées par TLS dans les applications iOS.

Résultats

A présent, vous pouvez commencer à développer votre application iOS native avec l'intégration d'IBM MobileFirst Platform Foundation.

Que faire ensuite

Pour pouvoir accéder aux ressources du serveur, vous devez enregistrer votre application. Voir Enregistrement des applications iOS à partir de MobileFirst Platform CLI. Pour des détails sur le fichier mfpclient.plist, voir Fichiers de propriétés client iOS.