iOS
Parse Swift SDK
Installation du SDK Parse iOS Swift pour Xcode 12/14
12 min
installer le sdk parse sur votre projet ios swift introduction dans cette section, vous apprendrez comment installer le sdk parse swift ios dans votre projet xcode dans ce tutoriel, nous utiliserons une application de base créée en swift avec xcode 12 et ios 14 à tout moment, vous pouvez accéder au projet complet construit avec ce tutoriel sur notre dépôt github conditions préalables pour compléter ce tutoriel, vous avez besoin de une application créée sur back4app remarque suivez le tutoriel de nouvelle application parse pour apprendre à créer une application sur back4app xcode application ios de base remarque si vous n'avez pas d'application de base créée, vous pouvez ouvrir xcode et cliquer sur fichier > nouveau > projet > ios ensuite, sélectionnez application après avoir créé votre application de base, vous êtes prêt à suivre ce guide 1 choisissez votre méthode d'installation swift package manager 1 1 ajouter le package sdk parse swift gestionnaire de packages swift suivez cette étape si vous n'avez pas encore installé le sdk ios de parse les versions plus récentes de xcode ont le gestionnaire de paquets swift intégré c'est le moyen le plus simple et le meilleur d'installer le sdk parse swift dans votre projet et de le garder à jour actuellement, nous ne recommandons d'utiliser cette méthode que pour installer le sdk parse swift sous le ( fichier fichier ) menu, sélectionnez ( paquets swift paquets swift ) et ensuite ( ajouter une dépendance de paquet ajouter une dépendance de paquet ) dans la ( choisir le dépôt de packages choisir le dépôt de packages ) fenêtre, collez l'url du site github du sdk parse swift ( https //github com/parse community/parse swift ) et cliquez sur suivant suivant dans la ( dépôt dépôt ) fenêtre, vous pouvez sélectionner une version version , branche branche ou un commit commit choisissez la méthode que vous préférez et cliquez sur suivant suivant attendez que xcode xcode résolve toutes les parse swift parse swift dépendances, puis cliquez sur suivant suivant vérifiez si le produit du package ht parseswift parseswift est coché et que votre cible est correctement sélectionnée sur ajouter à la cible ajouter à la cible , puis cliquez sur suivant suivant le package swift devrait apparaître dans l'arbre des dépendances juste en dessous de votre projet, montrant sa version sur le côté droit si vous devez mettre à jour le parseswift parseswift paquet, faites un clic droit dessus dans l'arborescence des dépendances et choisissez mettre à jour le paquet mettre à jour le paquet le processus mettra automatiquement tout à jour pour vous félicitations ! vous avez maintenant installé le sdk ios parse swift cocoapods 1 1 installer le sdk ios parse swift suivez cette étape si vous n'avez pas encore installé le sdk ios parse swift xcode peut utiliser cocoapods comme gestionnaire de dépendances pour les projets cocoa en swift et objective c vous pouvez vous référer à guide de démarrage de cocoapods pour des détails supplémentaires pour installer cocoapods, ouvrez votre terminal, copiez le code suivant et collez le dans votre terminal puis appuyez sur retour cocoapods devrait s'installer automatiquement après que vous ayez entré votre mot de passe s'il y a un problème, vous devrez peut être mettre à jour votre version locale de ruby ensuite, ouvrez le dossier du projet xcode et ouvrez une fenêtre de terminal dans ce dossier maintenant, vous allez créer un podfile copiez le code suivant et collez le dans votre terminal, puis appuyez sur retour si votre dossier affiche maintenant votre podfile, vous l'avez fait correctement faites attention, si vous ne voyez pas le podfile, assurez vous que votre terminal est bien dans le dossier du projet ensuite, ouvrez votre podfile avec xcode ou tout éditeur de texte et sous chaque cible, ajoutez "pod 'parse'" votre podfile ressemblera à ceci maintenant, vous allez ajouter parse swift à votre projet assurez vous que votre terminal est ouvert sur le dossier de votre projet copiez le code suivant et collez le dans votre terminal, puis appuyez sur retour cocoapods reconstruira le projet en tant qu'espace de travail et votre projet ressemblera maintenant à ceci si vous avez déjà ouvert votre projet xcode, fermez le à partir de maintenant, vous ouvrirez le fichier de l'espace de travail au lieu du fichier du projet double cliquez sur le fichier de l'espace de travail pour l'ouvrir félicitations ! vous avez maintenant installé le sdk ios de parse 2 connectez votre application parse ouvrez le fichier appdelegate swift de votre projet pour configurer les identifiants de l'application le sdk ios swift de parse utilise ces paramètres pour se connecter aux serveurs back4app en haut du fichier, vous devriez voir une fonction appelée ‘didfinishlaunchingwithoptions’ collez le code suivant à l'intérieur de cette fonction, et assurez vous qu'il est au dessus de la ligne qui dit ‘return true’ appdelegate swift 1 parseswift initialize(applicationid "paste your application id here", clientkey "paste your client id here", serverurl url(string "https //parseapi back4app com")!) en haut de votre fichier appdelegate swift, assurez vous d'inclure parse en tant que module en ajoutant le code suivant juste en dessous de ‘import uikit’ appdelegate swift 1 import parseswift votre fichier appdelegate swift devrait maintenant ressembler à ceci appdelegate swift 1 import uikit 2 import parseswift 3 4 @main 5 class appdelegate uiresponder, uiapplicationdelegate { 6 7 8 9 func application( application uiapplication, didfinishlaunchingwithoptions launchoptions \[uiapplication launchoptionskey any]?) > bool { 10 // override point for customization after application launch 11 parseswift initialize(applicationid "paste your application id here", clientkey "paste your client id here", serverurl url(string "https //parseapi back4app com")!) 12 return true 13 } 14 15 // mark uiscenesession lifecycle 16 17 func application( application uiapplication, configurationforconnecting connectingscenesession uiscenesession, options uiscene connectionoptions) > uisceneconfiguration { 18 // called when a new scene session is being created 19 // use this method to select a configuration to create the new scene with 20 return uisceneconfiguration(name "default configuration", sessionrole connectingscenesession role) 21 } 22 23 func application( application uiapplication, diddiscardscenesessions scenesessions set\<uiscenesession>) { 24 // called when the user discards a scene session 25 // if any sessions were discarded while the application was not running, this will be called shortly after application\ didfinishlaunchingwithoptions 26 // use this method to release any resources that were specific to the discarded scenes, as they will not return 27 } 28 29 30 } faites attention, si xcode vous dit qu'il n'y a aucun module ‘parse’ il y a une solution facile dans xcode, ouvrez ‘cible > paramètres de construction > chemins de recherche > chemins de recherche de framework’ et ajoutez ensuite deux valeurs ‘$(project dir)’ et ‘$(inherited)’ xcode pourra maintenant trouver votre module parse allez sur votre tableau de bord d'application sur le site back4app accédez aux paramètres de l'application cliquez sur fonctionnalités fonctionnalités > paramètres principaux paramètres principaux > serveur serveur retournez à votre appdelegate swift appdelegate swift fichier et collez votre applicationid applicationid et clientkey clientkey voir plus dans notre guide de nouvelle application parse 3 testez votre connexion ouvrez votre fichier viewcontroller swift en haut du fichier, assurez vous d'inclure parse en tant que module en ajoutant le code suivant juste en dessous de ‘import uikit’ viewcontroller swift 1 import parseswift à l'intérieur de la fonction appelée ‘viewdidload’, ajoutez un extrait de code sous le code qui configure parse viewcontroller swift 1 testparseconnection() ajoutez ensuite une fonction en dessous de la méthode viewdidload() viewcontroller swift 1 struct gamescore parseobject { 2 // those are required for object 3 var objectid string? 4 var createdat date? 5 var updatedat date? 6 var acl parseacl? 7	 8 // your own properties 9 var score int = 0 10	 11 // custom initializer 12 init(score int) { 13 self score = score 14 } 15	 16 init(objectid string?) { 17 self objectid = objectid 18 } 19 } 20	 21 func testparseconnection(){ 22 let score = gamescore(score 10) 23 let score2 = gamescore(score 3) 24 score save { result in 25 switch result { 26 case success(let savedscore) 27 assert(savedscore objectid != nil) 28 assert(savedscore createdat != nil) 29 assert(savedscore updatedat != nil) 30 assert(savedscore acl == nil) 31 assert(savedscore score == 10) 32	 33 / to modify, need to make it a var as the value type 34 was initialized as immutable 35 / 36 var changedscore = savedscore 37 changedscore score = 200 38 changedscore save { result in 39 switch result { 40 case success(var savedchangedscore) 41 assert(savedchangedscore score == 200) 42 assert(savedscore objectid == savedchangedscore objectid) 43	 44 / note that savedchangedscore is mutable since it's 45 a var after success 46 / 47 savedchangedscore score = 500 48	 49 case failure(let error) 50 assertionfailure("error saving \\(error)") 51 } 52 } 53 case failure(let error) 54 assertionfailure("error saving \\(error)") 55 } 56 } 57 } 58 } construisez votre application sur un appareil ou un simulateur ( commande commande + r r ) attendez que l'écran principal apparaisse connectez vous à site web back4app https //www back4app com/ trouvez votre application et cliquez sur tableau de bord tableau de bord cliquez sur noyau noyau allez à navigateur navigateur si tout fonctionne correctement, vous devriez trouver une classe nommée gamescore gamescore et les objets sauvegardés dedans prochaines étapes à ce stade, vous avez appris comment commencer avec les applications ios vous êtes maintenant prêt à explorer les fonctionnalités principales de parse server https //www back4app com/product/parse server et les modules complémentaires de back4app https //www back4app com/product/addons en savoir plus en parcourant nos tutoriels ios ou consultez la documentation open source de parse pour le sdk ios