البدء

يوضّح هذا المستند كيفية بدء التطوير باستخدام 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: الحصول على مفتاح واجهة برمجة التطبيقات

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