بدء استخدام 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 (لوحة معلومات التطبيق)".

الخطوة 2: تنزيل Facebook SDK لنظام iOS

  1. قم تنزيل SDK باستخدام الزر أدناه.
  2. تنزيل مجموعة iOS SDK

  3. قم بفك ضغط الأرشيف إلى ~/Documents/FacebookSDK.

الخطوة 3: إضافة SDK إلى المشروع

لإضافة مجموعة SDK إلى Xcode:

  1. قم بفتح مشروع Xcode لتطبيقك.
  2. إذا لم يكن لديك مجموعة Frameworks (أُطر العمل) في مشروعك فقم بإنشاء واحدة.
  3. افتح ~/Documents/FacebookSDK باستخدام "Finder (أداة البحث)".
  4. قم بسحب ملفات Bolts.framework وFBSDKCoreKit.framework وFBSDKLoginKit.framework وFBSDKShareKit.framework إلى مجموعة Frameworks (أُطر العمل) في Project Navigator (أداة التنقل في المشروع) في Xcode. في مربع الحوار الذي يتم عرضه، اختر Create groups for any added folders (إنشاء مجموعات لأية مجلدات مضافة) وقم بإلغاء تحديد Copy items if needed (نسخ العناصر عند الضرورة). يشير هذا إلى مجموعة SDK التي قمت بتثبيتها بدلاً من نسخ SDK إلى داخل التطبيق.
  5. افتح علامة تبويب Build Settings (إعدادات النسخة) في مشروعك.
  6. قم بإضافة ~/Documents/FacebookSDK إلى إعداد Framework Search Paths (مسارات البحث عن أُطر العمل) لمشروعك.

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

الخطوة 4: تكوين مشروع Xcode

<key>CFBundleURLTypes</key>
<array>
  <dict>
  <key>CFBundleURLSchemes</key>
  <array>
    <string>fb[APP_ID]</string>
  </array>
  </dict>
</array>
<key>FacebookAppID</key>
<string>[APP_ID]</string>
<key>FacebookDisplayName</key>
<string>[APP_NAME]</string>

الخطوة 5: ربط تفويض التطبيق

لإجراء معالجة لاحقة لنتائج الإجراءات التي تتطلب التبديل إلى تطبيق فيسبوك الأصلي أو 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 مطلوبًا كي تعمل الروابط المؤجلة إلى مواضيع معينة بشكل صحيح.

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

والآن وبعد تثبيت مجموعة 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 (الأحداث).

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

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

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

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