البدء

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

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

لإنشاء مشروع باستخدام واجهة برمجة التطبيقات لتطبيق "الرسائل عن قرب" من Google لنظام التشغيل iOS، تحتاج إلى الإصدار 6.3 أو إصدار أحدث من Xcode.

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

تتوفّر واجهة برمجة تطبيقات "رسائل Google القريبة" لنظام التشغيل iOS على شكل لوحة CocoaPods. CocoaPods هو مدير تبعية مفتوح المصدر لمشروعات Swift وObjective-C Cocoa.

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

$ sudo gem install cocoapods

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

أنشِئ Podfile لواجهة برمجة التطبيقات لتطبيق "الرسائل القريبة من Google" لنظام التشغيل iOS واستخدِمها لتثبيت واجهة برمجة التطبيقات وتبعياتها.

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

  • عدِّل Podfile وأضِف التبعيات. في ما يلي مواصفات Podspec بسيطة، تتضمّن اسم المجموعة التي تحتاج إليها لواجهة برمجة تطبيقات "الرسائل القريبة من Google" لنظام التشغيل iOS: 

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

  • احفظ Podfile.

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

    قرص مضغوط بقيمة

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

    تثبيت مجموعة الإعلانات المتسلسلة

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

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

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

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

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

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

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

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