מתחילים

התקנה של הגרסה האחרונה של Xcode

כדי להשתמש בתכונה 'חיבור מהיר' בפרויקט, נדרשת גרסה 13.0 ואילך של Xcode.

הוספת חבילת Nearby Connections לפרויקט

‫Xcode כולל מנהל חבילות מובנה. כדי להוסיף את Nearby Connections לפרויקט Xcode, בוחרים באפשרות File (קובץ) > Add Packages… (הוספת חבילות) ומחפשים את google/nearby. אחר כך לוחצים על הוספת חבילה וממתינים עד לסיום התהליך (זה עשוי להימשך כמה דקות).

בקשת גישה למשאבים מוגנים

כדי להשתמש ב'חיבורים מהירים' צריך גישה ל-Bluetooth ולרשת המקומית כדי לפרסם, לגלות, ליצור חיבורים ולהעביר נתונים. צריך לספק תיאור שימוש לכל משאב שנדרש באפליקציה, ב-Info.plist שלה. אם לא, הניסיונות לגשת למשאב ייכשלו, ואפילו עלולים לגרום לקריסה של האפליקציה.

מפתחות חובה לתיאור השימוש:

  • NSBluetoothAlwaysUsageDescription
  • NSLocalNetworkUsageDescription

בנוסף למפתחות של תיאור השימוש, צריך להוסיף גם מפתח NSBonjourServices עם רשימה של סוגי השירותים שהאפליקציה תעיין בהם. סוג השירות היחיד שחובה להוסיף יכול להיווצר על ידי לקיחת 12 הבייטים הראשונים של הגיבוב (hash) של מזהה השירות של האפליקציה SHA-256.

אתם יכולים להשתמש בכלי הבא כדי ליצור את הערך הזה באופן אוטומטי: