Update/plugman and latest sdks

## MERGE WITH CAUTION

**Although this is usable with plugman, some things still need to be addressed;**
**Should the JS API be the same as the JS SDK API (probably, but the JS API needs a refactor...) ?**

**Test projects have not been tested yet**

**A LOT** of changes here... A quick summary below;

## SDKs
Updated Android SDK and iOS framework. For Android this meant adding a library project which cannot be plugin-ised fully yet. However, added documentation for the last step (adding a library project) with screenshots. For iOS the new .framework means breaking changes as we now use the plugin.xml `<framework src="src/ios/frameworks/FacebookSDK.framework" custom="true" />` command that only works from 3.3.+

## Readme changes
Added sample JavaScript code as well as brief documentation of the APIs (could be better TBH).

## Java
Added the updated Java code from the branch FBiOS3.8Android3.5 which removes all the deprecated old code, which was nice. Thanks @stevengil ? Added some touch ups to reduce the amount of final vars and importantly **"user cancel" is now an error type callback** - because the API has failed to succeed at posting or failed to login, therefore it is appropriate that the developer handles this as an error.

## Objective-C
Same change for user cancel behaviour was made to iOS. 

## JS
Added a new `facebookConnectSDK.js` file which is plugman compatible