スタートガイド - iOS用Facebook SDK

iOS用Facebook SDKを使用すると、iOSアプリをFacebookに簡単に統合できます。次の機能が利用可能になります。

開始する前に

以下の手順は、iOSとXcodeの最新バージョンを使用していることを前提としています。詳しくは、こちらのApple Developerを参照してください。

以下が必要です。

  • Facebook for Developersのアカウント: アカウントが必要な場合は、このボタンをクリックし、手順説明に従います。
Facebook for Developersのアカウントを作成する

  • アプリのアプリID: このボタンをクリックし、手順説明に従ってアプリを登録し、アプリIDを取得します。
アプリのアプリIDを取得する

ステップ1: 開発環境を設定する

  1. Xcodeで、[File] > [Swift Packages] > [Add Package Dependency]の順にクリックします。
  2. 表示されるダイアログで、次のリポジトリURLを入力します: https://github.com/facebook/facebook-ios-sdk
  3. [Version]で、[Up to Next Major]を選択し、デフォルトのオプションを指定します。
  4. プロンプトを完了し、プロジェクトで使用するライブラリを選択します。

ステップ2: プロジェクトを構成する

情報プロパティリストファイル(info.plist)を、アプリに関するデータが含まれているXMLスニペットで構成します。
  1. info.plistを右クリックし、[Open As Source Code]を選択します。
  2. 次のXMLスニペットをコピーして、ファイルの本文(<dict>...</dict>)に貼り付けます。
    <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>
  3. キー[CFBundleURLSchemes]<array><string>にある[APP_ID]は、ご自身のアプリIDに置き換えてください。
  4. キーFacebookAppID<string>にある[APP_ID]は、ご自身のアプリIDに置き換えてください。
  5. キーFacebookDisplayName<string>にある[APP_NAME]は、ご自身のアプリの名前に置き換えてください。
  6. Facebookアプリへのアプリ切り替えを実行できるいずれかのFacebookダイアログ(ログイン、シェア、アプリの招待など)を使用するには、アプリのinfo.plist<dict>...</dict>も含める必要があります。
    <key>LSApplicationQueriesSchemes</key> <array> <string>fbapi</string> <string>fbapi20130214</string> <string>fbapi20130410</string> <string>fbapi20130702</string> <string>fbapi20131010</string> <string>fbapi20131219</string> <string>fbapi20140410</string> <string>fbapi20140116</string> <string>fbapi20150313</string> <string>fbapi20150629</string> <string>fbapi20160328</string> <string>fbauth</string> <string>fb-messenger-share-api</string> <string>fbauth2</string> <string>fbshareextension</string> </array>

ステップ3: アプリデリゲートに接続する

AppDelegate.swiftのコードを次のコードに置き換えます。このコードにより、アプリの起動時にSDKが初期化され、ログインまたはシェアアクションを実行したときにネイティブFacebookアプリの結果をSDKが処理できるようになります。
// AppDelegate.swift import UIKit import FBSDKCoreKit @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に追加してください。
// SceneDelegate.swift 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:イベントマネージャで結果を確認する

Facebook Analyticsに送信したイベントは[イベントマネージャ] に表示されます。このコードで初めてアプリを起動した場合には、イベントが表示されるまで20分以上待つ必要があります。
注: ダッシュボードにイベントが表示されるまで最大20分ほどかかる場合があります。

次のステップ

アプリイベントや他のFacebook製品をアプリに実装する方法について詳しくは、以下のボタンをクリックしてください。

iOSでのシェアFacebookログインの追加アプリイベントを追加するグラフAPIの使用
詳細設定