Facebook Login for Android - Quickstart

The Facebook SDK for Android enables people to sign into your app with Facebook Login. When people log into your app with Facebook they can grant permissions to your app so you can retrieve information or perform actions on Facebook on their behalf.

For an example project that illustrates how to integrate Facebook Login into an Android app, see the FBLoginSample on GitHub.

Follow the steps below to add Facebook Login to your app.

1. Login

Please log in to Facebook to create apps or register as a developer.

2. Download the Facebook App

Download the Facebook app by clicking the button below.

3. Integrate the Facebook SDK

The Facebook Login SDK for Android is a component of the Facebook SDK for Android. To use the Facebook Login SDK in your project, make it a dependency in Maven, or download it. Choose the method you prefer with the following button.

Using Maven

  1. In your project, open your_app > Gradle Scripts > build.gradle (Project) make sure the following repository is listed in the buildscript { repositories {}}:
    jcenter() 
    
  2. In your project, open your_app > Gradle Scripts > build.gradle (Module: app) and add the following implementation statement to the dependencies{} section to depend on the latest version of the Facebook Login SDK:
     implementation 'com.facebook.android:facebook-login:[4,5)'
    
  3. Build your project.

When you use the Facebook Login SDK, events in your app are automatically logged and collected for Facebook Analytics unless you disable automatic event logging. For details about what information is collected and how to disable automatic event logging, see Automatic App Event Logging.

Using the Facebook SDK

To download the SDK, click the following button.
Download Facebook SDK

When you use the Facebook Login SDK, events in your app are automatically logged and collected for Facebook Analytics unless you disable automatic event logging. For details about what information is collected and how to disable automatic event logging, see Automatic App Event Logging.

4. Edit Your Manifest

Create strings for your Facebook app ID and for those needed to enable Chrome Custom Tabs. Also, add FacebookActivity to your Android manifest.
  1. Open your /app/src/main/res/values/strings.xml file.
  2. Add the following:
    <string name="facebook_app_id">[APP_ID]</string>
    <string name="fb_login_protocol_scheme">fb[APP_ID]</string>
    
  3. Open the /app/manifest/AndroidManifest.xml file.
  4. Add a uses-permission element to the manifest:
              
    <uses-permission android:name="android.permission.INTERNET"/>
    
    
  5. Add the following meta-data element, an activity for Facebook, and an activity and intent filter for Chrome Custom Tabs inside your application element. Replace @string/app_name with the name of your Facebook App:
    <meta-data android:name="com.facebook.sdk.ApplicationId" 
            android:value="@string/facebook_app_id"/>
        
        <activity android:name="com.facebook.FacebookActivity"
            android:configChanges=
                    "keyboard|keyboardHidden|screenLayout|screenSize|orientation"
            android:label="@string/app_name" />
        <activity
            android:name="com.facebook.CustomTabActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="@string/fb_login_protocol_scheme" />
            </intent-filter>
        </activity>
    

5. Associate Your Package Name and Default Class with Your App

You need to login to complete this step.

6. Provide the Development and Release Key Hashes for Your App

You need to login to complete this step.

7. Enable Single Sign On for Your App

You need to login to complete this step.

8. Add the Facebook Login Button

The simplest way to add Facebook Login to your app is to add LoginButton from the SDK. The LoginButton is a UI element that wraps functionality available in the LoginManager. When someone clicks on the button, the login is initiated with the permissions set in the LoginManager. The button follows the login state, and displays the correct text based on someone's authentication state.
To add the Facebook Login button, first add it to your layout XML file:
<com.facebook.login.widget.LoginButton
    android:id="@+id/login_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="center_horizontal"
    android:layout_marginTop="30dp"
    android:layout_marginBottom="30dp" /> 

9. Register a Callback

Now create a callbackManager to handle login responses by calling CallbackManager.Factory.create.
callbackManager = CallbackManager.Factory.create();
If you are adding the button to a Fragment you must also update your activity to use your fragment. You can customize the properties of Login button and register a callback in your onCreate() or onCreateView() method. Properties you can customize includes LoginBehavior, DefaultAudience, ToolTipPopup.Style and permissions on the LoginButton. For example:
      
    loginButton = (LoginButton) findViewById(R.id.login_button);
    loginButton.setReadPermissions("email");
    // If using in a fragment
    loginButton.setFragment(this);    

    // Callback registration
    loginButton.registerCallback(callbackManager, new FacebookCallback<LoginResult>() {
        @Override
        public void onSuccess(LoginResult loginResult) {
            // App code
        }

        @Override
        public void onCancel() {
            // App code
        }

        @Override
        public void onError(FacebookException exception) {
            // App code
        }
    });
To respond to a login result, you need to register a callback with either LoginManager or LoginButton. If you register the callback with LoginButton, don't need to register the callback on Login manager.
You add the LoginManager callback to your activity or fragment's onCreate() method:
    callbackManager = CallbackManager.Factory.create();

    LoginManager.getInstance().registerCallback(callbackManager,
            new FacebookCallback<LoginResult>() {
                @Override
                public void onSuccess(LoginResult loginResult) {
                    // App code
                }

                @Override
                public void onCancel() {
                     // App code
                }

                @Override
                public void onError(FacebookException exception) {
                     // App code   
                }
    });
If login succeeds, the LoginResult parameter has the new AccessToken, and the most recently granted or declined permissions.
You don't need a registerCallback for login to succeed, you can choose to follow current access token changes with the AccessTokenTracker class described below.
Finally, in your onActivityResult method, call callbackManager.onActivityResult to pass the login results to the LoginManager via callbackManager.
      @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        callbackManager.onActivityResult(requestCode, resultCode, data);
        super.onActivityResult(requestCode, resultCode, data);
    }
Every activity and fragment that you integrate with the FacebookSDK Login or Share should forward onActivityResult to the callbackManager.

10. Check Login Status

Your app can only have one person at a time logged in, and LoginManager sets the current AccessToken and Profile for that person. The FacebookSDK saves this data in shared preferences and sets at the beginning of the session. You can see if a person is already logged in by checking AccessToken.getCurrentAccessToken() and Profile.getCurrentProfile().
You can load AccessToken.getCurrentAccessToken with the SDK from cache or from an app book mark when your app launches from a cold start. You should check its validity in your Activity's onCreate method:

boolean loggedIn = AccessToken.getCurrentAccessToken() == null;
Then you can later perform the actual login, such as in a custom button's OnClickListener:
      
LoginManager.getInstance().logInWithReadPermissions(this, Arrays.asList("public_profile"));

Next Steps

Congrats, you've added Facebook Login to your Android app! Be sure to check out our other documentation pages for more advanced guides.
Track the access token and profile of your users.
Manage what data your app has access to through Facebook Login.
Having problems integrating Facebook Login? Check out a list of common problems and how to resolve them.
Depending on the Facebook data you request from people using Facebook Login, you may need to submit your app for review prior to launch.