תחילת העבודה

בדף הזה מוסבר איך להגדיר את iOS SDK. אם עדיין לא השלמתם את הדרישות המוקדמות, עליכם להשלים אותן קודם.

תלות

Swift Package Manager

  1. ב-Xcode, מתקינים את חבילת Swift של Google-SearchInApps-SDK על ידי מעבר אל 'קובץ' > 'הוספת חבילות...'.

  2. בהודעה שמופיעה, מחפשים את מאגר Google-SearchInApps-SDK Swift Package GitHub:

https://github.com/google/search-in-apps.git
  1. בוחרים את הגרסה של חבילת 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 של האפליקציה ומוסיפים שני מפתחות:

  1. מפתח GSAAPIKey עם ערך מחרוזת של מפתח ה-API של ה-SDK (ראו למעלה).
  2. מפתח 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

ContextualSearchRuntime

let contextualSearchRuntime = ContextualSearchRuntime()

Objective-C

ContextualSearchRuntime

ContextualSearchRuntime *searchRuntime = [[ContextualSearchRuntime alloc] init];

השלב הבא: תכונות חיפוש