SDK iOS Livefyre

Ajoutez Livefyre sur votre application iOS native.

Utilisez cette bibliothèque open source pour intégrer les services Livefyre dans votre application iOS native. Le SDK iOS Livefyre StreamHub fournit une couche mince autour de nos mécanismes d’API communs, basée sur l’excellente bibliothèque AFNetworking.

Livefyre fournit également deux exemples d’applications iOS basées sur ce SDK : un flux de commentaires et un exemple d’application Reviews.

Intégration du SDK dans votre projet en tant que capsule de cacao (recommandé)

La méthode la plus pratique pour ajouter le SDK StreamHub-iOS à votre projet consiste à utiliser CocoaPods. Si vous n’avez pas CocoaPods, exécutez gem install cocoapods and pod setup. Voici un exemple de fichier Podfile :

source 'https://github.com/Livefyre/cocoapods.git' 
source 'https://github.com/CocoaPods/Specs.git' 
  
platform :ios, :deployment_target => '6.0' 
  
pod 'StreamHub-iOS-SDK', '~> 0.3.0'

Vous devez également ajouter un référentiel Specs à votre installation CocoaPod (qui sera cloné dans le répertoire ~/.cocoapods/repos) :

pod repo add livefyre https://github.com/Livefyre/cocoapods.git

Une fois que votre Podfile a été créé à la racine du projet d’application et que le référentiel ci-dessus a été ajouté, exécutez :

pod install

Vous téléchargerez ainsi toutes les dépendances et créerez un fichier MyApp.xcworkspace, que vous utiliserez désormais pour ouvrir votre projet d’application dans Xcode.

Sous-projet Xcode

Vous pouvez également cloner le référentiel :

git clone https://github.com/Livefyre/StreamHub-iOS-SDK.git 

Ensuite, ajoutez le projet Xcode (LFSClient.xcodeproj) à votre application en tant que sous-projet (en faisant simplement glisser le fichier LFSClient.xcodeproj dans le volet Project Navigator de Xcode).

Vous devez également faire de même avec l’une des dépendances (AFNetworking, JSONKit).

Télécharger tout à la fois (non recommandé)

cd ~/dev 
git clone https://github.com/Livefyre/StreamHub-iOS-SDK.git 
cd StreamHub-iOS-SDK 
git submodule init 
git submodule update 
pod repo add livefyre https://github.com/Livefyre/cocoapods.git 
pod install 
cd examples/CommentStream 
pod install 
open CommentStream.xcworkspace

Vous avez besoin du fichier LFSTestConfig.plist de Livefyre, que Livefyre fournit sur demande.

Documentation Xcode

Vous pouvez parcourir la documentation ou créer la cible "Documentation" dans votre Xcode (nécessite l'installation d'appledoc) sur votre système.

Conditions requises

Les versions du SDK iOS StreamHub depuis v0.2.0 nécessitent iOS 6.0 ou une version ultérieure.

Annexe (prise en charge JSON)

Pour ceux qui consultent les versions internes du SDK StreamHub-iOS, veuillez noter que nous utilisons une version modifiée de JSONKit comme analyseur JSON par défaut (au lieu de NSJSONSerialization fourni par Apple). Nous avons dû le faire parce que l'analyseur fourni par Apple ne prend pas en charge le décodage de fichiers JSON qui contiennent des entiers ou des nombres à virgule flottante plus grands que ceux qui peuvent être représentés par le système. Notre version modifiée de JSONKit tronque de très grands nombres au maximum du système correspondant, au lieu de lancer une exception.