الخطوات الأولى

تثبيت أحدث إصدار من Xcode

لاستخدام ميزة "المشاركة عن قرب"، يجب استخدام Xcode 13.0 أو الإصدارات الأحدث.

إضافة حزمة Nearby Connections إلى مشروعك

يتوفّر مع Xcode مدير حزم مضمّن. لإضافة الاتصالات القريبة إلى مشروع Xcode، اختَر ملف > إضافة الحِزم... وابحث عن google/nearby. بعد ذلك، انقر على Add Package (إضافة حزمة) وانتظر اكتمال العملية (قد تستغرق هذه العملية بضع دقائق).

طلب الوصول إلى الموارد المحمية

تحتاج ميزة Nearby Connections إلى الوصول إلى كل من البلوتوث والشبكة المحلية للإعلان عن البيانات واكتشافها وإجراء اتصالات ونقلها. أدخِل وصفًا لاستخدام كل مورد مطلوب في Info.plist لتطبيقك. إذا لم تفعل ذلك، سيتعذّر عليك الوصول إلى المورد، وقد يؤدي ذلك إلى تعطُّل تطبيقك.

مفاتيح وصف الاستخدام المطلوبة:

  • NSBluetoothAlwaysUsageDescription
  • NSLocalNetworkUsageDescription

بالإضافة إلى مفاتيح وصف الاستخدام، يجب أيضًا إضافة مفتاح NSBonjourServices مع قائمة بأنواع الخدمات التي سيتصفّحها التطبيق. يمكن إنشاء نوع الخدمة الوحيد الذي يجب إضافته من خلال استخدام أول 12 بايت من تجزئة SHA-256 لمعرّف الخدمة الخاص بتطبيقك.

يمكنك استخدام الأداة التالية لإنشاء هذه القيمة تلقائيًا: