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

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

• تسجيل دخول فيسبوك - يتيح مصادقة الأشخاص عن طريق بيانات اعتمادهم على فيسبوك.
• مربعا الحوار مشاركة وإرسال - يتيحان مشاركة المحتوى من تطبيقك إلى فيسبوك.
• أحداث التطبيق - تتيح تسجيل الأحداث داخل تطبيقك.
• Graph API - يمكنك قراءة Graph API والكتابة إليها.

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

التكوين اليدوي

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

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

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

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

الخطوة 5: ربط App Delegate (تفويض التطبيق)

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

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

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

افتح "Facebook App Dashboard (لوحة معلومات تطبيق فيسبوك)"

2. حدد Settings (الإعدادات) من قائمة التنقل اليمنى.
3. انقر على Add Platform (إضافة منصة) أسفل الصفحة وحدد iOS.
4. حدد موقع معرف الحزمة في Xcode وانسخه إلى الحافظة.



5. قم بالرجوع إلى "App Dashboard (لوحة معلومات التطبيق)" والصق معرف الحزمة في حقل Bundle ID (معرف الحزمة).



6. قم بتمكين Single Sign On (تسجيل الدخول الموحد).
7. انقر على Save Changes (حفظ التغييرات) أسفل إطار "App Dashboard (لوحة معلومات التطبيق)".

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

1. قم تنزيل SDK باستخدام الزر أدناه.

تنزيل SDK لنظام iOS

2. قم بفك ضغط الأرشيف إلى ~/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 into destination group's folder (نسخ العناصر إلى مجلد المجموعة الوجهة). يشير هذا إلى مجموعة SDK التي قمت بتثبيتها بدلاً من نسخ SDK إلى داخل التطبيق.
5. افتح علامة تبويب Build Settings (إعدادات النسخة) في مشروعك.
6. قم بإضافة ~/Documents/FacebookSDK إلى إعداد Framework Search Paths (مسارات البحث عن أُطر العمل) لمشروعك.

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

1. في Xcode، انقر بزر الماوس الأيمن على ملف .plist لمشروعك وحدد Open As (فتح كـ) -> Source Code (رمز برمجي مصدر).

2. أدخل جزء XML التالي في نص ملف قبل عنصر </dict> النهائي.

<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-api</string>
  <string>fbauth2</string>
  <string>fbshareextension</string>
</array>
<key>NSPhotoLibraryUsageDescription</key>
  <string>{human-readable reason for photo access}</string>

3. قم باستبدال fb{your-app-id} بمعرف تطبيق فيسبوك مسبوقًا بالبادئة fb. على سبيل المثال fb123456. يمكنك العثور على هذا المعرف في Facebook App Dashboard (لوحة معلومات تطبيق فيسبوك).
4. قم باستبدال {your-app-id} بمعرف التطبيق.
5. قم باستبدال {your-app-name}باسم العرض الذي حددته في "لوحة معلومات التطبيق (App Dashboard)".
6. استبدل {human-readable reason for photo access} بالسبب وراء احتياج تطبيقك للوصول إلى الصورة.

الخطوة 5: ربط App Delegate (تفويض التطبيق)

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

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

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

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

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

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

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

1. قم بتجميع تطبيقك وتشغيله.
2. انتقل إلى Analytics for Apps Dashboard (لوحة معلومات Analytics for Apps) ثم حدد تطبيقك.

افتح Analytics for Apps Dashboard (لوحة معلومات Analytics for Apps)

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

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

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

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