Repository files navigation

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

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

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

• Login
• Sharing
• Places
• Messenger
• App Links
• Analytics
• Graph API
• Marketing

The SDK is separated into modules with the following structure. Each box represents a module with anestimated size when included into an app (when included using proguard and supporting a single language).

+---------------------------------------------------------------+|                                                               ||  Facebook-android-sdk : 399.09 kb                             ||                                                               |+---------------------------------------------------------------++----------+ +----------+ +----------+ +-----------+ +----------+|          | |          | |          | |           | |          ||          | |          | |          | |           | |          || Facebook | | Facebook | | Facebook | | Facebook  | | Facebook || -Login : | | -Share : | | -Places :| |-Messenger:| |-Applinks:||          | |          | |          | |           | |          || 304.06 kb| | 310.94 kb| | 76.48 kb | | 114.26 kb | | 89.73 kb |+----------+ +----------+ |          | |           | |          |+-----------------------+ |          | |           | |          ||                       | |          | |           | |          || Facebook-Common : N/A | |          | |           | |          ||                       | |          | |           | |          |+-----------------------+ +----------+ +-----------+ +----------++---------------------------------------------------------------+|                                                               || Facebook-Core : 75.12 kb                                      ||                                                               |+---------------------------------------------------------------+

Example: Including the Facebook-Login module (which depends on Facebook-Common and Facebook-Core) wouldincrease your app's size by an estimated 276.94 kb and including just Facebook-Core would only increaseyour size by 52.61 kb.

Facebook SDKs are broken up into separate modules as shown above. To ensure the most optimized use ofspace only install the modules that you intend to use. To get started, see the Installation section below.

Facebook SDKs are published to Maven as independent modules. To utilize a feature listed aboveinclude the appropriate dependency (or dependencies) listed below in yourapp/build.gradle file.

dependencies {// Facebook Core only (Analytics)    implementation'com.facebook.android:facebook-core:5.0.0'// Facebook Login only    implementation'com.facebook.android:facebook-login:5.0.0'// Facebook Share only    implementation'com.facebook.android:facebook-share:5.0.0'// Facebook Places only    implementation'com.facebook.android:facebook-places:5.0.0'// Facebook Messenger only    implementation'com.facebook.android:facebook-messenger:5.0.0'// Facebook App Links only    implementation'com.facebook.android:facebook-applinks:5.0.0'// Facebook Android SDK (everything)    implementation'com.facebook.android:facebook-android-sdk:5.0.0'}

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

buildscript {    repositories {        mavenCentral()    }}

Please report bugs or issues tohttps://developers.facebook.com/bugs/

You can also visit ourFacebook Developer Community Forum,join theFacebook Developers Group on Facebook,ask questions onStack Overflow,or open an issue in this repository.

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

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

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.

• 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.