בדף הזה מוסבר איך להגדיר את iOS SDK. אם עדיין לא השלמתם את הדרישות המוקדמות, עליכם להשלים אותן קודם.
תלות
Swift Package Manager
ב-Xcode, מתקינים את חבילת Swift של Google-SearchInApps-SDK על ידי מעבר אל 'קובץ' > 'הוספת חבילות...'.
בהודעה שמופיעה, מחפשים את מאגר Google-SearchInApps-SDK Swift Package GitHub:
https://github.com/google/search-in-apps.git
- בוחרים את הגרסה של חבילת Swift של Google-SearchInApps-SDK שבה רוצים להשתמש. בפרויקטים חדשים, מומלץ להשתמש באפשרות עד לגרסה הראשית הבאה.
בסיום התהליך, מערכת Xcode תתחיל לפתור את יחסי התלות של החבילות ולהוריד אותם ברקע. במאמר של Apple מוסבר איך מוסיפים יחסי תלות לחבילות.
CocoaPods
מייבאים את Google-SearchInApps-SDK לפרויקט iOS באמצעות CocoaPods. פותחים את Podfile של הפרויקט ומוסיפים את השורה הבאה ליעד של האפליקציה:
pod 'Google-SearchInApps-SDK'
לאחר מכן, מריצים את הפקודה הבאה בשורת הפקודה:
pod install --repo-update
אם אתם משתמשים חדשים ב-CocoaPods, כדאי לעיין במסמכי העזרה הרשמיים כדי לקבל מידע על יצירת קובצי Podfile ועל שימוש בהם.
עדכון קובץ Info.plist
מעדכנים את הקובץ Info.plist
של האפליקציה ומוסיפים שני מפתחות:
- מפתח
GSAAPIKey
עם ערך מחרוזת של מפתח ה-API של ה-SDK (ראו למעלה). - מפתח
GSAClientIdentifier
עם ערך מחרוזת של מזהה הלקוח של האפליקציה (ראו למעלה).
Info.plist
לדוגמה
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>GSAAPIKey</key>
<string>ABC123...xyz890</string>
<key>GSAClientIdentifier</key>
<string>ms-demo-app-sia</string>
...
</dict>
</plist>
Init
יוצרים מכונה של ContextualSearchRuntime
Swift
let contextualSearchRuntime = ContextualSearchRuntime()
Objective-C
ContextualSearchRuntime *searchRuntime = [[ContextualSearchRuntime alloc] init];