Facebook iOS SDK 新手指南
本指南會講解如何使用 Facebook iOS SDK 將您的 iOS 應用程式與 Facebook 整合。
由 SDK v13.0 版開始，您必須為所有對 Graph API 的呼叫提供用戶端憑證。
Facebook SDK 允許：
- Facebook 登入 — 透過 Facebook 憑證驗證用戶身分。
- 「分享」和「傳送」對話框 — 啟用從應用程式分享內容到 Facebook 的功能。
- 應用程式事件 — 記錄應用程式內的事件。
- Graph API — 讀取 API 並寫入內容。
第 1 步：設定開發環境
- 在 Xcode 中，點擊 File > Swift Packages > Add Package Dependency。
- 在畫面出現的對話框中輸入資料庫網址：https://github.com/facebook/facebook-ios-sdk。
- 在 Version 中，選擇 Up to Next Major 並選擇預設選項。
- 跟從提示，選擇想在專案中使用的資料庫。
| 如果您想 | 將此專案套件加至您的專案 |
|---|---|
允許您的應用程式使用 Facebook 服務 |
|
允許用戶登入應用程式，以及讓應用程式要求獲取數據存取權限 |
|
允許您的應用程式在 Facebook 上分享內容 |
|
允許用戶登入您的應用程式，以允許他們參與互動並推廣社交功能 |
|
第 2 步：配置您的專案
使用包含您應用程式資料的 XML 程式碼片段，配置
Info.plist 檔案。 在您整合 Facebook 登入後，除非您停用事件自動記錄功能，否則系統會為事件管理工具自動記錄並蒐集特定應用程式事件。若要進一步了解系統會蒐集哪些資料，以及如何停用事件自動記錄功能，請參閱應用程式事件自動記錄一文。
- 在
Info.plist點擊右鍵，然後選擇開啟格式 ▸ 原始碼。 - 複製下列 XML 程式碼片段，並將之貼至檔案內文（
<dict>...</dict>）。 - 在
[CFBundleURLSchemes]鍵值的<array><string>中，將 [APP-ID] 替換為您的應用程式編號。 - 在
FacebookAppID鍵值的<string>中，將 [APP-ID] 替換為您的應用程式編號。 - 在
FacebookClientToken鍵值的<string>中，將 [CLIENT-TOKEN] 替換為您在應用程式管理中心的設定 > 進階 > 用戶端憑證中找到的值。 - 在
FacebookDisplayName鍵值的<string>中，將 [APP-NAME] 替換為您的應用程式名稱。 - 如要使用任何會使應用程式切換至 Facebook 應用程式的 Facebook 對話框，如登入對話框、分享對話框、應用程式邀請對話框等，您應用程式的
Info.plist也必須包含以下項目：
您可以在 Info.plist 將 FacebookAutoLogAppEventsEnabled 加為鍵，以直接將自動蒐集應用程式事件的功能設為「true」或「false」。
- 配置應用程式目標時，選擇登入和功能分頁中的 + 功能按鈕。
- 找出並選擇鑰匙圈共享功能。
- 確保目標已列出鑰匙圈共享功能。
第 3 步：連接應用程式委派
將
AppDelegate.swift 方法中的程式碼替換為以下程式碼。此程式碼會在應用程式啟動時初始化 SDK，並在您執行登入或分享操作時，允許 SDK 處理原生 Facebook 應用程式所產生的登入和分享事件。否則，用戶必須登入 Facebook 以使用應用程式內瀏覽器登入。
// AppDelegate.swift
import UIKit
import FacebookCore
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
ApplicationDelegate.shared.application(
application,
didFinishLaunchingWithOptions: launchOptions
)
return true
}
func application(
_ app: UIApplication,
open url: URL,
options: [UIApplication.OpenURLOptionsKey : Any] = [:]
) -> Bool {
ApplicationDelegate.shared.application(
app,
open: url,
sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
annotation: options[UIApplication.OpenURLOptionsKey.annotation]
)
}
}
iOS 13 已將開啟網址的功能移至
SceneDelegate。如果您正在使用 iOS 13，請將以下方法加到 SceneDelegate 中，以便登入或分享等操作能如預期執行：
// SceneDelegate.swift
import FacebookCore
...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
guard let url = URLContexts.first?.url else {
return
}
ApplicationDelegate.shared.application(
UIApplication.shared,
open: url,
sourceApplication: nil,
annotation: [UIApplication.OpenURLOptionsKey.annotation]
)
}
第 4 步：建立專案，然後在模擬器中執行
在 Xcode，選擇 iOS 模擬器並點擊 Run。Xcode 會為您建立專案，然後啟動模擬器所執行應用程式的最新版本。
第 5 步：在事件管理工具中查看結果
請注意：事件最多可能需要 20 分鐘之後才會在管理中心顯示。