Documentation Index
Fetch the complete documentation index at: https://mintlify.com/facebook/facebook-ios-sdk/llms.txt
Use this file to discover all available pages before exploring further.
The SDK supports three package managers. Choose the one that matches your project’s tooling. You only need to add the modules your app uses — you don’t have to include the entire SDK.
All modules require FacebookCore (or FBSDKCoreKit in CocoaPods/Carthage) as a transitive dependency. You don’t need to add it explicitly when installing other modules.
Swift Package Manager
CocoaPods
Carthage
Swift Package Manager is the recommended approach for new projects.Open the package dependency dialog
In Xcode, choose File → Add Package Dependencies.
Enter the repository URL
Paste the following URL into the search field:https://github.com/facebook/facebook-ios-sdk
18.0.3 to receive non-breaking updates automatically. Select the modules you need
Xcode will list the available package products. Add only the ones your app requires:| Product | Use when you need |
|---|
FacebookCore | App events, Graph API, access tokens |
FacebookLogin | Facebook Login |
FacebookShare | Share and message dialogs |
FacebookGamingServices | Gaming integrations |
FacebookAEM | Aggregated Event Measurement |
Import in your source files
Import the modules you added at the top of each Swift file that uses them:import FacebookCore
import FacebookLogin
Install CocoaPods
If you don’t have CocoaPods installed, run:sudo gem install cocoapods
Add pods to your Podfile
Open your Podfile and add the pods for the modules you need:platform :ios, '12.0'
use_frameworks!
target 'YourApp' do
# Required for all SDK features
pod 'FBSDKCoreKit'
# Add only the pods you need
pod 'FBSDKLoginKit'
pod 'FBSDKShareKit'
pod 'FBSDKGamingServicesKit'
end
| Pod | Module |
|---|
FBSDKCoreKit | FacebookCore |
FBSDKLoginKit | FacebookLogin |
FBSDKShareKit | FacebookShare |
FBSDKGamingServicesKit | FacebookGamingServices |
Install dependencies
Run the following command from your project directory:Open the generated .xcworkspace file from now on instead of .xcodeproj. Import in your source files
import FacebookCore
import FacebookLogin
Install Carthage
If you don’t have Carthage installed: Add the dependency to your Cartfile
Create or open your Cartfile and add:github "facebook/facebook-ios-sdk"
github "facebook/facebook-ios-sdk" ~> 18.0
Build the frameworks
Run the following from your project directory:carthage update --use-xcframeworks --platform iOS
Carthage/Build/. Link the frameworks
In Xcode, go to your target’s General tab and drag the XCFrameworks you need from Carthage/Build/ into the Frameworks, Libraries, and Embedded Content section.Add only the frameworks your app uses.
Next steps
Once the SDK is installed, follow the Quickstart to configure your app ID and initialize the SDK.