DOCSEARCHbyAlgolia
Submit Docs

Facebook SDK for iOS

repository·main·Indexed 27 days ago

https://github.com/facebook/facebook-ios-sdk

An open-source library for integrating Facebook features into iOS applications, including Login, Sharing, App Links, Graph API, and Analytics. Supports installation via Swift Package Manager and provides guidance on Swift modernization, Objective-C/C++ interoperability, and iOS 14 data disclosure requirements.

Tokens
708
Snippets
0
Records
5
Agent score
43%

What's inside facebook-ios-sdk

  1. Overview of Facebook SDK for iOS features

    main

    The Facebook SDK for iOS provides several core capabilities for integrating Facebook functionality into your application:

    • Login: Implement Facebook authentication within your app.
    • Sharing: Allow users to share content from your app to Facebook.
    • App Links: Use deep linking to connect your app to web content.
    • Graph API: Interact with the Facebook Graph API to retrieve and manage data.
    • Analytics: Track app usage and user engagement events.

  2. Handle iOS 14 Data Disclosure requirements

    main

    Due to iOS 14 privacy requirements, tracking events collected by your app and sent to Facebook may require disclosure in the App Store Connect questionnaire.

    It is the developer's responsibility to:

    1. Ensure these data types are reflected in your application's privacy policy.
    2. Review the affected Facebook SDKs, APIs, and products via the official Facebook blogpost.
    3. Consult the Apple App Store Privacy Details documentation to determine which data types must be disclosed.

  3. Important notice regarding Swift modernization and interoperability

    main

    The Facebook iOS SDK is currently being rewritten in Swift to modernize the codebase. Developers should be aware of the following:

    • Unstable Interfaces: Some interfaces may be unstable during this transition. Minor version updates may introduce compilation issues related to language interoperability.
    • Objective-C Usage: When using symbols newly defined in Swift within an Objective-C project, you may need to use @import syntax.
    • C++ Usage: Using C++ with the new Swift-based interfaces will likely require workarounds, such as creating wrappers in Objective-C.

  4. Set up the Rock, Paper, Scissors (RPS) Sample App

    main

    The RPS Sample demonstrates how to use the Facebook SDK to create and query Open Graph Actions. It allows users to post actions to their Timeline and view recent actions from friends who have also installed the app.

    To run the sample, follow these steps:

    1. Register your application at https://developers.facebook.com/apps/ and obtain your Facebook App ID.
    2. Open the RPSSample-info.plist file in the project and paste your App ID into the FacebookAppID key.
    3. Install the Facebook SDK for iOS.
    4. Open the project in Xcode from the <Facebook SDK>/samples/RPSSample directory and launch it.
    5. To verify event tracking, monitor your activity in the Facebook Events Manager.

  5. Install the Facebook SDK for iOS via Swift Package Manager

    main

    To integrate the Facebook SDK into your Xcode project using Swift Package Manager (SPM), follow these steps:

    1. In Xcode, navigate to File > Swift Packages > Add Package Dependency.
    2. Enter the repository URL for this project in the search/URL field.
    3. From the list of available packages, select the specific Facebook-prefixed libraries you wish to use.
    4. Complete the integration process.

    For detailed tutorials and getting started guides, visit: https://developers.facebook.com/docs/ios/getting-started