iOS SDK
 
 
 

開始使用 iOS 專用 Facebook SDK

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

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

iOS 專用快速入門

手動配置

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

步驟 2：下載 iOS 專用 Facebook SDK

步驟 3：將 SDK 新增至專案

步驟 4：配置 Xcode 專案

步驟 5：連接應用程式委派

步驟 6：新增應用程式事件

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

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

    2. 開啟 Facebook 應用程式管理中心

  2. 在左側導覽選單中選擇設定。
  3. 點擊網頁下方的新增平台，然後選擇 iOS。
  4. 在 Xcode 中找到程式套件識別碼，然後複製到剪貼簿上。

  5. 返回應用程式管理中心，將程式套件識別碼貼上程式套件編號欄位。

  6. 啟用單一登入。
  7. 點擊應用程式管理中心視窗下方的儲存變更。

步驟 2：下載 iOS 專用 Facebook SDK

  1. 使用下方按鈕下載 SDK

    2. 下載 iOS SDK

  2. 解壓縮檔案至 ~/Documents/FacebookSDK。

步驟 3：將 SDK 新增至專案

若要在 Xcode 中新增 SDK：

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

步驟 4：配置 Xcode 專案

  1. 在 Xcode 中的 .plist 檔案上點擊輔鍵，然後選擇開啟格式 -> 原始碼。

  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-api</string>
  <string>fbauth2</string>
  <string>fbshareextension</string>
</array>
<key>NSPhotoLibraryUsageDescription</key>
  <string>{human-readable reason for photo access}</string>
  3. 以您的 Facebook 應用程式編號取代 fb{your-app-id}，記得在開頭加上 fb。例如：fb123456。您可以使用 Facebook 應用程式管理中心中找到您的應用程式編號。
  4. 以您的應用程式編號取代 {your-app-id}。
  5. 以您在應用程式管理中心內指定的顯示名稱取代 {your-app-name}。
  6. 以您的應用程式需要相片存取權限的理由取代 {human-readable reason for photo access}。

步驟 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. 前往應用程式分析工具管理中心，並選擇您的應用程式。

    3. 開啟應用程式分析工具管理中心

  3. 從左側選單中選擇活動 -> 事件。

在事件管理中心顯示啟動次數之前，會有短暫的延遲時間。如果您沒有看到任何資料，請稍待片刻然後重新整理頁面。

後續步驟

若要瞭解如何在應用程式上建置「應用程式事件」和其他 Facebook 產品，請點擊下列其中一個按鈕。

在 iOS 中分享新增 Facebook 登入新增應用程式事件使用 Graph APIiOS 專用的「讚好」按鈕
進階配置