開始使用 iOS 專用 Facebook SDK

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

有 2 種方式可以設定應用程式以使用 Facebook SDK。如果您尚未在 Facebook 註冊您的應用程式,最簡單、快速的方式就是使用「快速入門」工具。或者您也可以跳過「快速入門」,直接使用下方的手動操作指示。

iOS 專用快速入門

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

  1. 點擊下方的按鈕並選擇您的應用程式,以開啟 Facebook 應用程式管理中心。
  2. 開啟 Facebook 應用程式管理中心

  3. 在左側導覽選單中選擇設定
  4. 點擊網頁下方的新增平台,然後選擇 iOS
  5. 在 Xcode 中找到程式套件識別碼,然後複製到剪貼簿上。
  6. 返回應用程式管理中心,將程式套件識別碼貼上程式套件編號欄位。
  7. 啟用單一登入
  8. 點擊應用程式管理中心視窗下方的儲存變更

步驟 2:下載 iOS 專用 Facebook SDK

  1. 使用下方按鈕下載 SDK
  2. 下載 iOS SDK

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

步驟 3:將 SDK 新增至專案

若要在 Xcode 中新增 SDK:

  1. 開啟應用程式的 Xcode 專案。
  2. 如果您的專案中沒有 Frameworks 群組,請自行建立一個。
  3. 使用搜尋視窗開啟 ~/Documents/FacebookSDK
  4. 拖曳 Bolts.frameworkFBSDKCoreKit.frameworkFBSDKLoginKit.frameworkFBSDKShareKit.framework 檔案至 Xcode 專案導覽器中的 Frameworks 群組。在顯示的對話框中,選取為所有新增資料夾建立群組,並取消選取必要時複製項目。這樣會參照您安裝的 SDK,而不會將 SDK 複製到應用程式中。
  5. 開啟 Xcode 專案內的建立設定標籤。
  6. ~/Documents/FacebookSDK 新增至專案的架構搜尋路徑設定。

使用 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 登入新增應用程式事件使用 Graph APIiOS 專用的「讚好」按鈕
進階配置