البدء

يوضّح هذا المستند كيفية بدء التطوير باستخدام Nearby Messages API على iOS.

الخطوة 1: الحصول على أحدث إصدار من Xcode

لإنشاء مشروع باستخدام Google Nearby Messages API على iOS، يجب أن يكون لديك الإصدار 6.3 أو إصدار أحدث من Xcode.

الخطوة 2: الحصول على CocoaPods

تتوفّر Google Nearby Messages API على iOS كحزمة CocoaPods. ‫CocoaPods هو نظام مفتوح المصدر لإدارة التبعيات في مشاريع Cocoa التي تستخدم لغتَي Swift وObjective-C.

إذا لم تكن لديك أداة CocoaPods، يمكنك تثبيتها على OS X من خلال تنفيذ الأمر التالي من الوحدة الطرفية. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل بدء استخدام CocoaPods.

$ sudo gem install cocoapods

الخطوة 3: تثبيت واجهة برمجة التطبيقات باستخدام CocoaPods

أنشِئ ملف Podfile لـ Google Nearby Messages API على iOS واستخدِمه لتثبيت واجهة برمجة التطبيقات والملفات التابعة لها.

  • إذا لم يكن لديك مشروع Xcode بعد، أنشِئه الآن واحفظه على جهازك المحلي. (إذا كنت جديدًا على تطوير تطبيقات iOS، أنشِئ تطبيقًا بعرض واحد وتأكَّد من تفعيل ميزة "استخدام عدّ المَراجع التلقائي").
  • أنشِئ ملفًا باسم Podfile في دليل مشروعك. يحدّد هذا الملف الملفات التابعة لمشروعك.

  • عدِّل ملف Podfile وأضِف الملفات التابعة. في ما يلي ملف Podspec بسيط يتضمّن اسم الحزمة التي تحتاج إليها لـ Google Nearby Messages API على iOS: 

    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'

  • احفظ ملف Podfile.

  • افتح وحدة طرفية وانتقِل إلى الدليل الذي يحتوي على ملف Podfile:

    $ cd

  • نفِّذ الأمر pod install. سيؤدي ذلك إلى تثبيت واجهات برمجة التطبيقات المحدّدة في ملف Podspec، بالإضافة إلى أي ملفات تابعة قد تكون مرتبطة بها.

    $ pod install

  • أغلِق Xcode، ثم افتح (انقر مرّتين) ملف .xcworkspace الخاص بمشروعك لتشغيل Xcode. اعتبارًا من هذه اللحظة، يجب استخدام ملف .xcworkspace لفتح المشروع.

الخطوة 4: إنشاء عنوان ربط (لغة Swift فقط)

إذا أنشأت مشروعك باستخدام لغة Swift، يجب إضافة عنوان ربط إلى مشروعك حتى يتمكّن من استخدام المكتبات التي تم تثبيتها بواسطة ملف الحزمة. اتّبِع الخطوات التالية لإضافة عنوان ربط:

  1. في الدليل نفسه الذي يحتوي على ملف .xcworkspace الخاص بمشروعك، أضِف ملف عنوان جديدًا (يمكنك تسميته بأي اسم واستخدام امتداد اسم الملف ".h").
  2. الصِق الرمز البرمجي التالي في الملف الذي أنشأته: #import <GNSMessages.h>.
  3. احفظ الملف.
  4. في اللوحة اليمنى لمحرّر المشروع، اختَر المشروع الرئيسي.
  5. انقر على إعدادات الإصدار في أعلى محرّر الإصدار.
  6. في "إعدادات الإصدار"، انتقِل إلى "مُجمِّع Swift - إنشاء الرمز البرمجي" (اكتب "مُجمِّع Swift" في مربّع البحث للعثور عليه بسرعة).
  7. انقر على السهم لتوسيع قسم عنوان ربط Objective-C.
  8. ضمن تصحيح الأخطاء والإصدار، أضِف مسار ملف العنوان الذي أنشأته.
  9. أنشِئ المشروع لتطبيق التغييرات.

الخطوة 5: الحصول على حساب على Google

لاستخدام Nearby Messages APIs، يجب أن يكون لديك حساب Google. إذا كان لديك حساب، لست بحاجة إلى اتخاذ أي إجراءات إضافية. ننصحك أيضًا باستخدام حساب Google منفصل لأغراض الاختبار.

الخطوة 6: الحصول على مفتاح واجهة برمجة تطبيقات

اتّبِع الخطوات التالية لتفعيل Google Nearby Messages API على iOS والحصول على مفتاح واجهة برمجة تطبيقات:

  1. انتقِل إلى Google Developers Console.
  2. أنشِئ مشروعًا أو اختَره لتسجيل تطبيقك.
  3. انقر على متابعة لتفعيل واجهة برمجة التطبيقات.
  4. في صفحة بيانات الاعتماد ، أنشِئ مفتاح iOS جديدًا (واضبط بيانات اعتماد واجهة برمجة التطبيقات).
    ملاحظة: إذا كان لديك مفتاح iOS حالي، يمكنك استخدامه.
  5. في مربّع الحوار الناتج، أدخِل معرّف حزمة تطبيقك. على سبيل المثال: 
    com.example.nearbyexample
  6. يظهر مفتاح iOS API الجديد في قائمة مفاتيح واجهة برمجة التطبيقات لمشروعك. مفتاح واجهة برمجة التطبيقات هو سلسلة من الأحرف، مثل: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. لمنع سرقة الحصص، عليك حماية مفتاح واجهة برمجة التطبيقات باتّباع أفضل الممارسات هذه .

الخطوة 7: إنشاء عنصر مدير الرسائل

يتيح لك عنصر مدير الرسائل النشر والاشتراك. لا يتم التحقّق من هوية مستخدمي تبادل الرسائل، لذا يجب تقديم مفتاح واجهة برمجة التطبيقات الذي أنشأته في الخطوة السابقة.

Objective-C

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")