Facebook Android SDK 4.27

README.mdown

@@ -15,11 +15,87 @@ TRY IT OUT
 
 FEATURES
 --------
-* Login - https://developers.facebook.com/docs/facebook-login
-* Sharing - https://developers.facebook.com/docs/sharing
+* Login     - https://developers.facebook.com/docs/facebook-login
+* Sharing   - https://developers.facebook.com/docs/sharing
+* Places    - https://developers.facebook.com/docs/places
+* Messenger - https://developers.facebook.com/docs/messenger-expressions
 * App Links - https://developers.facebook.com/docs/applinks
-* Graph API - https://developers.facebook.com/docs/android/graph
 * Analytics - https://developers.facebook.com/docs/analytics
+* Graph API - https://developers.facebook.com/docs/android/graph
+
+STRUCTURE
+---------
+The SDK is separated into modules with the following structure. Each box represents a module with an 
+estimated size when included into an app (when included using proguard and supporting a single language). 
+
+    +--------------------------------------------------------------+
+    |                                                              |
+    |  Facebook-android-sdk : 335.39 kb                            |
+    |                                                              |
+    +--------------------------------------------------------------+
+    +----------+ +----------+ +----------+ +----------+ +----------+
+    |          | |          | |          | |          | |          |
+    |          | |          | |          | |          | |          |
+    | Facebook | | Facebook | | Facebook | | Facebook | | Facebook |
+    | -Login : | | -Share : | | -Places :| |-Messenger: |-Applinks:|
+    |          | |          | |          | |          | |          |
+    | 246.66 kb| | 247.92 kb| | 53.48 kb | | 91.96 kb | | 67.00 kb |
+    +----------+ +----------+ |          | |          | |          |
+    +-----------------------+ |          | |          | |          |
+    |                       | |          | |          | |          |
+    | Facebook-Common : N/A | |          | |          | |          |
+    |                       | |          | |          | |          |
+    +-----------------------+ +----------+ +----------+ +----------+
+    +--------------------------------------------------------------+
+    |                                                              |
+    | Facebook-Core : 52.46 kb                                     |
+    |                                                              |
+    +--------------------------------------------------------------+
+
+Example: Including the Facebook-Login module (which depends on Facebook-Common and Facebook-Core) would
+increase your app's size by an estimated 243.91 kb and including just Facebook-Core would only increase
+your size by 50.98 kb.
+
+USAGE
+-----
+Facebook SDKs are broken up into separate modules as shown above. To ensure the most optimized use of
+space only install the modules that you intend to use. To get started, see the Installation section below.
+
+INSTALLATION
+------------
+Facebook SDKs are published to Maven as independent modules. To utilize a feature listed above
+include the appropriate dependency (or dependencies) listed below in your `app/build.gradle` file. 
+
+    dependencies {
+        // Facebook Core only (Analytics)
+        compile 'com.facebook.android:facebook-core:4.27'
+
+        // Facebook Login only
+        compile 'com.facebook.android:facebook-login:4.27'
+
+        // Facebook Share only
+        compile 'com.facebook.android:facebook-share:4.27'
+
+        // Facebook Places only
+        compile 'com.facebook.android:facebook-places:4.27'
+
+        // Facbeook Messenger only
+        compile 'com.facebook.android:facebook-messenger:4.27'
+
+        // Facebook App Links only
+        compile 'com.facebook.android:facebook-applinks:4.27'
+
+        // Facebook Android SDK (everything)
+        compile 'com.facebook.android:facebook-android-sdk:4.27'
+    }
+
+You may also need to add the following to your project/build.gradle file.
+
+    buildscript {
+        repositories {
+            mavenCentral() 
+        }
+    }
 
 GIVE FEEDBACK
 -------------

facebook-applinks/.gitignore

@@ -0,0 +1 @@
+/build

facebook-applinks/build.gradle

@@ -0,0 +1,33 @@
+apply plugin: 'com.android.library'
+
+project.group 'com.facebook.android'
+
+project.ext.name = 'Facebook-Applinks-Android-SDK'
+project.ext.artifactId = "facebook-applinks"
+project.ext.description = 'Facebook Applinks Android SDK'
+project.ext.url = 'https://github.com/facebook/facebook-android-sdk/facebook-applinks'
+
+dependencies {
+    // Facebook Dependencies
+    compile project(':facebook-core')
+}
+
+android {
+    compileSdkVersion Integer.parseInt(project.ANDROID_BUILD_SDK_VERSION)
+    buildToolsVersion project.ANDROID_BUILD_TOOLS_VERSION
+
+    defaultConfig {
+        minSdkVersion Integer.parseInt(project.ANDROID_BUILD_MIN_SDK_VERSION)
+        targetSdkVersion Integer.parseInt(project.ANDROID_BUILD_TARGET_SDK_VERSION)
+        consumerProguardFiles 'proguard-rules.pro'
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+apply from: "${rootDir}/maven.gradle"

facebook-applinks/proguard-rules.pro

@@ -0,0 +1,33 @@
+# To enable ProGuard in your project, edit project.properties
+# to define the proguard.config property as described in that file.
+#
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in ${sdk.dir}/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the ProGuard
+# include property in project.properties.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+-keepclassmembers class * implements java.io.Serializable {
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+-keepnames class com.facebook.FacebookActivity
+-keepnames class com.facebook.CustomTabActivity
+
+-keep class com.facebook.applinks.AppLinks

facebook/src/main/res/values-cs/messenger_button_strings.xml → facebook-applinks/src/main/AndroidManifest.xml

@@ -19,6 +19,11 @@
     CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 -->
 
-<resources>
-  <string name="messenger_send_button_text">Odeslat</string>
-</resources>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.facebook.applinks">
+
+    <application android:supportsRtl="true">
+
+    </application>
+
+</manifest>

facebook-applinks/src/main/java/com/facebook/applinks/AppLinks.java

@@ -0,0 +1,5 @@
+// Copyright 2004-present Facebook. All Rights Reserved.
+
+package com.facebook.applinks;
+
+public class AppLinks { }

facebook-common/.gitignore

@@ -0,0 +1 @@
+/build

facebook-common/build.gradle

@@ -0,0 +1,54 @@
+apply plugin: 'com.android.library'
+
+project.group 'com.facebook.android'
+
+project.ext.name = 'Facebook-Common-Android-SDK'
+project.ext.artifactId = "facebook-common"
+project.ext.description = 'Facebook Common Android SDK'
+project.ext.url = 'https://github.com/facebook/facebook-android-sdk/facebook-common'
+
+dependencies {
+    // Facebook Dependencies
+    compile project(':facebook-core')
+    // Support Dependencies
+    compile 'com.android.support:appcompat-v7:25.3.1'
+    compile 'com.android.support:cardview-v7:25.3.1'
+    compile 'com.android.support:customtabs:25.3.1'
+    compile 'com.android.support:support-v4:25.3.1'
+    // Third-party Dependencies
+    compile 'com.google.zxing:core:3.3.0'
+}
+
+android {
+    compileSdkVersion Integer.parseInt(project.ANDROID_BUILD_SDK_VERSION)
+    buildToolsVersion project.ANDROID_BUILD_TOOLS_VERSION
+
+    defaultConfig {
+        minSdkVersion Integer.parseInt(project.ANDROID_BUILD_MIN_SDK_VERSION)
+        targetSdkVersion Integer.parseInt(project.ANDROID_BUILD_TARGET_SDK_VERSION)
+        consumerProguardFiles 'proguard-rules.pro'
+        vectorDrawables.useSupportLibrary = true
+    }
+
+    aaptOptions {
+        additionalParameters "--no-version-vectors"
+    }
+
+    lintOptions {
+        abortOnError false
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+apply from: "${rootDir}/maven.gradle"

facebook-common/proguard-rules.pro

@@ -0,0 +1,33 @@
+# To enable ProGuard in your project, edit project.properties
+# to define the proguard.config property as described in that file.
+#
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in ${sdk.dir}/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the ProGuard
+# include property in project.properties.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+-keepclassmembers class * implements java.io.Serializable {
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+-keepnames class com.facebook.FacebookActivity
+-keepnames class com.facebook.CustomTabActivity
+
+-keep class com.facebook.common.Common

facebook/src/main/res/values-pa/messenger_button_strings.xml → facebook-common/src/main/AndroidManifest.xml

@@ -19,6 +19,18 @@
     CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 -->
 
-<resources>
-  <string name="messenger_send_button_text">ਭੇਜੋ</string>
-</resources>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.facebook.common">
+
+    <application android:supportsRtl="true">
+
+        <activity
+            android:name="com.facebook.FacebookActivity"
+            android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
+            android:theme="@style/com_facebook_activity_theme" />
+
+        <activity android:name="com.facebook.CustomTabMainActivity" />
+
+    </application>
+
+</manifest>

facebook/src/main/java/com/facebook/AccessTokenTracker.java → facebook-common/src/main/java/com/facebook/AccessTokenTracker.java

@@ -26,6 +26,9 @@
 import android.content.IntentFilter;
 import android.support.v4.content.LocalBroadcastManager;
 
+import com.facebook.AccessToken;
+import com.facebook.AccessTokenManager;
+import com.facebook.FacebookSdk;
 import com.facebook.internal.Validate;
 
 

facebook/src/main/java/com/facebook/CustomTabMainActivity.java → facebook-common/src/main/java/com/facebook/CustomTabMainActivity.java

@@ -29,6 +29,7 @@
 import android.os.Bundle;
 import android.support.v4.content.LocalBroadcastManager;
 
+import com.facebook.FacebookSdk;
 import com.facebook.internal.CustomTab;
 
 public class CustomTabMainActivity extends Activity {

facebook/src/main/java/com/facebook/FacebookActivity.java → facebook-common/src/main/java/com/facebook/FacebookActivity.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
  *
  * You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
@@ -28,6 +28,7 @@
 import android.support.v4.app.FragmentManager;
 import android.util.Log;
 
+import com.facebook.common.R;
 import com.facebook.internal.FacebookDialogFragment;
 import com.facebook.internal.NativeProtocol;
 import com.facebook.login.LoginFragment;

facebook/src/main/java/com/facebook/FacebookAuthorizationException.java → facebook-common/src/main/java/com/facebook/FacebookAuthorizationException.java

@@ -20,6 +20,8 @@
 
 package com.facebook;
 
+import com.facebook.FacebookException;
+
 /**
  * An Exception indicating that Login failed.
  */

facebook/src/main/java/com/facebook/FacebookButtonBase.java → facebook-common/src/main/java/com/facebook/FacebookButtonBase.java

@@ -35,8 +35,10 @@
 import android.view.View;
 import android.widget.Button;
 
+import com.facebook.FacebookException;
 import com.facebook.appevents.AppEventsLogger;
 import com.facebook.internal.FragmentWrapper;
+import com.facebook.common.R;
 
 /**
  * A base class for a facebook button.

facebook/src/main/java/com/facebook/FacebookCallback.java → facebook-common/src/main/java/com/facebook/FacebookCallback.java

@@ -20,6 +20,8 @@
 
 package com.facebook;
 
+import com.facebook.FacebookException;
+
 /**
  * A callback class for the Facebook SDK.
  */

facebook/src/main/java/com/facebook/FacebookDialog.java → facebook-common/src/main/java/com/facebook/FacebookDialog.java

@@ -1,4 +1,4 @@
-/**
+/*
  * Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
  *
  * You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
@@ -20,6 +20,8 @@
 
 package com.facebook;
 
+import com.facebook.CallbackManager;
+
 /**
  * Represents dialogs provided by Facebook
  */

facebook/src/main/java/com/facebook/FacebookDialogException.java → facebook-common/src/main/java/com/facebook/FacebookDialogException.java

@@ -20,6 +20,8 @@
 
 package com.facebook;
 
+import com.facebook.FacebookException;
+
 /**
  * Represents an error condition relating to displaying a Facebook Web dialog.
  */

facebook/src/main/java/com/facebook/LoginStatusCallback.java → facebook-common/src/main/java/com/facebook/LoginStatusCallback.java

@@ -20,6 +20,8 @@
 
 package com.facebook;
 
+import com.facebook.AccessToken;
+
 /**
  * A callback class for getting the Login Status of a user.
  */