بدء استخدام Facebook SDK لنظام iOS

تعتبر مجموعة Facebook SDK لنظام iOS أسهل طريقة لتنفيذ تكامل تطبيق iOS مع فيسبوك. وتتيح لك ما يلي:

تتوفر أمامك طريقتان لإعداد تطبيقك لاستخدام Facebook SDK. إذا لم تكن قد سجلت تطبيقك على فيسبوك، فإن أسهل وأسرع طريقة للقيام بذلك هي استخدام أداة البدء السريع. والحل البديل هو تخطي أداة البدء السريع واتباع تعليمات التنفيذ اليدوي أدناه.

البدء السريع لنظام iOS

الخطوة 1: تكوين إعدادات تطبيق فيسبوك لنظام iOS

  1. افتح "Facebook App Dashboard (لوحة معلومات تطبيق فيسبوك)" عن طريق النقر على الزر أدناه وتحديد تطبيقك.
  2. افتح "Facebook App Dashboard (لوحة معلومات تطبيق فيسبوك)"

  3. حدد Settings (الإعدادات) من قائمة التنقل اليمنى.
  4. انقر على Add Platform (إضافة منصة) أسفل الصفحة وحدد iOS.
  5. حدد موقع معرف الحزمة في Xcode وانسخه إلى الحافظة.
  6. قم بالرجوع إلى "App Dashboard (لوحة معلومات التطبيق)" والصق معرف الحزمة في حقل Bundle ID (معرف الحزمة).
  7. قم بتمكين Single Sign On (تسجيل الدخول الموحد).
  8. انقر على Save Changes (حفظ التغييرات) أسفل إطار "App Dashboard (لوحة معلومات التطبيق)".

للربط دومًا بأحدث إصدار، اربط مجموعة SDK لنظام iOS في فيسبوك بتطبيق CocoaPods.

  1. انتقل إلى مجلد مشروعك في نافذة وحدة طرفية.
  2. يجب التأكد من تثبيت مكتبة CocoaPods على جهازك قبل محاولة تثبيت وحدة pod لتسجيل دخول فيسبوك.
    $ sudo gem install cocoapods
    $ pod init
    سيؤدي ذلك إلى إنشاء ملف يحمل اسم Podfile في الدليل الجذر لمشروعك.

  3. قم بإضافة ما يلي إلى ملف Podfile:
    pod 'FBSDKLoginKit'
  4. قم بتشغيل الأمر التالي في الدليل الجذر لمشروعك من نافذة وحدة طرفية:
    $ pod install

الخطوة 3: تكوين Info.plist

  1. في Xcode، انقر بزر الماوس الأيمن على ملف Info.plist الخاص بمشروعك وحدد Open As (فتح كـ) -> Source Code (مصدر الرمز البرمجي).
  2. أدخل جزء XML التالي في نص ملفك قبل عنصر </dict> النهائي.

  3. <key>CFBundleURLTypes</key>
    <array>
      <dict>
        <key>CFBundleURLSchemes</key>
        <array>
          <string>fb{your-app-id}</string>
        </array>
      </dict>
    </array>
    <key>FacebookAppID</key>
    <string>{your-app-id}</string>
    <key>FacebookDisplayName</key>
    <string>{your-app-name}</string>
    <key>LSApplicationQueriesSchemes</key>
    <array>
      <string>fbapi</string>
      <string>fb-messenger-share-api</string>
      <string>fbauth2</string>
      <string>fbshareextension</string>
    </array>
  4. استبدل {your-app-id} و{your-app-name} بمعرف تطبيقك واسمه الموجودين في لوحة معلومات التطبيق في فيسبوك.

الخطوة 4. ربط تفويض التطبيق

لإجراء معالجة لاحقة لنتائج الإجراءات التي تتطلب منك التبديل إلى تطبيق فيسبوك الأصلي أو Safari، مثل تسجيل دخول فيسبوك أو مربعات حوار فيسبوك، يجب ربط فئة AppDelegate لديك بكائن FBSDKApplicationDelegate. ولإجراء ذلك، أضف الرمز البرمجي التالي إلى ملف AppDelegate.m لديك.

//  AppDelegate.m
#import <FBSDKCoreKit/FBSDKCoreKit.h>

- (BOOL)application:(UIApplication *)application 
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
  [[FBSDKApplicationDelegate sharedInstance] application:application
    didFinishLaunchingWithOptions:launchOptions];
  // Add any custom logic here.
  return YES;
}

- (BOOL)application:(UIApplication *)application 
            openURL:(NSURL *)url 
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {

  BOOL handled = [[FBSDKApplicationDelegate sharedInstance] application:application
    openURL:url
    sourceApplication:options[UIApplicationOpenURLOptionsSourceApplicationKey]
    annotation:options[UIApplicationOpenURLOptionsAnnotationKey]
  ];
  // Add any custom logic here.
  return handled;
}

ملاحظة: في نموذج تنفيذ -application:openURL:sourceApplication:annotation: أعلاه، يلزم استدعاء FBSDKApplicationDelegate لرابط موضع معين مؤجل بغرض العمل بشكل صحيح.

الخطوة 5: إضافة أحداث التطبيق

والآن وبعد تثبيت مجموعة SDK وتكوينها، فإن أسهل طريقة لاختبارها هي إضافة أحداث التطبيق إلى تطبيقك. تساعدك أحداث التطبيق على فهم طريقة استخدام الأشخاص لتطبيقك. يتم ذلك عن طريق تسجيل الأحداث من خلال حدث من 14 حدثًا سابق التحديد مثل إضافة إلى عربة التسوق في تطبيق تجارة أو تحقيق المستوى في لعبة. يمكنك أيضًا تحديد أحداثك المخصصة.

تسجيل عمليات تنشيط التطبيق

لمعرفة عدد مستخدمي تطبيقك، سجّل عمليات تنشيط التطبيق من خلال إضافة الرمز البرمجي التالي إلى ملف AppDelegate.m لديك.

//  AppDelegate.m
#import <FBSDKCoreKit/FBSDKCoreKit.h>
- (void)applicationDidBecomeActive:(UIApplication *)application {
  [FBSDKAppEvents activateApp];
}

للتحقق من التسجيل:

  1. قم بتجميع تطبيقك وتشغيله.
  2. انتقل إلى لوحة معلومات Facebook Analytics ثم حدد تطبيقك.
  3. افتح Facebook Analytics

  4. من القائمة الموجودة على اليمين، حدد Activity (النشاط) -> Events (الأحداث).

سيكون هناك تأخير بسيط قبل عرض عمليات التنشيط على لوحة معلومات الأحداث. في حالة عدم رؤية أية عمليات تنشيط، يرجى الانتظار بعض الوقت وتحديث الصفحة.

عند استخدام مجموعة Facebook SDK، يتم تسجيل بعض الأحداث التي تتم في تطبيقك تلقائيًا ويتم تجميع بياناتها لاستخدامها في Facebook Analytics إلا إذا قمت بتعطيل التسجيل التلقائي للأحداث. للحصول على المزيد من التفاصيل حول المعلومات التي يتم تجميعها وكيفية تعطيل التسجيل التلقائي للأحداث، يمكنك الرجوع إلى التسجيل التلقائي لأحداث التطبيق.

الخطوات التالية

لمعرفة كيفية تنفيذ أحداث التطبيق ومنتجات فيسبوك الأخرى لتطبيقك، انقر على أحد الأزرار أدناه.

المشاركة في نظام iOSإضافة تسجيل دخول فيسبوكإضافة أحداث التطبيقاستخدام Graph API
تكوين متقدم