Android SDK 新手指南

若要將您的 Android 應用程式與 Facebook 整合,Facebook Android SDK 是最簡單的方式。此 SDK 提供了下列功能:

有 2 種方式可以設定應用程式以使用 Facebook SDK:

  • 使用快速入門。
  • 使用 Facebook SDK 設定您的專案。

快速入門

若要取得 Facebook 應用程式編號,配置您的應用程式設定、匯入 Facebook SDK,接著點擊下方按鈕並按照網上指示操作。

Android 快速入門

 

相關指南:

設定 Android Studio

若要在專案中使用 Facebook SDK,請以建置相依性的方式加入,然後將其匯入。

1.前往 Android Studio | 新增專案 | 最低 SDK。

2.選擇 API 15: Android 4.0.3 或更新版本,然後建立新專案。

3.建立新專案後,開啟 your_app | build.gradle

4.將下列程式碼新增至 build.gradle (Project) 檔案的 buildscript { repositories {}} 部分:

mavenCentral() 

5.將下列程式碼新增至 build.gradle (module: app) 檔案的 dependencies {} 部分,即可編譯最新版本的 Facebook SDK:

此物件應該就會被刪除。詳情請洽 Arsenio Locsin。

使用 Facebook SDK 時,系統會為 Facebook 應用程式分析工具自動記錄並收集事件資料,除非您停用了自動事件記錄功能。若要進一步瞭解系統會收集哪些資料,以及如何自動事件記錄功能,請參閱自動應用程式事件記錄一文。

6.建置您的專案。您現在即可將 com.facebook.FacebookSdk 匯入您的應用程式。

加入 Facebook 應用程式編號

然後將您的 Facebook 應用程式編號加入專案的字串檔案,並更新 Android Manifest:

1.開啟 strings.xml 檔案。路徑範例:/app/src/main/res/values/strings.xml

2.加入一個新字串,名稱是 facebook_app_id,值則是您的 Facebook 應用程式編號。

3.開啟 AndroidManifest.xml

4.將 uses-permission 元素加入 Manifest:

<uses-permission android:name="android.permission.INTERNET"/>

5.將 meta-data 元素加入 application 元素:

<application android:label="@string/app_name" ...>
    ...
    <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
    ...
</application>

發送圖像或影片

若透過 Android 版 Facebook 應用程式分享連結、圖像或影片,則您還必須在 Manifest 中宣告 FacebookContentProvider

將您的應用程式編號附加至 authorities 值的尾端。例如:若您的 Facebook 應用程式編號為 1234,則宣告會類似下列程式碼:

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

配搭 ProGuard 使用 SDK

若要配搭 ProGuard 使用 Facebook Android SDK,您無須執行其他任何步驟。如需 Proguard 的操作說明,請參閱 Android 開發人員網站:縮減程式碼與相關資源

執行應用程式範例

SDK 中隨附下列範例:

  • HelloFacebookSample - 展示個人檔案存取、近況更新和相片上載。
  • RPSSample - 使用原生「分享」對話框、「開放式圖表」發佈、挑選工具、邀請及深層連結。
  • Scrumptious - 登入、要求、挑選工具、相片上載及「開放式圖表」發佈。

您可將 SDK 匯入 Android Studio 專案,嘗試運用這些範例。

這些範例使用專案相依性,而非透過 maven central 或 jcentery 來使用中央存放庫相依性。所以當 SDK 本機副本更新時,範例就會反映變更。

若要快速執行範例,您可針對開發環境產生密鑰雜湊。請將下列程式碼加入應用程式範例的 Facebook 開發人員個人檔案。用以產生密鑰雜湊的 Keytool 會包含在您安裝的 Java SE 開發套件 (JDK) 中,以便協助設定開發環境。您可以在 OpenSSL 下載 OpenSSL。

在 OS X 上執行:

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

在 Windows 上執行:

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

這樣會產生一個包含 28 個字元的字串。

前往 Facebook 開發人員網站。登入 Facebook,然後使用右上角的下拉式選單,前往開發人員設定

在開發人員設定中,從選單選擇應用程式範例,然後在個人檔案中新增並儲存密鑰雜湊:

若針對多重裝置開發,您可加入多個密鑰雜湊。

您現在即可編譯與執行所有範例,包括使用「Facebook 登入」的範例。

建立開發密鑰雜湊

Facebook 使用密鑰雜湊來驗證您的應用程式和 Facebook 應用程式之間的互動。若您會執行使用「Facebook 登入」的應用程式,則必須將 Android 開發密鑰雜湊加入您的 Facebook 開發人員個人檔案。

對於發行的應用程式版本,您也必須產生並設定發行密鑰雜湊

在 OS X 或 Windows 上,您可產生密鑰雜湊,或使用 Settings.getApplicationSignature(Context) 傳回的值來取得密鑰雜湊。如需指示,請參閱執行應用程式範例


後續步驟

在安裝 Facebook Android SDK 並設定 Facebook 應用程式編號後,您會看到下列功能:


設定發行密鑰雜湊

若要驗證應用程式和 Facebook 之間的資訊交換,您需要產生「發行密鑰雜湊」,並將其加入 Facebook 應用程式編號內的 Android 設定。若無此發行密鑰雜湊,當您在商店中推出應用程式後,Facebook 整合可能無法正確作用。

在上一步驟中,您應該已經使用針對開發環境的密鑰雜湊,更新了 Facebook 開發人員設定

應用程式發行時,通常會簽署與開發環境不同的簽章。因此,請務必建立「發行密鑰雜湊」並將其加入 Facebook 應用程式編號的 Android 設定。

若要產生「發行密鑰雜湊」,請在 Mac 或 Windows 上執行下列指令,並替換成您的發行密鑰別名和 KeyStore 路徑。在 OS X 上執行:

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

在 Windows 上使用:

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

請務必使用原先建立發行密鑰時所設定的密碼。

此指令應會產生一個包含 28 個字元的字串。複製此「發行密鑰雜湊」,然後貼入您 Facebook 應用程式編號的 Android 設定。

您還應該檢查 Facebook 應用程式編號的 Android 設定,查看是否也包含 Android 套件的正確套件名稱和 MainActivity 類別。


配搭 Maven 使用 Facebook SDK

您可宣告 Maven 與 Android SDK 最新版本的相依性:

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

解決疑難應用程式範例

若執行應用程式範例時發生問題,大概是與密鑰雜湊有關。您可能會看到下列情況:

  • 出現原生「登入」對話框,但在接受權限後仍處於登出狀態。logcat 同時也包含例外狀況:
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
  • 出現非原生「登入」對話框,並顯示錯誤訊息:「……應用程式錯誤設定 facebook 登入……」。

檢查密鑰雜湊,並確定是否使用正確的密鑰雜湊。I

您也可手動修改程式碼範例,以使用正確的密鑰雜湊。例如:在 HelloFacebookSampleActivity 類別中,暫時變更 onCreate()

@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) {
        
    }
    
    ...

儲存變更,然後重新執行範例。檢查 logcat 輸出中是否有類似如下訊息:

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

將該密鑰雜湊儲存在您的開發人員個人檔案。重新執行範例,並驗證是否可成功登入。