To use this plugin you will need to make sure you've registered your Facebook app with Facebook and have an APP_ID
https://developers.facebook.com/apps.
If you plan on rolling this out on iOS, please note that you will need to ensure that you have properly set up your Native iOS App settings on the Facebook App Dashboard. Please see the Getting Started with the Facebook SDK: Create a Facebook App section, for more details on this.
This plugin requires Cordova CLI.
To install the plugin in your app, execute the following (replace variables where necessary):
# Create initial Cordova app
$ cordova create myApp
$ cd myApp/
$ cordova platform add ios
# Remember to replace APP_ID and APP_NAME variables
$ cordova plugin add cordova-plugin-facebook-connect --save --variable APP_ID="123456789" --variable APP_NAME="myApplication"
This plugin use the CocoaPods dependency manager in order to satisfy the iOS Facebook SDK library dependencies.
Therefore please make sure you have Cocoapods installed in your iOS build environment - setup instructions can be found here. Also make sure your local Cocoapods repo is up-to-date by running pod repo update
.
If building your project in Xcode, you need to open YourProject.xcworkspace
(not YourProject.xcodeproj
) so both your Cordova app project and the Pods project will be loaded into Xcode.
You can list the pod dependencies in your Cordova iOS project by installing cocoapods-dependencies:
sudo gem install cocoapods-dependencies
cd platforms/ios/
pod dependencies
If you install the plugin and face the error Failed to install 'cordova-plugin-facebook-connect': Error: pod: Command failed with exit code 31
, it probably means that your local Pod repo is not up-to-date. In order to solve the problem, prior the installation, run the following command in your platform to update your Pod repo:
pod update
If you are using Cordova iOS < v5, you might face the error 'FBSDKCoreKit/FBSDKCoreKit.h' file not found
. To overcome this problem, edit the plugin.xml
of the plugin in order to fetch de Facebook iOS SDK by adding the following framework
references:
<framework src="FBSDKCoreKit" type="podspec" spec="X.Y.Z" />
<framework src="FBSDKLoginKit" type="podspec" spec="X.Y.Z" />
<framework src="FBSDKShareKit" type="podspec" spec="X.Y.Z" />
Replace X.Y.Z
with the Facebook iOS SDK and remove and add your platform again.