Facebook SDK for iOS
This open-source library allows you to integrate Facebook into your iOS app.
Learn more about the provided samples, documentation, integrating the SDK into your app, accessing source code, and more
at https://developers.facebook.com/docs/ios
Please take a moment and subscribe to releases so that you can be notified about new features, deprecations, and critical fixes. To see information about the latest release, consult our changelog.
| :warning: Be Advised :warning: |
CocoaPods is no longer supported, starting with v19.0.1. The CocoaPods Specs repo is becoming read-only, so v19.0.0 is the last version of the Facebook SDK published to CocoaPods. Future releases, including bug fixes, will not be published to CocoaPods. Existing CocoaPods integrations will keep working on v19.0.0 and earlier, but will not receive updates. Please migrate to Swift Package Manager. See Migrating from CocoaPods. |
| :warning: Be Advised :warning: |
We have begun rewriting the iOS SDK in Swift in order to modernize the code base. Please monitor the changelog for updates to existing interfaces but keep in mind that some interfaces will be unstable during this process. As such, updating to a minor version may introduce compilation issues related to language interoperability. Using symbols now defined in Swift may require using @import syntax from Objective-C and using C++ will likely require workarounds like creating wrappers in Objective-C. Please bear with us as we work towards providing an improved experience for integrating with the Facebook platform. |
TRY IT OUT
Swift Package Manager
- In Xcode, select File > Add Package Dependencies.
- Enter the URL for this repository:
https://github.com/meta/facebook-ios-sdk
- Select the
Facebook-prefixed libraries you want to use
- Check-out the tutorials available online at: https://developers.facebook.com/docs/ios/getting-started
- Start coding! Visit https://developers.facebook.com/docs/ios for tutorials and reference documentation.
Migrating from CocoaPods
CocoaPods is not supported starting with v19.0.1. To keep receiving updates, move to Swift Package Manager:
-
Remove the Facebook SDK pods (FBSDKCoreKit, FBSDKLoginKit, etc.) from your Podfile.
-
Run pod install. If the Facebook SDK was your only pod, run pod deintegrate instead and open your .xcodeproj from now on instead of the .xcworkspace.
-
In Xcode, select File > Add Package Dependencies and enter https://github.com/meta/facebook-ios-sdk.
-
Choose the “Up to Next Major Version” rule, starting from 19.0.1.
-
Add the libraries that match the pods you removed:
| CocoaPods pod |
Swift Package Manager library |
FBSDKCoreKit |
FacebookCore |
FBSDKLoginKit |
FacebookLogin |
FBSDKShareKit |
FacebookShare |
FBSDKGamingServicesKit |
FacebookGamingServices |
FBAEMKit |
FacebookAEM |
FBSDKCoreKit_Basics |
FacebookBasics |
-
Clean the build folder (Product > Clean Build Folder) and rebuild.
Your existing imports, such as import FBSDKCoreKit and @import FBSDKCoreKit;, do not need to change.
If you can’t use Swift Package Manager, you can download prebuilt XCFrameworks for each version from the Releases page and add them to your project manually.
iOS 14 CHANGES
Data Disclosure
Due to the release of iOS 14, tracking events that your app collects and sends to Facebook may require you to disclosed these data types in the App Store Connect questionnaire. It is your responsibility to ensure this is reflected in your application’s privacy policy. Visit our blogpost for information on affected Facebook SDKs, APIs, and products and the Apple App Store Privacy Details article to learn more about the data types you will need to disclose.
link to FB blogpost https://developers.facebook.com/blog/post/2020/10/22/preparing-for-apple-app-store-data-disclosure-requirements/
apple store details https://developer.apple.com/app-store/app-privacy-details/
FEATURES
GIVE FEEDBACK
Please report bugs or issues to our designated developer support team – https://developers.facebook.com/support/bugs/ – as this will help us resolve them more quickly.
You can also visit our Facebook Developer Community Forum,
join the Facebook Developers Group on Facebook,
ask questions on Stack Overflow,
or open an issue in this repository.
CONTRIBUTE
Facebook welcomes contributions to our SDKs. Please see the CONTRIBUTING file.
LICENSE
See the LICENSE file.
Copyright © Meta Platforms, Inc
SECURITY POLICY
See the SECURITY POLICY for more info on our bug bounty program.
DEVELOPER TERMS
- By enabling Facebook integrations, including through this SDK, you can share information with Facebook, including
information about people’s use of your app. Facebook will use information received in accordance with our
Data Use Policy, including to provide you with insights about the
effectiveness of your ads and the use of your app. These integrations also enable us and our partners to serve ads on
and off Facebook.
- You may limit your sharing of information with us by updating the Insights control in the developer tool
https://developers.facebook.com/apps/{app_id}/settings/advanced.
- If you use a Facebook integration, including to share information with us, you agree and confirm that you have
provided appropriate and sufficiently prominent notice to and obtained the appropriate consent from your users
regarding such collection, use, and disclosure (including, at a minimum, through your privacy policy). You further
agree that you will not share information with us about children under the age of 13.
- You agree to comply with all applicable laws and regulations and also agree to our Terms
https://www.facebook.com/policies/, including our Platform Policies https://developers.facebook.com/policy/ and
Advertising Guidelines, as applicable https://www.facebook.com/ad_guidelines.php.
By using the Facebook SDK for iOS you agree to these terms.
评论