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. 點擊應用程式主控板視窗底部的儲存變更

若要確保一律連結至最新版本,請使用 CocoaPods 來連結到 Facebook iOS SDK。

  1. 從終端機視窗前往專案資料夾。
  2. 安裝 Facebook 登入 Pod 前,請務必先在裝置上安裝 CocoaPods Gem。
    $ 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. 用您在 Facebook 應用程式主控板上找到的應用程式編號和名稱,取代 {your-app-id}{your-app-name}

步驟 4:連接應用程式委派

對於需要您切換至原生 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,才能讓延遲深層連結正確運作。

步驟 5:新增應用程式事件

現在已安裝並設定 SDK,最簡單的測試方法就是將應用程式事件新增至您的應用程式。應用程式事件可協助您瞭解用戶如何使用您的應用程式。透過記錄 14 種預先定義事件的其中一種(例如在商務應用程式中記錄已加到購物車,或在遊戲中記錄破關),就能達成這個目的。您還可以自行定義自訂事件。

記錄應用程式啟動

若要得知有多少用戶正在使用您的應用程式,請將下列程式碼加入 AppDelegate.m 檔案,即可記錄應用程式啟動。

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

若要確認紀錄:

  1. 編譯並執行應用程式。
  2. 前往 Facebook 分析工具主控板,並選擇您的應用程式。
  3. 開啟 Facebook 分析工具

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

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

使用 Facebook SDK 時,只要未停用自動記錄事件功能,系統都會自動記錄及收集您應用程式的某些事件供 Facebook 分析工具使用。若要深入瞭解會收集哪些資料,以及如何停用自動事件記錄功能,請參閱自動記錄應用程式事件

後續步驟

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

在 iOS 中分享新增 Facebook 登入新增應用程式事件使用圖形 API
進階設定