البدء

يوضّح هذا المستند كيفية بدء التطوير باستخدام 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، أنشئ تطبيق Single View Application وتأكَّد من تفعيل خيار Use Automatic Reference Counting).
  • أنشِئ ملفًا باسم Podfile في دليل مشروعك. يحدّد هذا الملف التبعيات في مشروعك.

  • عدِّل Podfile وأضِف التبعيات. في ما يلي ملف Podspec بسيط يتضمّن اسم الحزمة المطلوبة لواجهة برمجة التطبيقات Google Nearby Messages لنظام التشغيل 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 الخاص بمشروعك، أضِف ملف عنوان جديدًا (يمكنك تسميته كما تريد واستخدام امتداد اسم الملف ".h").
  2. ألصِق الرمز التالي في الملف الذي أنشأته: #import <GNSMessages.h>.
  3. احفظ الملف.
  4. في اللوحة اليمنى لمحرّر المشروع، اختَر المشروع الرئيسي.
  5. انقر على إعدادات الإصدار في أعلى "محرّر الإصدار".
  6. في "إعدادات الإنشاء" (Build Settings)، انتقِل إلى "مترجم Swift البرمجي - إنشاء الرمز" (Swift Compiler - Code Generation) (اكتب "مترجم Swift البرمجي" (Swift Compiler) في مربّع البحث للعثور عليه بسرعة).
  7. انقر على السهم لتوسيع قسم Objective-C Bridging Header.
  8. ضمن تصحيح الأخطاء والإصدار، أضِف مسار ملف العنوان الذي أنشأته.
  9. أنشئ المشروع لتطبيق التغييرات.

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

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

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

اتّبِع الخطوات التالية لتفعيل واجهة برمجة التطبيقات Nearby Messages من Google على أجهزة 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")