Skip to content

Latest commit

 

History

History
41 lines (25 loc) · 2.52 KB

README.md

File metadata and controls

41 lines (25 loc) · 2.52 KB
Raw

Facebook Requirements and Set-Up [Android]

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 Android, please note that you will need to generate a hash of your Android key(s) and submit those to the Developers page on Facebook to get it working. Furthermore, if you are generating this hash on Windows (specifically 64 bit versions), please use version 0.9.8e or 0.9.8d of OpenSSL for Windows and not 0.9.8k. Big ups to fernandomatos for pointing this out!

Install

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 android

# Remember to replace APP_ID and APP_NAME variables
$ cordova plugin add https://github.com/jeduan/cordova-plugin-facebook4 --save --variable APP_ID="123456789" --variable APP_NAME="myApplication"

You can now use the plugin right away

Older Cordova CLI

In order to be compatible with older Cordova CLI version than v7, the property FACEBOOK_ANDROID_SDK_VERSION has to be specified in the config.xml (because otherwise it won't pick the default value, see #650).

You could add the property manually or specify it when you install the plugin, see the cmd below in section "In case of conflict"

Of course if you could, you could update your Cordova CLI and avoid specifying explicitly this option

In case of conflict

If you would face version conflicts regarding the Facebook SDK with other plugins used in your project while installing cordova-plugin-facebook4 for your ANDROID platform, you would be able to specify a specific Facebook SDK version for ANDROID using the variable FACEBOOK_ANDROID_SDK_VERSION

$ cordova plugin add https://github.com/jeduan/cordova-plugin-facebook4 --save --variable APP_ID="123456789" --variable APP_NAME="myApplication" --variable FACEBOOK_ANDROID_SDK_VERSION="X.YY.Z"

where X.YY.Z could be for example 4.25.0. More information about the Facebook SDK for Android and list of their versions in the Facebook documentation