Skip to content

Latest commit

 

History

History
45 lines (30 loc) · 2.26 KB

README.md

File metadata and controls

45 lines (30 loc) · 2.26 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!

As a convenience you can use the plugin function facebookConnectPlugin.getApplicationSignature() to get the hash key:

facebookConnectPlugin.getApplicationSignature(function(response) {
    console.log("App signature: " + response); // copy-paste the response to the Facebook App Settings
});

Example Apps

platforms/android and platforms/ios contain example projects and all the native code for the plugin for both Android and iOS platforms. They also include versions of the Android and iOS Facebook SDKs. These are used during automatic installation.

For Android sample app remember to configure the project with your FB app id in the res/values/facebookconnect.xml file. For example:

<resources>
	<string name="fb_app_id">123456789</string>
	<string name="fb_app_name">TEST</string>
</resources>

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 -d plugin add /path/to/cloned/phonegap-facebook-plugin --variable APP_ID="123456789" --variable APP_NAME="myApplication"

You can now use the plugin right away

Setup with Eclipse (Removed)

** You no longer need the additional Eclipse steps. A custom_rules.xml file was added for configuring ANT properly.