يمكنك الانضمام إلى
قائمتنا البريدية للحصول على تحديثات وإعلانات عن الأجهزة المجاورة.
البدء
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تثبيت أحدث إصدار من Xcode
لاستخدام Nearby Connections في مشروعك، يجب توفُّر Xcode 13.0 أو إصدار أحدث.
إضافة حزمة Nearby Connections إلى مشروعك
يتضمّن Xcode مدير حِزم مدمجًا. لإضافة Nearby Connections إلى مشروع Xcode، اختَر ملف > إضافة حِزم… وابحث عن google/nearby. بعد ذلك، انقر على إضافة حزمة وانتظر حتى تكتمل العملية (قد يستغرق ذلك بضع دقائق).
طلب الوصول إلى الموارد المحمية
تتطلّب ميزة "الاتصال بالأجهزة القريبة" الوصول إلى كل من البلوتوث والشبكة المحلية من أجل عرض الإعلانات واكتشاف الأجهزة وإجراء الاتصالات ونقل البيانات. قدِّم وصفًا لطريقة الاستخدام لكل مورد مطلوب في Info.plist لتطبيقك. وفي حال عدم توفّرها، ستتعذّر محاولات الوصول إلى المورد، وقد يؤدي ذلك إلى تعطُّل تطبيقك.
مفاتيح وصف الاستخدام المطلوبة:
NSBluetoothAlwaysUsageDescriptionNSLocalNetworkUsageDescription
بالإضافة إلى مفاتيح وصف الاستخدام، يجب أيضًا إضافة مفتاح NSBonjourServices يتضمّن قائمة بأنواع الخدمات التي سيتصفّحها التطبيق.
يمكن إنشاء نوع الخدمة الوحيد الذي يجب إضافته من خلال أخذ أول 12 بايت من قيمة التجزئة SHA-256 لمعرّف خدمة تطبيقك.
يمكنك استخدام الأداة التالية لإنشاء هذه القيمة تلقائيًا:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Get started\n\nInstall the latest version of Xcode\n-----------------------------------\n\nTo use Nearby Connection in your project,\n[Xcode](https://developer.apple.com/xcode/) **13.0 or later** is required.\n\nAdd the Nearby Connections package to your project\n--------------------------------------------------\n\nXcode comes with a built-in package manager. To add Nearby Connections to your\nXcode project, select **File** \\\u003e **Add Packages...** and search for\n`google/nearby`. Then click **Add Package** and wait for the process to complete\n(this may take a few minutes).\n\nRequest access to protected resources\n-------------------------------------\n\nNearby Connections needs access to both Bluetooth and the local network to\nadvertise, discover, make connections, and transfer data. Provide a usage\ndescription for each resource needed, in your app's `Info.plist`. If you don't,\nattempts to access the resource will fail, and might even cause your app to\ncrash.\n\nRequired usage description keys:\n\n- `NSBluetoothAlwaysUsageDescription`\n- `NSLocalNetworkUsageDescription`\n\nIn addition to usage description keys, an `NSBonjourServices` key with a list of\nthe service types that will be browsed by the app, will also need to be added.\nThe only service type that must be added can be generated by taking the first 12\nbytes of the `SHA-256` hash of your app's service ID.\n\nYou can use the following tool to automatically generate this value for you: \nService ID\nGenerate\n\n```\n\n```"]]
