בדף הזה מוסבר איך להגדיר את iOS SDK. אם לא השלמתם את הדרישות המוקדמות, עליכם להשלים אותן קודם.
תלות
Swift Package Manager
ב-Xcode, מתקינים את חבילת Google-SearchInApps-SDK Swift Package. לשם כך, עוברים אל File (קובץ) > Add Packages… (הוספת חבילות…).
בהנחיה שמופיעה, מחפשים את מאגר הנתונים של GitHub של חבילת Google-SearchInApps-SDK Swift:
https://github.com/google/search-in-apps.git
- בוחרים את הגרסה של חבילת Google-SearchInApps-SDK Swift שרוצים להשתמש בה. לפרויקטים חדשים, מומלץ להשתמש באפשרות עד הגרסה הראשית הבאה
אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות שבחבילה ולהוריד אותם ברקע. מידע נוסף על הוספת יחסי תלות בחבילה זמין במאמר של Apple.
CocoaPods
מייבאים את Google-SearchInApps-SDK לפרויקט iOS באמצעות CocoaPods. פותחים את ה-Podfile של הפרויקט ומוסיפים את השורה הזו ליעד של האפליקציה:
pod 'Google-SearchInApps-SDK'
אחר כך מריצים את הפקודה הבאה משורת הפקודה:
pod install --repo-update
אם אתם חדשים ב-CocoaPods, תוכלו לעיין בתיעוד הרשמי כדי לקבל מידע על יצירה ושימוש ב-Podfiles.
עדכון הקובץ 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];