שנתחיל?

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

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

הוספה של חבילת 'חיבורים בקרבת מקום' לפרויקט שלכם

Xcode מגיע עם מנהל חבילות מובנה. כדי להוסיף חיבורים בקרבת מקום לפרויקט Xcode, בוחרים באפשרות File > Add חבילות... ומחפשים את google/nearby. לאחר מכן, לוחצים על Add Package (הוספת חבילה) וממתינים להשלמת התהליך (התהליך עשוי להימשך מספר דקות).

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

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

המפתחות הנדרשים לתיאור השימוש:

  • NSBluetoothAlwaysUsageDescription
  • NSLocalNetworkUsageDescription

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

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