Getting Started with the Facebook SDK for Android

• By using the Quick Start.
• By setting up your project with the Facebook SDK for Android.

• Your Meta App ID
• Your Meta App Client Token

1. Go to Android Studio | New Project | Minimum SDK.
2. Select API 15: Android 4.0.3 (IceCreamSandwich) or higher and create your new project.
3. Open the file Gradle Scripts \| build.gradle (Project: <your_project>) and add the following:

   mavenCentral()
   
4. Save and close the build.gradle (Project: <your_project>) file.
5. Open the file Gradle Scripts \| build.gradle (Module: app) and add the following to the dependencies section:

   implementation 'com.facebook.android:facebook-android-sdk:latest.release'
   
6. Save and close the build.gradle (Module: app) file.
7. Build your project. Now you can import com.facebook.FacebookSdk into your app.

1. Open the /app/res/values/strings.xml file in your app project.
2. Add string elements with the names facebook_app_id and facebook_client_token, and set the values to your App ID and Client Token. For example, if your app ID is 1234 and your client token is 56789 your code looks like the following:

   <string name="facebook_app_id">1234</string>
   <string name="facebook_client_token">56789</string>
   
3. Open the /app/manifests/AndroidManifest.xml file in your app project.
4. Add meta-data elements to the application element for your app ID and client token:

   <application android:label="@string/app_name" ...>
        ...
        <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
        <meta-data android:name="com.facebook.sdk.ClientToken" android:value="@string/facebook_client_token"/>
        ...
   </application>
   
5. Add a uses-permission element to the manifest after the application element:

   <uses-permission android:name="android.permission.INTERNET"/>
   
6. (Optional) To opt out of the Advertising ID Permission, add a uses-permission element to the manifest after the application element:

   <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
   
7. Build your project.

1. Open the /app/manifests/AndroidManifest.xml file in your app project.
2. Add a provider element to the manifest for the FacebookContentProvider authority. Append your app ID to the end of the authorities value. For example, if your app id is 1234, the declaration looks like the following:

   <provider android:authorities="com.facebook.app.FacebookContentProvider1234"
        android:name="com.facebook.FacebookContentProvider"
        android:exported="true" />
   
3. Build your project.

• HelloFacebookSample⁠ — Demonstrates profile access, status updates and photo upload.

keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore | openssl sha1 -binary | openssl base64

• Key and Certificate Management Tool (keytool) from the Java Development Kit
• OpenSSL for Windows Library⁠ from the Google Code Archive⁠

keytool -exportcert -alias androiddebugkey -keystore %HOMEPATH%\.android\debug.keystore | openssl sha1 -binary | openssl
base64

keytool -exportcert -alias <RELEASE_KEY_ALIAS> -keystore <RELEASE_KEY_PATH> | openssl sha1 -binary | openssl base64

• Key and Certificate Management Tool (keytool) from the Java Development Kit
• OpenSSL for Windows Library⁠ from the Google Code Archive⁠

keytool -exportcert -alias <RELEASE_KEY_ALIAS> -keystore <RELEASE_KEY_PATH> | PATH_TO_OPENSSL_LIBRARY\bin\openssl sha1 -binary | PATH_TO_OPENSSL_LIBRARY\bin\openssl base64

<dependency>
  <groupId>com.facebook.android</groupId>
  <artifactId>facebook-android-sdk</artifactId>
  <version>PUT_LATEST_VERSION_HERE</version>
</dependency>

• A native Login Dialog appears but after accepting the permissions you are still in a logged out state. The logcat also contains an exception:

12-20 10:23:24.507: W/fb4a:fb:OrcaServiceQueue(504):
com.facebook.orca.protocol.base.ApiException: remote_app_id does not match stored id

• A non-native Login Dialog appears with an error message: ‘’..App is Misconfigured for facebook login...’’.

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Add code to print out the key hash
    try {
        PackageInfo info = getPackageManager().getPackageInfo(
                "com.facebook.samples.hellofacebook",
                PackageManager.GET_SIGNATURES);
        for (Signature signature : info.signatures) {
            MessageDigest md = MessageDigest.getInstance("SHA");
            md.update(signature.toByteArray());
            Log.d("KeyHash:", Base64.encodeToString(md.digest(), Base64.DEFAULT));
            }
    } catch (NameNotFoundException e) {

    } catch (NoSuchAlgorithmException e) {

    }

    ...

12-20 10:47:37.747: D/KeyHash:(936): 478uEnKQV+fMQT8Dy4AKvHkYibo=

• Shrink, obfuscate, and optimize your app⁠