Facebook iOS SDK 新手指南

若要將您的 iOS 應用程式與 Facebook 整合,Facebook iOS SDK 是最簡單的方式。此 SDK 提供了下列功能:

有兩種方法可用於設定應用程式來使用 Facebook SDK。如果尚未在 Facebook 註冊您的應用程式,使用「快速入門」工具是最簡單快速的方法。或者您也可以略過「快速入門」,改用以下的手動指示。

iOS 快速入門

步驟 1:針對 iOS 設定 Facebook 應用程式

  1. 點擊底下的按鈕以開啟 Facebook 應用程式主控板,並選擇您的應用程式。
  2. 開啟 Facebook 應用程式主控板

  3. 從左側導覽中選擇設定
  4. 點擊頁面底端的新增平台,然後選擇 iOS
  5. 在 XCode 中找到您的套件組合識別碼,然後將其複製到剪貼簿。
  6. 返回應用程式主控板,然後將您的套件組合識別碼貼到套件組合編號欄位中。
  7. 啟用單一登入
  8. 點擊應用程式主控板視窗底部的儲存變更

步驟 2:下載 Facebook iOS SDK

  1. 使用底下的按鈕下載 SDK。
  2. 下載 iOS SDK

  3. 將封存檔案解壓縮至 ~/Documents/FacebookSDK

步驟 3:將 SDK 加入專案

若要在 Xcode 中新增 SDK:

  1. 開啟應用程式的 Xcode 專案。
  2. 如果專案中沒有 Frameworks 群組,請建立該群組。
  3. 使用 Finder 開啟 ~/Documents/FacebookSDK
  4. Bolts.frameworkFBSDKCoreKit.frameworkFBSDKLoginKit.frameworkFBSDKShareKit.framework 檔案拖曳至 Xcode Project Navigator(專案導覽器)中的 Frameworks 群組。在顯示的對話方塊中,選擇 Create groups for any added folders(為任何新增的資料夾建立群組),並取消選取 Copy items if needed(必要時複製項目)。這樣會參照您安裝的 SDK 位置,而不會將 SDK 複製到應用程式中。
  5. 在專案中開啟 Xcode 的 Build Settings(組建設定)頁籤。
  6. ~/Documents/FacebookSDK 加入專案的 Framework Search Paths(架構搜尋路徑)設定。

使用 Facebook SDK 時,您的應用程式會自動記錄發生的事件,並收集資料以供 Facebook 分析工具使用,除非您停用自動事件記錄功能。如需深入瞭解應用程式將收集哪些資料,以及如何停用自動事件記錄,請參閱自動應用程式事件記錄

步驟 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:連接應用程式委派

對於需要您切換至原生 Facebook 應用程式或 Safari(例如「Facebook 登入」或 Facebook 對話方塊)的動作,若要後續處理這些動作產生的結果,您必須將 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 分析工具主控板,並選擇您的應用程式。
  3. 開啟 Facebook 分析工具

  4. 在左側的功能表中,選擇活動 -> 事件

事件主控板會需要些許時間,才會顯示您的啟動事件。如果沒看到任何資訊,請稍候片刻再重新整理頁面。

後續步驟

若要瞭解如何在應用程式中實作應用程式事件和其他 Facebook 產品,請點擊底下的按鈕。

在 iOS 中分享新增 Facebook 登入新增應用程式事件使用圖形 APIiOS 專用「讚」按鈕
進階設定