Merge pull request #807 from Wizcorp/develop

Update Master

README.md

@@ -6,8 +6,8 @@ The Facebook plugin for [Apache Cordova](http://incubator.apache.org/cordova/) a
 
 * Supported on PhoneGap (Cordova) v3.3.0 and above.
 * This plugin is built for
-	* iOS FacebookSDK 3.16.1
-	* Android FacebookSDK 3.16.0
+	* iOS FacebookSDK 3.20.0
+	* Android FacebookSDK 3.20.0
 * GitHub URL : [https://github.com/Wizcorp/phonegap-facebook-plugin/](https://github.com/Wizcorp/phonegap-facebook-plugin/)
 
 ## << --- Cordova Registry Warning [iOS]
@@ -30,7 +30,10 @@ To use this plugin you will need to make sure you've registered your Facebook ap
 
 - [Web App Guide](platforms/web/README.md)
 
-- [PhoneGap Build](platforms/pg-build/README.md)
+- [PhoneGap Build Guide](platforms/pg-build/README.md)
+
+- [Troubleshooting Guide | F.A.Q.](TROUBLESHOOTING.md)
+
 
 #### Example Apps
 

TROUBLESHOOTING.md

@@ -0,0 +1,145 @@
+# Troubleshooting
+
+If you cannot solve your issue here please check the **existing issues** on Github, if you still cannot find a solution please [create an issue](https://github.com/Wizcorp/phonegap-facebook-plugin/issues). 
+
+When creating a Github issue **remember to**:
+
+- List your platform!
+- Provide sample code
+- Provide a log (Xcode console or adb logcat)
+
+### Troubleshooting contents
+- [**General**](#general) 
+	- [How do I Build without Eclipse?](#how-do-i-build-without-eclipse) 
+	- [How do I Add a Like Button?](#how-do-i-add-a-like-button)
+	- [Where is the init API?](#where-is-the-init-api)
+	- [How to install with NPM PhoneGap?](#how-to-install-with-npm-phonegap)
+
+- [**Android**](#android)
+	- [No Reply From Login?](#no-reply-from-login) 
+	- [My Hash Does Not Work, I am Using Windows](#my-hash-does-not-work-i-am-using-windows)
+	- [Jar mismatch! Fix your dependencies](#jar-mismatch-fix-your-dependencies)
+
+- [**iOS**](#ios)
+	- [Missing FacebookConnectPlugin](#missing-facebookconnectplugin)
+
+
+## General
+### How do I Build without Eclipse?
+
+- Solution
+    - Check the [Android Guide](https://github.com/Wizcorp/phonegap-facebook-plugin/blob/master/platforms/android/README.md)
+
+### How do I Add a Like Button?
+
+- Problem
+    - I am trying to implement like button functionality in my app. Whenever user likes my facebook page, user will get rewards. So i have tried to implement this like button functionality as described here:
+[https://developers.facebook.com/docs/plugins/like-button](https://developers.facebook.com/docs/plugins/like-button)
+
+- Solution
+    - It won't work for native apps because: [https://developers.facebook.com/docs/ios/like-button/](https://developers.facebook.com/docs/ios/like-button/) is not supported yet. **HOWEVER**; it can be done with the graph API [http://stackoverflow.com/questions/11915269/built-in-like-button-facebook-sdk-3-0](http://stackoverflow.com/questions/11915269/built-in-like-button-facebook-sdk-3-0)
+    Things you have to take care of are :
+
+    1. Your like button must not be the same (graphically) as the Facebook like button
+
+    2. When you display your page / button you have to call the getLoginStatus method first to know if the current user is connected to its Facebook account. If he is connected then call `GET` [https://graph.facebook.com/me/og.likes?access_token=FB_ACCESS_TOKEN&object=URL_TO_LIKE](https://graph.facebook.com/me/og.likes?access_token=FB_ACCESS_TOKEN&object=URL_TO_LIKE) with the Facebook Access Token returned by the g3. etAccessToken method (if this returns data then style your like button with a red heart for example, a grey heart if the call returns an empty array).
+
+    3. To create a like (when your user clicks on your like button and your like button is a grey heart) do a POST on [https://graph.facebook.com/me/og.likes?access_token=FB_ACCESS_TOKEN&object=URL_TO_LIKE](https://graph.facebook.com/me/og.likes?access_token=FB_ACCESS_TOKEN&object=URL_TO_LIKE)
+
+    4. To remove a like (when your user clicks on your like button and your like button is a red heart) do a `DELETE` on [https://graph.facebook.com/LIKE_IDENTIFIER?access_token=FB_ACCESS_TOKEN](https://graph.facebook.com/LIKE_IDENTIFIER?access_token=FB_ACCESS_TOKEN). The `LIKE_IDENTIFIER` is returned from steps 2 or 3.
+
+The better way to understand this little "workflow" is to manipulate the Graph API on the og.likes endpoint using the [Facebook Graph Explorer](https://developers.facebook.com/tools/explorer) tool.
+
+### Where is the init API?
+
+- Problem
+    - I was using `FB.init()` and now it's not working.
+
+- Solution
+    - You are using an out-dated API. Please check the [new API with sample code](https://github.com/Wizcorp/phonegap-facebook-plugin/blob/master/README.md) and sample projects in `platforms/ios` and `platforms/android`.
+
+### How to install with NPM PhoneGap?
+
+- Problem
+    - I'm trying to install via https the Facebook plugin in iOS, but when I try the following line:
+
+`sudo phonegap local plugin add https://github.com/phonegap/phonegap-facebook-plugin.git --variable APP_ID="12345678910" --variable APP_NAME="MyAPP"`
+
+Im getting the message "[error] Variable(s) missing: APP_ID, APP_NAME"
+
+- Solution
+    - The `PhoneGap` CLI and `Cordova` CLI differ slightly you will need to run:
+
+`git clone https://github.com/Wizcorp/phonegap-facebook-plugin`
+
+`cd to/your/project`
+
+`phonegap local plugin add /path/to/here/phonegap-facebook-plugin --variable APP_ID="12345678910" --variable APP_NAME="AwesomeApp"`
+
+## Android
+### No Reply From Login?
+
+- Problem
+    - **facebookConnectPlugin.login doesn't call neither success nor faillure methods.** - When I'm disconnected from Facebook and don't have the native app, the iframe fallback is blank. Checking on chrome inspector, the elements are set to display: none.
+
+- Solution
+    - Copy and paste the following code to print your hash. Add the hash to your Facebook Developer Dashboard.
+
+```
+try {
+  PackageInfo info = 
+  cordova.getActivity().getPackageManager().getPackageInfo("com.goapes.golearn", PackageManager.GET_SIGNATURES);
+  
+  for (Signature signature : info.signatures) {
+      MessageDigest md = MessageDigest.getInstance("SHA");
+      md.update(signature.toByteArray());
+      Log.e("MY KEY HASH:", Base64.encodeToString(md.digest(), Base64.DEFAULT));
+  }
+
+} catch (NameNotFoundException e) {
+
+} catch (NoSuchAlgorithmException e) {
+
+}
+```
+
+### My Hash Does Not Work, I am Using Windows
+
+- Problem
+    - Windows users have to be careful about openssl-for-windows [http://code.google.com/p/openssl-for-windows/downloads/list](http://code.google.com/p/openssl-for-windows/downloads/list), the latest version, at least on plataform 64bit, does not generate the correct hash that Facebook needs for android apps.
+
+- Solution
+    - Use one of these versions when creating your hash: **openssl-0.9.8e_X64.zip** or **openssl-0.9.8d_X64.rar**
+
+You should **not** use the openssl-0.9.8k_X64.zip.
+
+### Jar mismatch! Fix your dependencies
+
+- Problem
+    - I get this error:
+
+```
+BUILD FAILED
+/usr/local/opt/android-sdk/tools/ant/build.xml:577: Jar mismatch! Fix your dependencies
+```
+
+- Solution
+    - You may have duplicate android-support-v4.jar files. Remove android-support-v4.jar from the `/libs` folder of your project.
+
+## iOS
+### Missing FacebookConnectPlugin
+- Problem:
+	- `CDVPlugin class FacebookConnectPlugin (pluginName: facebookconnectplugin) does not exist.`
+- Solution:
+	1. Open up Xcode
+	2. Go to "Build Phases"
+	3. Ensure that the following file is added under "Compile Sources":
+		- `FacebookConnectPlugin.m`
+	4. Ensure that the following is added under "Link Binary With Libraris":
+		- `FacebookSDK.framework` 
+		- `libsqlite3.dylib`
+		- `Social.framework`
+		- `Accounts.framework`
+		- `Security.framework`
+
+Cordova and plugman seems to have some problems adding frameworks etc. when re-installing/upgrading plugins.

platforms/android/FacebookLib/build.gradle

@@ -1,4 +1,10 @@
-apply plugin: 'android-library'
+apply plugin: 'com.android.library'
+
+repositories {
+  mavenCentral()
+}
+
+project.group = 'com.facebook.android'
 
 dependencies {
     compile 'com.android.support:support-v4:20.0.+'
@@ -26,3 +32,100 @@ android {
         }
     }
 }
+
+apply plugin: 'maven'
+apply plugin: 'signing'
+
+def isSnapshot = version.endsWith('-SNAPSHOT')
+def ossrhUsername = hasProperty('NEXUS_USERNAME') ? NEXUS_USERNAME : ""
+def ossrhPassword = hasProperty('NEXUS_PASSWORD') ? NEXUS_PASSWORD : ""
+
+task setVersion {
+    // The version will be derived from source
+    project.version = null
+    def sdkVersionFile = file('src/com/facebook/FacebookSdkVersion.java')
+    sdkVersionFile.eachLine{
+        def matcher = (it =~ /(?:.*BUILD = \")(.*)(?:\".*)/)
+        if (matcher.matches()) {
+          project.version = matcher[0][1]
+          return
+        }
+    }
+    if (project.version.is('unspecified')) {
+      throw new GradleScriptException('Version could not be found.', null)
+    }
+}
+
+uploadArchives {
+    repositories.mavenDeployer {
+        beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }
+
+        repository(url: "https://oss.sonatype.org/service/local/staging/deploy/maven2/") {
+            authentication(userName: ossrhUsername, password: ossrhPassword)
+        }
+
+        snapshotRepository(url: "https://oss.sonatype.org/content/repositories/snapshots/") {
+            authentication(userName: ossrhUsername, password: ossrhPassword)
+        }
+
+        pom.project {
+            name 'Facebook-Android-SDK'
+            artifactId = 'facebook-android-sdk'
+            packaging 'aar'
+            description 'Facebook Android SDK'
+            url 'https://github.com/facebook/facebook-android-sdk'
+
+            scm {
+                connection 'scm:git@github.com:facebook/facebook-android-sdk.git'
+                developerConnection 'scm:git@github.com:facebook/facebook-android-sdk.git'
+                url 'https://github.com/facebook/facebook-android-sdk'
+            }
+
+            licenses {
+                license {
+                    name 'The Apache Software License, Version 2.0'
+                    url 'https://github.com/facebook/facebook-android-sdk/blob/master/LICENSE.txt'
+                    distribution 'repo'
+                }
+            }
+
+            developers {
+                developer {
+                    id 'facebook'
+                    name 'Facebook'
+                }
+            }
+        }
+    }
+}
+
+uploadArchives.dependsOn(setVersion)
+
+signing {
+    required { !isSnapshot && gradle.taskGraph.hasTask("uploadArchives") }
+    sign configurations.archives
+}
+
+task androidJavadocs(type: Javadoc) {
+    source = android.sourceSets.main.java.srcDirs
+    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
+}
+
+task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {
+    classifier = 'javadoc'
+    from androidJavadocs.destinationDir
+}
+
+task androidSourcesJar(type: Jar) {
+    classifier = 'sources'
+    from android.sourceSets.main.java.sourceFiles
+}
+
+artifacts {
+    archives androidSourcesJar
+    archives androidJavadocsJar
+}
+
+afterEvaluate {
+    androidJavadocs.classpath += project.android.libraryVariants.toList().first().javaCompile.classpath
+}

platforms/android/FacebookLib/custom_rules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project>
+    <target name="-post-compile">
+        <copy todir="bin">
+            <fileset dir="ant-build"/>
+        </copy>
+    </target>
+</project>

platforms/android/FacebookLib/res/drawable/com_facebook_button_like.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <item
+        android:drawable="@drawable/com_facebook_button_like_pressed"
+        android:state_focused="true"
+        android:state_pressed="true"
+        />
+    <item
+        android:drawable="@drawable/com_facebook_button_like_pressed"
+        android:state_focused="false"
+        android:state_pressed="true"
+        />
+    <item
+        android:drawable="@drawable/com_facebook_button_like_background"
+        android:state_focused="true"
+        android:state_pressed="false"
+        />
+    <item
+        android:drawable="@drawable/com_facebook_button_like_background"
+        android:state_focused="false"
+        android:state_pressed="false"
+        />
+
+</selector>

platforms/android/FacebookLib/res/drawable/com_facebook_button_like_selected.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <item
+            android:drawable="@drawable/com_facebook_button_like_pressed"
+            android:state_focused="true"
+            android:state_pressed="true"
+            />
+    <item
+            android:drawable="@drawable/com_facebook_button_like_pressed"
+            android:state_focused="false"
+            android:state_pressed="true"
+            />
+    <item
+            android:drawable="@drawable/com_facebook_button_like_background_selected"
+            android:state_focused="true"
+            android:state_pressed="false"
+            />
+    <item
+            android:drawable="@drawable/com_facebook_button_like_background_selected"
+            android:state_focused="false"
+            android:state_pressed="false"
+            />
+
+
+</selector>

platforms/android/FacebookLib/res/layout/com_facebook_friendpickerfragment.xml

@@ -16,16 +16,16 @@
 -->
 
 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              android:layout_width="fill_parent"
-              android:layout_height="fill_parent"
+              android:layout_width="match_parent"
+              android:layout_height="match_parent"
               android:background="#FFFFFF">
 
     <include layout="@layout/com_facebook_picker_title_bar_stub"/>
 
     <ListView
             android:id="@+id/com_facebook_picker_list_view"
-            android:layout_width="fill_parent"
-            android:layout_height="fill_parent"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
             android:divider="@drawable/com_facebook_list_divider"
             android:fastScrollEnabled="true"
             android:scrollbars="vertical"

platforms/android/FacebookLib/res/layout/com_facebook_login_activity_layout.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 
 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
-              android:layout_width="fill_parent"
-              android:layout_height="fill_parent">
+              android:layout_width="match_parent"
+              android:layout_height="match_parent">
 
     <ProgressBar android:indeterminate="true"
                  android:layout_width="wrap_content"

platforms/android/FacebookLib/res/layout/com_facebook_picker_activity_circle_row.xml

@@ -18,7 +18,7 @@
 <RelativeLayout
         xmlns:android="http://schemas.android.com/apk/res/android"
         android:layout_height="50dip"
-        android:layout_width="fill_parent"
+        android:layout_width="match_parent"
         >
     <ProgressBar android:indeterminate="true"
                  android:layout_width="wrap_content"

platforms/android/FacebookLib/res/layout/com_facebook_picker_list_row.xml

@@ -18,7 +18,7 @@
 <LinearLayout
         xmlns:android="http://schemas.android.com/apk/res/android"
         android:layout_height="wrap_content"
-        android:layout_width="fill_parent"
+        android:layout_width="match_parent"
         >
     <ViewStub
             android:id="@+id/com_facebook_picker_profile_pic_stub"