Panduan Instalasi Parse SDK iOS dengan Swift

12min
Instal Parse SDK di Proyek iOS Swift Anda
Pendahuluan
Di bagian ini Anda akan belajar bagaimana cara menginstal Parse Swift iOS SDK ke dalam proyek Xcode Anda.
Dalam tutorial ini kita akan menggunakan aplikasi dasar yang dibuat dengan Swift menggunakan Xcode 12 dan iOS 14.
Kapan saja, Anda dapat mengakses Proyek lengkap yang dibangun dengan tutorial ini di repositori GitHub.
Prasyarat
Untuk menyelesaikan tutorial ini, Anda perlu:
Sebuah aplikasi yang dibuat di Back4App.
Catatan: Ikuti tutorial Aplikasi Parse Baru untuk belajar bagaimana cara membuat aplikasi di Back4App.
Xcode.
Aplikasi iOS dasar.
Catatan: Jika Anda tidak memiliki aplikasi dasar yang dibuat, Anda dapat membuka Xcode dan tekan File-> Baru-> Proyek -> iOS. Kemudian pilih Aplikasi. Setelah Anda membuat aplikasi dasar Anda, Anda siap untuk mengikuti panduan ini.
﻿
﻿
﻿
1 - Pilih Metode Instalasi Anda
1.1 - Tambahkan Paket SDK Parse Swift - Pengelola Paket Swift
Ikuti langkah ini jika Anda belum menginstal Parse iOS SDK.
Versi terbaru dari XCode memiliki Swift Package Manager yang terintegrasi. Ini adalah cara termudah dan terbaik untuk menginstal Parse Swift SDK di proyek Anda dan menjaga agar tetap diperbarui.
Saat ini kami hanya merekomendasikan menggunakan metode ini untuk menginstal Parse Swift SDK.
Di bawah (File) menu, pilih (Paket Swift) dan kemudian (Tambahkan Ketergantungan Paket)
﻿
Pada jendela (Pilih Repositori Paket) , tempelkan URL untuk situs web github Parse Swift SDK ( https://github.com/parse-community/Parse-Swift ) dan klik Selanjutnya﻿
﻿
Di jendela (Repository) ini, Anda dapat memilih Versi, Cabang atau Komit. Pilih metode yang Anda inginkan dan klik Selanjutnya﻿
﻿
Tunggu untuk XCode untuk menyelesaikan semua Parse-Swift ketergantungan dan kemudian klik Berikutnya﻿
﻿
Periksa apakah produk paket ht ParseSwift sudah dicentang dan target Anda telah dipilih dengan benar di Tambahkan ke Target, lalu klik Selanjutnya﻿
﻿
Paket Swift harus muncul di pohon Ketergantungan tepat di bawah proyek Anda, menunjukkan versinya di sisi kanan:
﻿
Jika Anda perlu memperbarui ParseSwift paket, klik kanan di bawah pohon Dependencies dan pilih Perbarui Paket. Proses ini akan secara otomatis memperbarui semuanya untuk Anda.
﻿
Selamat! Anda sekarang telah menginstal Parse Swift iOS SDK
1.1 - Instal SDK Parse Swift iOS
Ikuti langkah ini jika Anda belum menginstal Parse Swift iOS SDK.
Xcode dapat menggunakan CocoaPods sebagai pengelola ketergantungan untuk proyek Cocoa Swift dan Objective-C.
Anda dapat merujuk ke Panduan Memulai CocoaPods untuk detail tambahan.
Untuk menginstal CocoaPods, buka terminal Anda, salin cuplikan kode berikut dan tempelkan ke terminal Anda dan tekan enter:
$ sudo gem install cocoapods
CocoaPods seharusnya diinstal secara otomatis setelah Anda memasukkan kata sandi Anda. Jika ada masalah, Anda mungkin perlu memperbarui versi Ruby lokal Anda.
Selanjutnya buka folder Proyek Xcode dan buka jendela terminal di folder itu.
﻿
Sekarang Anda akan membuat sebuah Podfile. Salin potongan kode berikut dan tempelkan ke terminal Anda dan tekan enter:
$ pod init
Jika folder Anda sekarang menunjukkan Podfile Anda, Anda telah melakukannya dengan benar.
﻿
Hati-hati, Jika Anda tidak melihat podfile, pastikan terminal Anda benar-benar berada di dalam folder proyek..
Selanjutnya buka Podfile Anda dengan Xcode atau editor teks apa pun dan di bawah setiap target tambahkan “pod ‘Parse’.”
pod 'ParseSwift'
Podfile Anda akan terlihat mirip dengan ini:
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
Sekarang Anda akan menambahkan Parse Swift ke proyek Anda. Pastikan terminal Anda terbuka di folder proyek Anda. Salin potongan kode berikut dan tempelkan ke terminal Anda dan tekan enter:
$ pod install
CocoaPods akan membangun kembali proyek sebagai workspace dan proyek Anda sekarang akan terlihat seperti ini.
﻿
Jika Anda sudah membuka proyek Xcode Anda, tutuplah. Mulai sekarang, Anda akan membuka file workspace alih-alih file proyek. Klik dua kali pada file workspace untuk membukanya.
﻿
Selamat! Anda sekarang telah menginstal Parse iOS SDK
2 - Hubungkan Aplikasi Parse Anda
Buka file AppDelegate.swift proyek Anda untuk mengatur kredensial aplikasi.
Parse Swift iOS SDK menggunakan pengaturan ini untuk terhubung ke server Back4App.
Di bagian atas file, Anda harus melihat fungsi yang disebut ‘didFinishLaunchingWithOptions’.
Tempelkan potongan kode berikut ke dalam fungsi ini, dan pastikan itu berada di atas baris yang mengatakan ‘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")!)
﻿
Di bagian atas file AppDelegate.swift Anda, pastikan untuk menyertakan Parse sebagai modul dengan menyertakan potongan kode berikut tepat di bawah 'import UIKit'.
AppDelegate.swift
1   import ParseSwift
1   import ParseSwift
﻿
File AppDelegate.swift Anda sekarang harus terlihat seperti ini:
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  }
﻿
Hati-hati, Jika Xcode memberi tahu Anda bahwa Tidak Ada Modul ‘Parse’ ada solusi yang mudah. Di Xcode buka ‘Target > Build Settings > Search Paths > Framework Search Paths’ dan kemudian tambahkan dua nilai: ‘$(PROJECT_DIR)’ dan ‘$(inherited)’. Xcode sekarang akan dapat menemukan modul Parse Anda.
Kunjungi Dasbor Aplikasi Anda di situs web Back4App.
Navigasi ke pengaturan aplikasi: Klik pada Fitur > Pengaturan Inti > Server.
Kembali ke AppDelegate.swift file Anda dan tempelkan applicationId dan clientKey Anda.
Lihat lebih lanjut di panduan Aplikasi Parse Baru.
3 - Uji koneksi Anda
Buka file ViewController.swift Anda.
Di bagian atas file, pastikan untuk menyertakan Parse sebagai modul dengan menyertakan potongan kode berikut tepat di bawah ‘import UIKit’.
ViewController.swift
1   import ParseSwift
1   import ParseSwift
﻿
Di dalam fungsi yang disebut ‘viewDidLoad’ tambahkan potongan kode di bawah kode yang mengonfigurasi parse.
ViewController.swift
1   testParseConnection()
1   testParseConnection()
﻿
Kemudian tambahkan fungsi di bawah metode 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	}
﻿
Bangun aplikasi Anda di perangkat atau simulator (Perintah+R).
Tunggu hingga layar utama muncul.
Masuk di Situs Web Back4App﻿
Temukan aplikasi Anda dan klik pada Dasbor﻿
Klik pada Inti.
Pergi ke Peramban.
Jika semuanya berfungsi dengan baik, Anda harus menemukan kelas bernama GameScore dan objek yang disimpan di dalamnya.
Langkah Selanjutnya
Pada titik ini, Anda telah belajar bagaimana memulai dengan aplikasi iOS. Anda sekarang siap untuk menjelajahi fitur inti Parse Server dan add-on Back4App. 
Pelajari lebih lanjut dengan menjelajahi Tutorial iOS atau periksa dokumentasi sumber terbuka Parse untuk SDK iOS.
﻿