Used to integrate Android apps with Facebook Platform.
Switch branches/tags
v1.2.2 v1.2.1 v1.2 v1.1 v1.0 sdk-version-4.38.1 sdk-version-4.38.0 sdk-version-4.37.0 sdk-version-4.36.1 sdk-version-4.36.0 sdk-version-4.35.0 sdk-version-4.34.0 sdk-version-4.33.0 sdk-version-4.32.0 sdk-version-4.31.0 sdk-version-4.30.0 sdk-version-4.29.0 sdk-version-4.28.0 sdk-version-4.27.0 sdk-version-4.26.0 sdk-version-4.25.0 sdk-version-4.24.0 sdk-version-4.23.0 sdk-version-4.22.1 sdk-version-4.22.0 sdk-version-4.21.1 sdk-version-4.21.0 sdk-version-4.20.0 sdk-version-4.19.0 sdk-version-4.18.0 sdk-version-4.17.0 sdk-version-4.16.1 sdk-version-4.16.0 sdk-version-4.15.0 sdk-version-4.14.1 sdk-version-4.14.0 sdk-version-4.13.2 sdk-version-4.13.1 sdk-version-4.12.1 sdk-version-4.12.0 sdk-version-4.11.0 sdk-version-4.10.1 sdk-version-4.10.0 sdk-version-4.9.0 sdk-version-4.8.2 sdk-version-4.8.1 sdk-version-4.8.0 sdk-version-4.7.0 sdk-version-4.6.0 sdk-version-4.5.0 sdk-version-4.4.0 sdk-version-4.3.0 sdk-version-4.2.0 sdk-version-4.1.2 sdk-version-4.1.1 sdk-version-4.1.0 sdk-version-4.0.1 sdk-version-4.0.0 sdk-version-3.23.1 sdk-version-3.23.0 sdk-version-3.22.0 sdk-version-3.21.1 sdk-version-3.21.0 sdk-version-3.20.0 sdk-version-3.19.1 sdk-version-3.19 sdk-version-3.18.1 sdk-version-3.18 sdk-version-3.17.2 sdk-version-3.17.1 sdk-version-3.17.0 sdk-version-3.16 sdk-version-3.15.0 sdk-version-3.14.1 sdk-version-3.14 sdk-version-3.8.0 sdk-version-3.7 sdk-version-3.6.0 sdk-version-3.5.2 sdk-version-3.5 sdk-version-3.0.2 sdk-version-3.0.2.b sdk-version-3.0.1 sdk-version-3.0.1.b sdk-version-3.0 sdk-version-3.0.b
Nothing to show
Clone or download
Build Service and facebook-github-bot translation auto-update for i18n/androidsdk.config.json on master
fbshipit-source-id: 131a1a2117dce81e43800fb1a9603ff51c05e81f
Latest commit 146ead5 Nov 14, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
facebook-applinks Facebook Android SDK 4.35 Jul 26, 2018
facebook-common translation auto-update for i18n/androidsdk.config.json on master Nov 14, 2018
facebook-core Remove GK for purchase auto-logging Nov 13, 2018
facebook-login translation auto-update for i18n/androidsdk.config.json on master Nov 14, 2018
facebook-messenger Facebook Android SDK 4.33 May 1, 2018
facebook-places Facebook Android SDK 4.35 Jul 26, 2018
facebook-share Facebook Android SDK 4.36 Aug 29, 2018
facebook Fix the error when build in travis CI Nov 13, 2018
gradle/wrapper Facebook Android SDK 4.33 May 1, 2018
samples fbshipit-source-id: 9bdebfa72677128b2e72eea105e7b072e6bc948f Sep 20, 2018
scripts Facebook Android SDK 4.28 Nov 9, 2017
.gitignore Facebook Android SDK 4.24 Jun 26, 2017
.travis.yml Update .travis.yml (#540) Nov 13, 2018
CONTRIBUTING.mdown Misc cleanups getting ready to ship beta Sep 24, 2012
LICENSE.txt Facebook Android SDK 4.0 Mar 25, 2015
NOTICE.txt Facebook Android SDK 4.34 Jun 18, 2018
PULL_REQUEST_TEMPLATE Facebook Android SDK 4.14 Jul 13, 2016
README.mdown Facebook Android SDK 4.36 Aug 29, 2018
build.gradle Fix gradle build for androidsdk Oct 26, 2018
constants.gradle Update target API level of androidsdk to 26 as Google required Nov 8, 2018
gradle.properties Facebook Android SDK 4.30 Jan 25, 2018
gradlew Facebook Android SDK 4.14 Jul 13, 2016
gradlew.bat Facebook Android SDK 4.14 Jul 13, 2016
maven.gradle Facebook Android SDK 4.27 Sep 26, 2017
settings.gradle Fix the error when build in travis CI Nov 13, 2018

README.mdown

Facebook SDK for Android

Build Status Maven Central

This open-source library allows you to integrate Facebook into your Android app.

Learn more about about the provided samples, documentation, integrating the SDK into your app, accessing source code, and more at https://developers.facebook.com/docs/android

TRY IT OUT

  1. Check-out the tutorials available online at https://developers.facebook.com/docs/android/getting-started
  2. Start coding! Visit https://developers.facebook.com/docs/android/ for tutorials and reference documentation.

FEATURES

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 : 367.95 kb                            |
|                                                              |
+--------------------------------------------------------------+
+----------+ +----------+ +----------+ +----------+ +----------+
|          | |          | |          | |          | |          |
|          | |          | |          | |          | |          |
| Facebook | | Facebook | | Facebook | | Facebook | | Facebook |
| -Login : | | -Share : | | -Places :| |-Messenger: |-Applinks:|
|          | |          | |          | |          | |          |
| 276.94 kb| | 282.46 kb| | 53.76 kb | | 91.63 kb | | 65.96 kb |
+----------+ +----------+ |          | |          | |          |
+-----------------------+ |          | |          | |          |
|                       | |          | |          | |          |
| Facebook-Common : N/A | |          | |          | |          |
|                       | |          | |          | |          |
+-----------------------+ +----------+ +----------+ +----------+
+--------------------------------------------------------------+
|                                                              |
| Facebook-Core : 52.61 kb                                     |
|                                                              |
+--------------------------------------------------------------+

Example: Including the Facebook-Login module (which depends on Facebook-Common and Facebook-Core) would increase your app's size by an estimated 276.94 kb and including just Facebook-Core would only increase your size by 52.61 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)
    implementation 'com.facebook.android:facebook-core:4.33.0'

    // Facebook Login only
    implementation 'com.facebook.android:facebook-login:4.33.0'

    // Facebook Share only
    implementation 'com.facebook.android:facebook-share:4.33.0'

    // Facebook Places only
    implementation 'com.facebook.android:facebook-places:4.33.0'

    // Facebook Messenger only
    implementation 'com.facebook.android:facebook-messenger:4.33.0'

    // Facebook App Links only
    implementation 'com.facebook.android:facebook-applinks:4.33.0'

    // Facebook Android SDK (everything)
    implementation 'com.facebook.android:facebook-android-sdk:4.33.0'
}

You may also need to add the following to your project/build.gradle file.

buildscript {
    repositories {
        mavenCentral()
    }
}

GIVE FEEDBACK

Please report bugs or issues to https://developers.facebook.com/bugs/

You can also join the Facebook Developers Group on Facebook (https://www.facebook.com/groups/fbdevelopers/) or ask questions on Stack Overflow (http://facebook.stackoverflow.com)

CONTRIBUTING

We are able to accept contributions to the Facebook SDK for Android. To contribute please do the following.

  • Follow the instructions in the CONTRIBUTING.mdown.
  • Submit your pull request to the dev branch. This allows us to merge your change into our internal master and then push out the change in the next release.

LICENSE

Except as otherwise noted, the Facebook SDK for Android is licensed under the Facebook Platform License (https://github.com/facebook/facebook-android-sdk/blob/master/LICENSE.txt).

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

DEVELOPER TERMS

  • By enabling Facebook integrations, including through this SDK, you can share information with Facebook, including information about people’s use of your app. Facebook will use information received in accordance with our Data Use Policy (https://www.facebook.com/about/privacy/), including to provide you with insights about the effectiveness of your ads and the use of your app. These integrations also enable us and our partners to serve ads on and off Facebook.

  • You may limit your sharing of information with us by updating the Insights control in the developer tool (https://developers.facebook.com/apps/[app_id]/settings/advanced).

  • If you use a Facebook integration, including to share information with us, you agree and confirm that you have provided appropriate and sufficiently prominent notice to and obtained the appropriate consent from your users regarding such collection, use, and disclosure (including, at a minimum, through your privacy policy). You further agree that you will not share information with us about children under the age of 13.

  • You agree to comply with all applicable laws and regulations and also agree to our Terms (https://www.facebook.com/policies/), including our Platform Policies (https://developers.facebook.com/policy/) and Advertising Guidelines, as applicable (https://www.facebook.com/ad_guidelines.php).

By using the Facebook SDK for Android you agree to these terms.