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

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

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

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

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

تتوفّر واجهة برمجة التطبيقات Google Nearby Messages API لنظام التشغيل iOS كمجموعة CocoaPods. ‫CocoaPods هو أداة مفتوحة المصدر لإدارة الملحقات لمشاريع Swift وObjective-C Cocoa.

إذا لم تكن تمتلك أداة 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، عليك إضافة عنوان ربط إلى مشروعك حتى يتمكّن من استخدام المكتبات التي تم تثبيتها بواسطة ملف pod. اتّبِع الخطوات التالية لإضافة عنوان ربط:

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

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

لاستخدام واجهات برمجة تطبيقات "الرسائل عن قرب"، يجب أن يكون لديك حساب Google. إذا كان لديك حساب، يعني هذا أنّك قد انتهيت من عملية إعداد حسابك. قد تحتاج أيضًا إلى استخدام حساب Google منفصل لأغراض الاختبار.

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

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

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

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

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")