feat(#708): Sync Facebook SDK for iOS and Android

CHANGELOG.md

@@ -1,3 +1,14 @@
+<a name="3.0.0"></a>
+# [3.0.0](https://github.com/jeduan/cordova-plugin-facebook4/releases/tag/v3.0.0)
+
+## Features
+
+* **Android:** Update Facebook Android SDK reference to v4.36.0 (drop greedy v4.+ reference) ([#708](https://github.com/jeduan/cordova-plugin-facebook4/issues/708))
+
+### Dislaimer
+
+This release does not contains that much but we bumped up it to a major release because as of now, each release will always be published with a synchronized Facebook SDK version for iOS and for Android 
+
 <a name="2.5.0"></a>
 # [2.5.0](https://github.com/jeduan/cordova-plugin-facebook4/releases/tag/v2.5.0)
 

README.md

@@ -38,6 +38,20 @@ The Facebook plugin for [Apache Cordova](http://cordova.apache.org/) allows you
 
 - [Troubleshooting Guide | F.A.Q.](docs/TROUBLESHOOTING.md)
 
+## Facebook SDK
+
+This plugin use the SDKs provided by Facebook. More information about these in their documentation for [iOS](https://developers.facebook.com/docs/ios/) or [Android](https://developers.facebook.com/docs/android/)
+
+### Facebook SDK version
+
+As of v3.0.0, this plugin will always be released for iOS and for Android with a synchronized usage of the Facebook SDKs
+
+For example: v3.0.0 include the Facebook SDK iOS v4.36.0 and reference per default the Facebook SDK Android v4.36.0 too
+
+### Graph API version
+
+Please note that this plugin itself does not specify which Graph API version is used. The Graph API version is set by the Facebook SDK for iOS and Android (see [Facebook documentation about versioning](https://developers.facebook.com/docs/apps/versions/))
+
 ## API
 
 ### Login
@@ -188,12 +202,6 @@ For more information see:
 - Graph Explorer - [https://developers.facebook.com/tools/explorer](https://developers.facebook.com/tools/explorer)
 - Graph API - [https://developers.facebook.com/docs/graph-api/](https://developers.facebook.com/docs/graph-api/)
 
-### Note regarding the Graph API version
-
-Please note that this plugin itself does not specify which Graph API version is used. The Graph API version is set by the Facebook SDK for iOS and Android.
-
-If you are able to reverse engineer the Facebook SDKs in order to find which Graph API version is used by which SDK or if you find any clear information about that particular subject in the Facebook documentation, don't hesitate to ping any maintainers.
-
 # Events
 
 App events allow you to understand the makeup of users engaging with your app, measure the performance of your Facebook mobile app ads, and reach specific sets of your users with Facebook mobile app ads.

docs/android/README.md

@@ -40,9 +40,7 @@ In order to install correctly this plugin for `cordova-android` v7.x.y and above
 
 ### 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`, you would be able to specify a specific Facebook SDK version for ANDROID using the variable `FACEBOOK_ANDROID_SDK_VERSION`
-
-Important note: Use this option at **your own risk**
+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`
 
 ```sh
 $ 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"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-facebook4",
-  "version": "2.5.0",
+  "version": "3.0.0",
   "description": "Cordova Facebook SDK 4 Plugin",
   "cordova": {
     "id": "cordova-plugin-facebook4",

plugin.xml

@@ -2,7 +2,7 @@
 <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
         xmlns:android="http://schemas.android.com/apk/res/android"
         id="cordova-plugin-facebook4"
-        version="2.5.0">
+        version="3.0.0">
 
     <name>Facebook Connect</name>
 
@@ -19,7 +19,7 @@
 
     <preference name="APP_ID" />
     <preference name="APP_NAME" />
-    <preference name="FACEBOOK_ANDROID_SDK_VERSION" default="4.+"/>
+    <preference name="FACEBOOK_ANDROID_SDK_VERSION" default="4.36.0"/>
 
     <engines>
         <!-- Requires > 3.5.0 because of the custom Framework tag for iOS [CB-6698] -->