ערכות ה-SDK ללקוח של Firebase Data Connect מאפשרות לכם לקרוא ישירות שאילתות ושינויים בצד השרת מאפליקציית Firebase. אתם יוצרים SDK מותאם אישית ללקוח במקביל לעיצוב הסכימות, השאילתות והשינויים שאתם פורסים בשירות Firebase Data Connect.Data Connect לאחר מכן, משלבים שיטות מ-SDK זה בלוגיקה של הלקוח.
כפי שציינו במקומות אחרים, חשוב לזכור שData Connect שאילתות ומוטציות לא נשלחות על ידי קוד לקוח ומופעלות בשרת. במקום זאת, כשפורסים את הפונקציה, פעולות Data Connect מאוחסנות בשרת כמו ב-Cloud Functions. כלומר, צריך להטמיע שינויים תואמים בצד הלקוח כדי למנוע שיבוש של חוויית המשתמשים הקיימים (לדוגמה, בגרסאות ישנות יותר של האפליקציה).
לכן Data Connect מספק לכם סביבת פיתוח וכלים שמאפשרים לכם ליצור אב טיפוס של סכימות, שאילתות ומוטציות שמוצבות בשרת. בנוסף, המערכת יוצרת באופן אוטומטי ערכות SDK בצד הלקוח בזמן שאתם יוצרים אב טיפוס.
אחרי שחוזרים על עדכונים בשירות ובאפליקציות הלקוח, העדכונים בצד השרת ובצד הלקוח מוכנים לפריסה.
מהו תהליך העבודה לפיתוח לקוחות?
אם פעלתם לפי השלבים במאמר תחילת העבודה, קיבלתם הסבר על תהליך הפיתוח הכולל של Data Connect. במדריך הזה תמצאו מידע מפורט יותר על יצירת ערכות SDK של Swift מהסכימה שלכם ועל עבודה עם שאילתות ומוטציות של לקוחות.
לסיכום, כדי להשתמש ב-SDK של Swift שנוצר באפליקציות הלקוח, צריך לבצע את השלבים המקדימים הבאים:
- מוסיפים את Firebase לאפליקציה ל-iOS.
כדי להשתמש ב-SDK שנוצר, צריך להגדיר אותו כתלות ב-Xcode.
בסרגל הניווט העליון של Xcode, בוחרים באפשרות File > Add Package Dependencies > Add Local (קובץ > הוספת תלות בחבילה > הוספה מקומית), ובוחרים את התיקייה שמכילה את הקובץ
Package.swift
שנוצר.
לאחר מכן:
- פיתוח סכימת האפליקציה.
הגדרת יצירת SDK:
- באמצעות הלחצן Add SDK to app (הוספת SDK לאפליקציה) בתוסף Data Connect ל-VS Code
- עדכון של
connector.yaml
מגדירים את האמולטור Data Connect ומשתמשים בו וחוזרים על התהליך.
יצירת Swift SDK
משתמשים ב-CLI Firebase כדי להגדיר ערכות SDK שנוצרו על ידי Data Connect באפליקציות שלכם.
הפקודה init
אמורה לזהות את כל האפליקציות בתיקייה הנוכחית ולהתקין באופן אוטומטי את ה-SDK שנוצר.
firebase init dataconnect:sdk
עדכון ערכות SDK במהלך יצירת אב טיפוס
אם התקנתם את התוסף Data Connect VS Code, הוא תמיד ידאג לעדכן את ערכות ה-SDK שנוצרו.
אם אתם לא משתמשים בתוסף Data Connect VS Code, אתם יכולים להשתמש ב-Firebase CLI כדי לשמור על עדכניות של ערכות ה-SDK שנוצרו.
firebase dataconnect:sdk:generate --watch
יצירת ערכות SDK בצינורות עיבוד נתונים של בנייה
אתם יכולים להשתמש ב-Firebase CLI כדי ליצור ערכות SDK של Data Connect בתהליכי בנייה של CI/CD.
firebase dataconnect:sdk:generate
אתחול Data Connect iOS SDK
מאתחלים את מופע Data Connect באמצעות המידע שבו השתמשתם כדי להגדיר את Data Connect (כל המידע זמין בכרטיסייה Data Connect במסוף Firebase).
קבלת מופע של מחבר
הקוד של המחבר ייווצר על ידי האמולטור Data Connect. אם שם המחבר הוא movies
והחבילה היא movies
, כמו שמצוין ב-connector.yaml
, צריך לאחזר את אובייקט המחבר באמצעות הקריאה:
let connector = DataConnect.moviesConnector
הטמעה של שאילתות ומוטציות
באמצעות אובייקט המחבר, אפשר להריץ שאילתות ושינויים כמו שמוגדר בקוד המקור של GraphQL. נניח שהגדרתם את הפעולות הבאות במחבר:
mutation createMovie($title: String!, $releaseYear: Int!, $genre: String!, $rating: Int!) {
movie_insert(data: {
title: $title
releaseYear: $releaseYear
genre: $genre
rating: $rating
})
}
query getMovieByKey($key: Movie_Key!) {
movie(key: $key) { id title }
}
query listMoviesByGenre($genre: String!) {
movies(where: {genre: {eq: $genre}}) {
id
title
}
}
אחרי כן תוכלו ליצור סרט באופן הבא:
let mutationResult = try await connector.createMovieMutation.execute(
title: "Empire Strikes Back",
releaseYear: 1980,
genre: "Sci-Fi",
rating: 5)
print("Movie ID: \(mutationResult.data.movie_insert.id)")
כדי לאחזר סרט, תשתמשו בהפניה לשאילתה. כל ההפניות לשאילתות הן
מקורות Observable. בהתאם לאתר החדשות שהוגדר (ראו connector.yaml)
), הוא תומך בפקודת המאקרו @Observable
(iOS 17 ואילך) או שהוא מטמיע את ObservableObject
הפרוטוקול. אם לא מציינים ערך, ברירת המחדל היא פקודת המאקרו @Observable
שנתמכת ב-iOS 17 ואילך.
בתצוגת SwiftUI, אפשר לקשר את תוצאות השאילתה באמצעות המשתנה data
שפורסם של הפניה לשאילתה, ולקרוא לשיטה execute()
של השאילתה כדי לעדכן את הנתונים. המשתנה data
יתאים לצורת הנתונים שהוגדרה בהגדרת שאילתת GQL.
כל התוצאות שאוחזרו תואמות לפרוטוקול Decodable
. אם כללתם את המפתח הראשי של האובייקט באחזור GQL, האובייקטים הם גם Identifiable
, כך שתוכלו להשתמש בהם באיטרטורים.
struct ListMovieView: View {
@StateObject private var queryRef = connector.listMoviesByGenreQuery.ref(genre: "Sci-Fi")
var body: some View {
VStack {
Button {
Task {
do {
try await refresh()
} catch {
print("Failed to refresh: \(error)")
}
}
} label: {
Text("Refresh")
}
// use the query results in a view
ForEach(queryRef.data?.movies ?? [], id: \.self.id) { movie in
Text(movie.title)
}
}
}
@MainActor
func refresh() async throws {
_ = try await queryRef.execute()
}
}
השאילתות תומכות גם בביצוע חד-פעמי.
let resultData = try await DataConnect.moviesConnector.listMoviesByGenreQuery.execute(genre: "Sci-Fi")
טיפול בשינויים בשדות של ספירה
סכימה של אפליקציה יכולה להכיל מניינים, שאפשר לגשת אליהם באמצעות שאילתות GraphQL.
יכול להיות שתוסיפו ערכים חדשים של enum נתמכים ככל שהעיצוב של האפליקציה ישתנה. לדוגמה, נניח שבהמשך מחזור החיים של האפליקציה, אתם מחליטים להוסיף ערך FULLSCREEN לאנום AspectRatio
.
בתהליך העבודה של Data Connect, אפשר להשתמש בכלים לפיתוח מקומי כדי לעדכן את השאילתות ואת ערכות ה-SDK.
עם זאת, לפני שאתם משיקים גרסה מעודכנת של הלקוחות, יכול להיות שגרסאות ישנות יותר של לקוחות שכבר נפרסו יפסיקו לפעול.
דוגמה להטמעה עמידה
ה-SDK שנוצר מחייב טיפול בערכים לא ידועים, כי ה-enums שנוצרו מכילים ערך _UNKNOWN
, ו-Swift מחייבת הצהרות switch מקיפות.
do {
let result = try await DataConnect.moviesConnector.listMovies.execute()
if let data = result.data {
for movie in data.movies {
switch movie.aspectratio {
case .ACADEMY: print("academy")
case .WIDESCREEN: print("widescreen")
case .ANAMORPHIC: print("anamorphic")
case ._UNKNOWN(let unknownAspect): print(unknownAspect)
}
}
}
} catch {
// handle error
}
יצירת אב-טיפוס ובדיקה של אפליקציית iOS
הגדרת לקוחות לשימוש באמולטור מקומי
אתם יכולים להשתמש באמולטור Data Connect, דרך התוסף Data Connect VS Code או דרך ה-CLI.
התהליך של הוספת קוד לאפליקציה כדי להתחבר לאמולטור זהה בשני התרחישים.
let connector = DataConnect.moviesConnector
// Connect to the emulator on "127.0.0.1:9399"
connector.useEmulator()
// (alternatively) if you're running your emulator on non-default port:
connector.useEmulator(port: 9999)
// Make calls from your app
סוגי נתונים בערכות Data Connect SDK
שרת Data Connect מייצג סוגי נתונים נפוצים ומותאמים אישית של GraphQL. הם מיוצגים ב-SDK באופן הבא.
סוג Data Connect | Swift |
---|---|
מחרוזת | מחרוזת |
Int | Int |
Float | זוגית |
בוליאני | בוליאני |
מזהה ייחודי אוניברסלי (UUID) | מזהה ייחודי אוניברסלי (UUID) |
תאריך | FirebaseDataConnect.LocalDate |
חותמת זמן | FirebaseCore.Timestamp |
Int64 | Int64 |
הכול | FirebaseDataConnect.AnyValue |