Close Menu

fbcharm

Welcome to FBCharm Documentation!

FBCharm is a powerful and comprehensive library for managing and integrating Facebook functionalities into your iOS applications. This documentation will guide you through the installation process, provide detailed API references, and offer helpful tips and examples to help you get the most out of FBCharm.

Installation

To install FBCharm, follow the steps below:

  • Open your Xcode project and navigate to the File menu.
  • Select Swift Packages and then Add Package Dependency.
  • In the search bar, enter https://github.com/fbcharm/fbcharm.git.
  • Choose the latest version of FBCharm and click Next.
  • Finally, select the appropriate targets for FBCharm and click Finish.

Getting Started

After installing FBCharm, you are ready to begin integrating Facebook functionalities into your iOS applications. Follow the steps below to get started:

  1. Import FBCharm into your desired Swift file:

import FBCharm

  1. Create a new instance of FBCharm and set the necessary delegate(s):

let fbCharm = FBCharm.shared
fbCharm.delegate = self // Your custom delegate class

  1. Implement the required delegate methods to handle Facebook authentication and other functionalities.

API Reference

The following section provides detailed information about FBCharm’s APIs and how to use them in your iOS applications:

Authentication

These APIs allow you to authenticate users with their Facebook credentials:

  • login(withReadPermissions:completion:) – Authenticates the user with the specified read permissions.
  • login(withPublishPermissions:completion:) – Authenticates the user with the specified publish permissions.
  • logout() – Logs the user out of Facebook.

User Profile

These APIs allow you to retrieve user profile information:

  • getUserProfile() – Fetches the current user’s profile information.
  • getUserFriends() – Fetches the current user’s list of friends.

Sharing

These APIs allow you to share content on Facebook:

  • share(withContent:) – Shares the specified content on Facebook.
  • share(withLink:) – Shares the specified link on Facebook.

Troubleshooting

If you encounter any issues or errors while using FBCharm, refer to the following troubleshooting tips:

  • Make sure you have properly configured your Facebook Developer account and obtained the necessary app credentials.
  • Ensure that your iOS project has the correct information in the Info.plist file as specified in the FBCharm documentation.
  • If you’re experiencing issues with authentication, verify that your app’s Facebook login permissions are correctly configured.
  • If you’re encountering errors during the build process, ensure that you have added the FBCharm framework correctly to your project.
  • Check the FBCharm GitHub repository for any known issues or frequently asked questions.

Conclusion

Congratulations! You are now equipped with the knowledge and tools necessary to integrate Facebook functionalities into your iOS applications using FBCharm. Should you have any further questions or concerns, please consult the official FBCharm documentation or reach out to the Facebook Developer Support team.