Installation du SDK Parse iOS Swift pour Xcode 12/14

12min
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
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) menu, sélectionnez (Paquets Swift) et ensuite (Ajouter une dépendance de paquet)
﻿
Dans la (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﻿
﻿
Dans la (Dépôt) fenêtre, vous pouvez sélectionner une Version, Branche ou un Commit. Choisissez la méthode que vous préférez et cliquez sur Suivant﻿
﻿
Attendez que XCode résolve toutes les Parse-Swift dépendances, puis cliquez sur Suivant﻿
﻿
Vérifiez si le produit du package ht ParseSwift est coché et que votre cible est correctement sélectionnée sur Ajouter à la cible, puis cliquez sur 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 paquet, faites un clic droit dessus dans l'arborescence des Dépendances et choisissez Mettre à jour le paquet. Le processus mettra automatiquement tout à jour pour vous.
﻿
Félicitations ! Vous avez maintenant installé le SDK iOS Parse Swift
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 :
$ sudo gem install cocoapods
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 :
$ pod init
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'".
pod 'ParseSwift'
Votre Podfile ressemblera à ceci :
platform :ios, '14.0'

target 'Cocoapods_ParseSwift' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

  # Pods for Cocoapods_ParseSwift
  pod 'ParseSwift'

end
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 :
$ pod install
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")!)
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
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  }
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 > Paramètres principaux > Serveur.
Retournez à votre AppDelegate.swift fichier et collez votre applicationId et 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
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()
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	}
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+R).
Attendez que l'écran principal apparaisse.
Connectez-vous à Site Web Back4App﻿
Trouvez votre application et cliquez sur Tableau de bord﻿
Cliquez sur Noyau.
Allez à Navigateur.
Si tout fonctionne correctement, vous devriez trouver une classe nommée 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 et les modules complémentaires de Back4App. 
En savoir plus en parcourant nos tutoriels iOS ou consultez la documentation open source de Parse pour le SDK iOS.
﻿