Facebook Android SDK

Facebook Android SDK 變更紀錄

Facebook Android SDK 的變更紀錄和版本說明。

5.0.0 和以上版本

如需 5.0.0 和以上版本的變更紀錄，請參閱 GitHub 上的 facebook/facebook-android-sdk/CHANGELOG.md。

4.41.0 - 2019 年 3 月 8 日

Facebook SDK

新增項目

修改項目

已停用的類別：FacebookUninstallTracker

修復項目

4.40.0 - 2019 年 1 月 22 日

Facebook SDK

新增項目

修改項目

修復項目

  • 各項故障修復

4.39.0 - 2018 年 12 月 5 日

Facebook SDK

新增項目

修改項目

  • 應用程式內購買自動記錄預設為開啟。可使用已上傳的憑證來驗證 Android 自動記錄的購買項目。瞭解詳情

修復項目

  • 各項故障修復

4.38.1 - 2018 年 11 月 1 日

Facebook SDK

新增項目

修改項目

修復項目

  • 修復免程式碼設定連線問題

4.38.0 - 2018 年 10 月 23 日

Facebook SDK

新增項目

修改項目

修復項目

  • 各項故障修復

4.37.0 - 2018 年 9 月 27 日

Facebook SDK

新增項目

修改項目

修復項目

  • 各項故障修復

4.36.1 - 2018 年 9 月 17 日

Facebook SDK

新增項目

修改項目

修復項目

  • 各項故障修復

4.36.0 - 2018 年 8 月 29 日

Facebook SDK

新增項目

修改項目

修復項目

  • 各項故障修復

4.35.0 - 2018 年 7 月 26 日

Facebook SDK

新增項目

  • 升級至 Facebook 圖形 API 3.1 版

修改項目

修復項目

  • 各項故障修復。

4.34.0 - 2018 年 6 月 18 日

Facebook SDK

新增項目

  • 新增行銷模組，啟用免程式碼應用程式事件記錄功能。
  • 新增 JavascriptInterface 和 augmentWebview 方法。這樣可以讓混合式應用程式從像素傳送 AppEvents。
  • 將 videoAsset 屬性新增至 FBShareVideo，讓合作夥伴可使用 PHAsset 分享相片圖庫的影片。

修改項目

  • 改善與圖形 API 3.0 的相容性。

修復項目

  • 各項故障修復。

4.33.0 - 2018 年 5 月 1 日

Facebook SDK

新增項目

  • 升級至 Facebook 圖形 API 3.0 版
  • 新增 ACCESSTOKEN.ISCURRENTACCESSTOKENACTIVE() 便利方法。

修改項目

修復項目

  • 改善停用登入的處理方式
  • 各項故障修復

4.32.0 - 2018 年 4 月 11 日

Facebook SDK

新增項目

修改項目

修復項目

  • 各項故障修復。已修復 setUserId 和 updateUserPropertiesin 的競爭情形（Android SDK）

4.31.0 - 2018 年 2 月 28 日

Facebook SDK

新增項目

修改項目

修復項目

  • 各項故障修復

Account Kit

新增項目

修改項目

修復項目

  • 各項故障修復

4.30.0 - 2018 年 1 月 24 日

Facebook SDK

新增項目

  • 防範路徑周遊安全性漏洞：https://support.google.com/faqs/answer/7496913
  • 支援 Gradle 4.1 及 Android Studio 3.0 的變體感知（variant-aware）相依性管理機制

修改項目

修復項目

  • 微幅修正 Messenger 分享功能
  • 各項故障修復

Account Kit

新增項目

  • AccountKit 圖形 API 升級為 1.3 版

修改項目

  • 移除偏好設定 API
  • 已更新國碼／區碼選擇器及電話號碼輸入方式

修復項目

  • 已修復新 JIO 號碼剖析

4.29.0 - 2017 年 12 月 5 日

Facebook SDK

新增項目

  • 支援 Android 自動填入（隨 Android Oreo 推出的新功能）

  • 新的 Messenger 分享 SDK 功能：部落格文章

修復項目

  • XCode 9／iOS 11 SDK 發出的位元程式碼

4.28.0 - 2017 年 11 月 7 日

Facebook SDK

新增項目

  • 推出全新 Facebook 登入碼應用程式範例

修改項目

  • 「應用程式邀請」功能已過時停用
  • 原生「讚」按鈕已過時停用

4.27.0 - 2017 年 9 月 26 日

Facebook SDK

新增項目

  • 自動記錄應用程式內購買

修改項目

  • 重組 Facebook SDK 的結構，並組織為可彼此相依的個別資料庫／模組。
  • 將 GraphRequest.createOpenGraphObject(ShareOpenGraphObject) 移至 ShareGraphRequest.createOpenGraphObject(ShareOpenGraphObject)
  • 將 FacebookSDK.[set|get]WebDialogTheme(...) 移至 WebDialog.[set|get]WebDialogTheme(...)
  • 移除 styles.xml 中未使用的維度
  • 移除僅供內部測試使用的檔案
  • 更新 Proguard 檔案

修復項目

  • 修復程式碼輸入畫面顯示錯誤鍵盤類型的問題

Account Kit

修復項目

  • 故障修復與範例應用程式更新

4.26.0 - 2017 年 8 月 24 日

Facebook SDK

新增項目

  • 用於裝置登入及分享功能的 QR 代碼

修復項目

  • 在要求設定時，新增 null 檢查。

Account Kit

新增項目

  • 您現在可以在 Manifest 上選擇任一種預設語言，不必再包含英文翻譯

修復項目

  • 微幅修正 UI

4.25.0 - 2017 年 7 月 26 日

Facebook SDK

修復項目

  • 變更 ShareDialog.canShow，當嘗試將 ShareOpenGraphContent 中的本機圖像分享至網頁對話方塊時，會正確傳回 false。

Audience Network

新增項目

  • 使用 Exoplayer 來播放影片廣告，而不使用 Mediaplayer

修改項目

  • 已更新 Google Play 服務和支援程式庫相依性版本

修復項目

  • 已修復在獎勵式影片播放結束後與顯示結束圖卡前，與畫面互動所產生的當機問題
  • 已修復在尚未擷取廣告編號時第一次曝光的未供應廣告問題
  • 插頁廣告輪替後，Exoplayer 不會再重新開始播放影片
  • 已修復在舊版 Android 裝置（4.2 版以下）播放影片插頁廣告所產生的當機問題

Account Kit

新增項目

  • 如果可使用 Google Play 服務，開發人員不再需要 READ_PHONE_STATE 權限來自動填入裝置的電話號碼。
  • 如果可使用 Google Play 服務，開發人員不再需要 GET_ACCOUNTS 權限來自動填入裝置的電子郵件地址。
  • 電子郵件即時驗證

4.24.0 - 2017 年 6 月 26 日

Facebook SDK

修改項目

  • 新增參數以設定「快速登入」快顯通知的時間長度
  • 呼叫「快速登入」成功後，用戶個人檔案便可供使用。裝置上必須安裝 Android 專用 Facebook 131 版，才能進行這項操作。
  • AppEvent 類別中事件名稱的 Md5 總和檢查碼

Audience Network

新增項目

  • 停用 Exoplayer 上的媒體控制列
  • 新增可略過的關閉按鈕和新的略過按鈕設計
  • 新增獎勵式影片的播放／暫停按鈕設計

修改項目

  • 改善獎勵式影片中的 AdMetadata 大小／間隔
  • 變更獎勵式影片中進度列的色彩，以搭配結束圖卡的行動呼籲按鈕顏色

修復項目

  • 能夠再次點擊，以便於主要廣告檢視階層外註冊的檢視。
  • 移除視窗狀態變更時廣告檢視檢查工具的競爭情況。

Account Kit

修復項目

  • 修復來回切換 AccountKit 後無法讀取簡訊的問題。

4.23.0 - 2017 年 5 月 25 日

Facebook SDK

新增項目

  • 新增取消註冊登入回呼的支援

Audience Network

修復項目

  • 應用程式從 Nexus 裝置上的背景返回後，重新開始播放影片時再次嘗試播放的錯誤
  • 修復返回按鈕允許略過自動播放影片的行為
  • 紀錄器停止運作時，排清影片時間事件。
  • 如果 nativeConfigObject 為空物件，則將 nativeAdViewAttributes 設為 null
  • 修復插頁廣告顯示回呼呼叫插播影片廣告兩次的問題
  • 修復嘗試顯示影片控制項時影片暫停／播放的問題
  • 強制為插播影片的進度計數器新增色彩
  • 修復 AudienceNetworkActivity 的記憶體流失問題

Account Kit

新增項目

  • 新增國家／地區旗幟至手機登入的國碼／區碼選擇器

修復項目

  • 修復多次嘗試登入造成的當機問題
  • 修復部分使用介面問題

4.22.1 - 2017 年 5 月 11 日

Facebook SDK

無變更。

Audience Network

無變更。

Account Kit

修復項目

  • Null 指標在重新傳送驗證碼頁面造成的當機問題。

4.22.0 - 2017 年 4 月 18 日

Facebook SDK

新增項目

修改項目

  • 更新 Smart Login 的本地化內容
  • FBSDKShareLinkContent 的 title、description、caption 和 image 欄位已停用。請採取適當的動作移除相關的使用。

Account Kit

新增項目

  • 電話號碼（用於語音通話）備用驗證。
  • 呼叫登出專用登出端點

修改項目

  • 新增其他紀錄
  • 更新重新傳送簡訊流程的用戶體驗
  • 改善小螢幕用戶的使用體驗
  • 將 LoginType 從 SkinManager 和 AdvancedUiManager 的必要元件中移除
  • 改善資訊披露的說明文字在 UX 中的顯示方式
  • 如果使用外觀，則不需要 AppLoginTheme
  • 升級為使用 1.2 版 Account Kit 圖形 API 版本

4.21.1 - 2017 年 4 月 6 日

Facebook SDK

無變更。

Audience Network

修復項目

  • 使用應用程式內容初始化廣告瀏覽次數時的當機問題

Account Kit

無變更。

4.21.0 - 2017 年 4 月 4 日

Facebook SDK

無變更。

Audience Network

新增項目

  • 新增多種效能和穩定性最佳化工具。
  • 全新設計的插頁影片廣告 - 將陸續推出。

修復項目

  • 由上傳網址造成應用程式內瀏覽器當機的問題
  • 媒體播放器的記憶體流失問題已於 Android 第 7 版中修復

Account Kit

無變更。

4.20.0 - 2017 年 3 月 1 日

Facebook SDK

修改項目

  • 更新並本地化 SmartLogin 對話方塊。
  • 現在會立即傳送推播權杖。請參閱文件以瞭解詳情。

Audience Network

新增項目

  • 新增多種效能和穩定性最佳化工具。

修改項目

  • Android 資訊清單不再需要 AudienceNetworkActivity。

修復項目

  • 修復原生廣告輪播子項無法觸發 onAdClickedListener 的問題。
  • 修復在模擬器上點擊原生廣告輪播會當機的問題。

Account Kit

新增項目

  • 已新增 4 種本地化語言。
  • 推出傳統、現代及半透明外觀，以便輕鬆自訂使用介面。

修改項目

  • 已新增停用標籤至舊版程式碼。

修復項目

  • 修復多項故障。

4.19.0 - 2017 年 1 月 25 日

Facebook SDK

修改項目

  • 現在應用程式啟動時，會自動初始化 Facebook SDK。在多數情況下，不再需要手動呼叫 FacebookSDK.sdkInitialize()。如需詳細資訊，請參閱升級指南。
  • 現在會於 SDK 初始化時呼叫 Activate App。若要停用此功能，請依照升級指南的指示操作。
  • 更新 LoginButton 的外觀設計。如需詳細資訊，請參閱升級指南。

修復項目

  • ActivityLifecycleTracker 潛在的記憶體流失問題

Audience Network SDK

新增項目

  • 已新增前景／背景接聽程式至 MediaView。

修復項目

  • 針對 Android API 第 18 版以前的舊版本，修復其 NativeAdsManager 當機問題。
  • 現在影片結束播放時，會正確呼叫 MediaViewListener 中的 onComplete 方法。
  • 啟動應用程式內部瀏覽器時，因通訊協定不受支援而發生的當機問題。

Account Kit SDK

修改項目

  • 現在應用程式啟動時，會自動初始化 Account Kit SDK。在多數情況下，不再需要手動呼叫 AccountKit.initialize()。如需詳細資訊，請參閱升級指南。
  • 將 Account Kit 即時驗證按鈕預設為「繼續」

修復項目

  • Android 第 7 版和更新版本會在檔案標示為 WORLD_ 時擲回例外狀況，已修復此情況的當機錯誤
  • 輸入畫面的向後箭頭主題設定
  • 在確認碼輸入畫面，將焦點設定在第一個輸入欄位
  • VI 翻譯
  • 檢查某些裝置上的權限行為

新增項目

  • 記錄國家／地區代碼

4.18.0 - 2016 年 11 月 30 日

Facebook SDK

修改項目

  • 在 AppEventsLogger.handleResponse() 新增 null 檢查功能。

Audience Network

修復項目

  • 修復 adViewDidClick 在 FBInstreamAdView 中無法正常觸發的問題
  • 修復 UIRectCornerTopRight 和 UIRectCornerBottomRight 的 FBAdChoicesView 可展開動畫

Account Kit SDK

修改項目

  • 新增在收到 AccountKitError 的 errorCode 時，進行 null 檢查的功能。

4.17.0 - 2016 年 10 月 26 日

Facebook SDK

新增項目

  • 新增 setUserID 和 updateUserProperties 至 FBAppEventsLogger。如需詳細資訊，請參閱此文件。
  • 已經為 Android TV／Fire TV 應用程式新增「Smart Login」功能。如需詳細資訊，請參閱部落格文章。API 無須進行任何變更即可使用這項新功能。

修改項目

  • 已更新 Android 支援程式庫

修復項目

  • 已修復「開放社交關係圖」分享時的用戶標註問題。

Audience Network

修復項目

  • 修復 SQLiteDatabaseLockedException

Account Kit

新增項目

  • 手機號碼登入的即時驗證功能

修改項目

  • 改善錯誤代碼回報功能
  • 已更新使用 1.1 Account Kit 圖形端點
  • 已更新工作階段記錄功能
  • 已移除取消回呼功能

4.16.1 - 2016 年 10 月 7 日

Facebook SDK

修改項目

Audience Network

修復項目

  • 暫時性 ConcurrentModificationException
  • 與資料庫游標相關的 StrictMode 警告

4.16.0 - 2016 年 9 月 27 日

Facebook SDK

新增項目

  • 新增 FacebookSdk.setGraphApiVersion，可為不同的圖形 API 版本進行全域設定

修復項目

  • PR-483 修復潛在的 DeadObjectExceptions
  • PR-483 修復潛在的 DeadObjectExceptions
  • 針對 webdialog 進度環，改善主題的處理方式

Audience Network

新增項目

  • 應用程式內部瀏覽器，可在網頁檢視中開啟連結廣告
  • InstreamVideoAdView 類別，可支援插播廣告版位

修改項目

  • 影片快取上限更新為可預先擷取 64 MB
  • 已停用 MediaView 中的 setAutoplay 和 setAutoplayOnMobile

修復項目

  • 由於 LocalBroadcastReceiver 保留 MediaView 參考所造成的記憶體流失
  • 在 Cookie 已同步的情況下，WebView 在裝置上更新所造成的 NullPointerException

Account Kit SDK

新增項目

  • 新增傳送新簡訊至相同手機號碼的計時器

修改項目

  • 內容語言 + 本地化更新
  • 改善小型螢幕用戶的使用體驗
  • 將確認按鈕從「完成」改為「下一步」

修復項目

  • 以開發人員提供的國碼／區碼取代手機裡的國碼／區碼
  • Lollipop 及更低版本裝置中的向量圖形
  • Lollipop 及更低版本裝置中的鍵盤顯示行為

4.15.0 - 2016 年 8 月 23 日

Facebook SDK

修改項目

  • PR-470 允許開發人員在社交關係圖要求的路徑元素中指定查詢參數
  • 與應用程式和遊戲社團相關聯的類別和方法已停用
  • 修改裝置登入用戶介面，以使用 Roboto 字型

修復項目

  • Chrome 自訂頁籤在處理 Facebook 登入時更為順暢
  • 當磁碟損毀時，在處理應用程式事件持續性上更為順暢
  • PR-481 已修復切換用戶應用程式範例
  • 已修復 Android 6.0 版中網頁對話方塊的旋轉問題

Audience Network

修改項目

  • 提升影片穩定性和更新全螢幕使用介面

Account Kit SDK

修改項目

  • 將 PNG 圖像轉換為向量圖形，以縮減 SDK 大小
  • 在範例的 defaultConfig 中新增指定翻譯語言設定的範例
  • 已更新初始輸入畫面的資訊披露字串

修復項目

  • 修復在舊裝置上檢查裝置權限時所造成的 RuntimeException

4.14.1 - 2016 年 8 月 4 日

Audience Network

修復項目

  • 因無效的 4.14.0 POM 檔案所造成的 Gradle 遠端相依性例外狀況

4.14.0 - 2016 年 7 月 13 日

Facebook SDK

新增項目

  • 如果未安裝 Android Facebook 應用程式，SDK 會在登入流程自動使用 Facebook Lite 應用程式第 11 版和更新版本

修改項目

修復項目

  • 已修復無效的應用程式事件造成無法記錄應用程式事件的問題

Audience Network

修復項目

  • 已修復當活動顯示在解鎖功能（keyguard）上方時，曝光次數記錄上的錯誤

4.13.2 - 2016 年 7 月 1 日

Facebook SDK

修復項目

  • 切換活動後可能遺失正在執行的應用程式事件

Account Kit SDK

修復項目

  • 登入期間發生 NPE

4.13.1 - 2016 年 6 月 17 日

Facebook SDK

修復項目

  • 修復 AppEventsLogger Null 指標例外狀況

4.13.0 - 2016 年 6 月 15 日

Facebook SDK

修改項目

  • 允許在 Chrome 測試版和開發版上開啟 Chrome 自訂頁籤
  • 使得 Chrome 自訂頁籤存取權杖可用於網頁檢視對話方塊
  • 使用 AppEventsLogger 在 activateApp 中明確記錄安裝事件

修復項目

  • 已修復應用程式事件記錄器中的活動流失
  • 已修復 AppEventsLogger 中可能的死結
  • 修復翻譯中的 %@
  • 修復解編時找不到類別的問題：com.facebook.login.LoginClient$Request
  • PR 476 - 找不到正確簽章時立即失敗

Account Kit SDK

修改項目

  • 以向量的形式繪製大部分的圖像素材，而非繪製為 PNG，以降低 SDK 大小

修復項目

  • 修復下一步按鈕的投放（https://developers.facebook.com/bugs/1091582134248501/）
  • 修復未初始化 SDK 以符合正確方法名稱時所顯示的錯誤
  • 修復手機登入頁面的韓文翻譯

4.12.1 - 2016 年 5 月 26 日

Facebook SDK

修復項目

  • 在舊版 Android 裝置上，處理於 HttpURLConnection 上讀取 responseCode 時發生的 NoSuchAlgorithmException

Audience Network

修改項目

  • 已移除 X509TrustManager 的使用，以解決 Google Play 警告訊息

修復項目

  • AdQuality 遺失相依性錯誤
  • 使 MediaPlayer 無法在某些裝置上恢復播放的故障

4.12.0 - 2016 年 5 月 20 日

Facebook SDK

修改項目

  • 只有在有應用程式事件需要排清時，才會排程將應用程式事件排清，而不是每 15 秒排清一次
  • 初始登入現在會傳遞「重新要求」標示，以在登入對話方塊中顯示先前遭拒絕的權限
  • 已移至 Gradle 2.10
  • 將存取權杖來源從 CUSTOM_TAB 變更為 CHROME_CUSTOM_TAB
  • 停用 AppLinkData.ARGUMENTS_TAPTIME_KEY
  • FacebookActivity 和 ChromeCustomTabsActivity 已移至 Facebook SDK 程式庫的 AndroidManifest。

修復項目

  • 修復 ShareDialog 中的問題：如果未安裝 Facebook 應用程式，則無法分享引文。
  • ProGuard 移除序列化資訊，導致在某些情況下將應用程式事件序列化至磁碟時，會發生例外狀況。
  • 損毀的應用程式事件快取檔案從未清除
  • 應用程式在完成分享或登入後啟動可能發生當機，以及應用程式在登入或分享期間終止的問題。
  • 修復某些魅族裝置上的安全性和 NPE 問題

Audience Network

修復項目

  • 由於子項計數無效造成的 RecyclerView 當機問題
  • 未呼叫 MPA 子項 adListener 的故障

Account Kit

新增項目

  • 在電子郵件登入嘗試上指定 redirect_uri，以便用戶看到按鈕，提示用戶在確認後開啟應用程式

修復項目

  • 接受結尾有空白字元的電子郵件地址
  • 修復在取消要求之後輪詢電子郵件確認時可能發生的競爭條件

4.11.0 - 2016 年 4 月 12 日

Facebook SDK

新增項目

  • 新增 AppEventsLogger.setPushNotificationsRegistrationId 和 AppEventsLogger.logPush*。如需詳細資訊，請參閱推播通知。
  • 新增 ShareHashtag，以支援分享主題標籤。如需詳細資訊，請參閱在 Android 分享。
  • 新增 ShareMediaContent，以支援分享混合內容（例如相片和影片）。如需詳細資訊，請參閱在 Android 分享。
  • 新增 ShareLinkContent.Builder.setQuote，以支援分享連結中的引文。如需詳細資訊，請參閱在 Android 分享。
  • 新增 AppInviteContent.setPromotionDetails 和 AppLinkData.getPromotionCode，可在應用程式邀請中輕鬆加入促銷活動代碼。如需詳細資訊，請參閱應用程式邀請。
  • 新增 AppEventsLogger.activateApp(Application)，大幅簡化 Facebook 分析工具的使用方式。您可以在應用程式的 onCreate 中呼叫此方法，而不是從每項活動的內部呼叫。如需詳細資訊，請參閱應用程式事件。
  • 新增 DeviceLoginButton，進行裝置流程驗證時，能夠設定重新導向 URI。
  • 新增 DeviceLoginManager，進行裝置流程驗證時，能夠設定重新導向 URI。

修改項目

  • 更新為使用圖形 API 2.6 版。
  • 改善 AppEvents 中的連線階段追蹤準確性，包括用來識別連線階段逾時臨界值的可配置值，（位於應用程式的 Facebook 分析工具設定中）。
  • 如果尚未安裝 Facebook 應用程式，SDK 會在登入流程自動使用 Chrome 自訂頁籤。

修復項目

  • 修復透過網頁檢視發出的權杖無法自動重新整理的問題。
  • PR-459

Audience Network

新增項目

  • 已新增對原生廣告的影片預先快取的支援

修改項目

  • 修改多產品廣告的背景和載入圖卡色彩

修復項目

  • 已修復多產品廣告圖像預先快取的問題

Account Kit

應用程式內部通知

4.10.1 - 2016 年 3 月 18 日

Facebook SDK

修改項目

  • 更新支援程式庫的版本。

修復項目

  • 修復透過網頁檢視發出的權杖無法自動重新整理的問題。

Audience Network

修復項目

  • 移除重疊的瀏覽檢查，以復原曝光次數。

4.10.0 - 2016 年 2 月 10 日

Facebook SDK

修改項目

  • 不再需要 multidex
  • 回復 4.9.0 中的變更，依預設傳遞所有社交關係圖要求的語言設定。您還是可以手動指定語言設定欄位來取得本地化結果。

Audience Network

新增項目

  • 新增 MediaView 的多產品廣告支援。
  • 新增 AAR 封裝，並移除 JAR 封裝。
  • 新增用以忽略轉接器警告的 consumerProugardFile 規定。

修復項目

  • 已修復 BlurBorderImage 高度計算中的衝突問題。
  • 現在影片緩衝時會顯示微調按鈕。

移除項目

  • JAR 封裝。

4.9.0 - 2016 年 1 月 13 日

Facebook SDK

新增項目

  • 已新增對 Fire TV 和 Android TV 的支援。請參閱與 Android TV 和 Fire TV 整合。
    • 新的裝置驗證登入行為。
    • 「登入」、「發送」、「分享」和「讚」按鈕現在可透過鍵盤或遠端輸入使用。

修改項目

  • 現在會隨所有社交關係圖要求傳送裝置的目標地區設定。這可以讓要本地化的圖形 API 結果設為用戶目前所用的目標地區設定。

修復項目

  • 修復登入期間意外點擊進度對話方塊外部會取消登入流程的問題。
  • 修復 SDK 初始化後未呼叫回呼的問題。（PR 452）
  • 修復 listFile 存取可能發生 NPE 的問題（PR 454）
  • 修復「讚」按鈕社交句型，以配合語言設定。
  • 已修復 SDK 初始化中可能發生的競爭情況
  • 已修復 FBSDKLikeControl 社交句型來採用當地語言。

Audience Network

新增項目

  • 改善影片載入狀態的處理方式，包括封面圖像和載入進度環。

修復項目

  • 已修復因表面紋理卸離造成 IllegalStateException 的相關錯誤。
  • 已修復因廣告標題為 Null 而造成當機的錯誤。

移除項目

  • 已移除 MediaView 對 VideoView 的支援，僅影響 Honeycomb 和更舊版本。

4.8.2 - 2015 年 11 月 23 日

Facebook SDK

新增項目

  • 已新增存取權杖追蹤器重新整理方法的回呼。

Audience Network

修復項目

  • 已修復因停用自動播放而造成 MediaView 當機的問題。

4.8.1 - 2015 年 11 月 11 日

Facebook SDK

修復項目

  • 在尚未附加至片段的「發送／分享」按鈕上設定分享內容時，發生 Null 指標例外狀況。

Audience Network

無變更

4.8.0 - 2015 年 11 月 11 日

Facebook SDK

新增項目

  • 新增的支援項目：使用 Login Manager 和使用介面項目可搭配原生片段（android.app.Fragment）

修復項目

  • 已修復以下錯誤：發生例外狀況時連線可能洩漏資料

修改項目

  • 設定的主題現在會套用至所有網頁檢視，而不只是登入網頁檢視（PR 448）
  • 更新 Scrumptious 應用程式為使用原生片段，而不是支援片段

Audience Network

修復項目

  • 已為瀏覽器新增 EXTRA_APPLICATION_ID，以重複使用廣告點擊上的標籤
  • 已修復因為未釋放影片播放器而發生的 IllegalStateException
  • 透過強制插頁按照預定方向顯示，修復插頁方向問題

修改項目

  • Apache HTTP 更換為第三方 AndroidHttpClient

4.7.0 - 2015 年 10 月 7 日

Facebook SDK

修復項目

  • 建立含 Null ActionType 的 GameRequestContent 時，可能會發生 NPE（PR 445）

修改項目

  • 已移至圖形 API 第 2.5 版
  • 目標 Android API 現在為 23
  • 停用 GameRequestContent 中的「to」元素，並更換為「recipients」元素。（PR 445）
  • 從 developers.facebook.com 下載的項目現在會包含 Facebook Android SDK 的 aar，而非原始碼。GitHub 仍會持續提供原始碼和範例

Audience Network

修復項目

  • 已修復建立 NativeAdManager 時的記憶體流失問題
  • 已修復原生廣告註冊的記憶體流失問題
  • 已修復全螢幕影片播放器的記憶體流失問題
  • 已修復 API 14 之前的裝置未能正確播放影片的問題
  • 已修復記錄曝光次數的錯誤

修改項目

  • 目標 Android API 現在為 23

4.6.0 - 2015 年 9 月 10 日

Facebook SDK

新增項目

  • 已新增 API，可從 Intent 建立 AppLinkData 物件。

修復項目

  • 修復透過反映取得識別碼的問題。（PR-441）
  • 已修復 SDK 初始化期間違反 strict 模式的問題。
  • 已修復在背景執行緒上呼叫 GraphRequest 與 ShareApi 會失敗的問題。
  • 已在分享模型類別新增遺漏的 CREATOR。（PR-436）
  • 修復無法以 fb 做為應用程式編號開頭的問題。（PR-438）

修改項目

  • 如果無法分享要分享的內容，「發送」和「分享」按鈕會自動停用。
  • 最低 Android SDK 現在為第 15 版

Audience Network

注意：Facebook 已發現 Android 專用 Audience Network jar 4.6 版中的曝光次數記錄故障，可能導致曝光次數和收益降低。這個錯誤已於 4.7 版修復，強烈建議您更新至該版本。

修復項目

  • 改善 MediaView 內容的效能
  • 修復 MediaView 記憶體流失的問題

4.5.1 - 2015 年 8 月 13 日

Audience Network

修復項目

  • 修復 MediaView 與大螢幕裝置的相容性

4.5.0 - 2015 年 8 月 10 日

Facebook SDK

新增項目

  • 新增自動記錄「讚」、「分享」、「發送」和「登入」按鈕點擊的 AppEvent 事件。
  • 新增「Share It」應用程式範例。
  • 已能夠在 AndroidManifest.xml 中以「fb」作為應用程式編號的開頭（PR-435）

修復項目

  • 已修復以下問題：「讚」按鈕在按讚的專頁上不一定會顯示為已按讚。
  • 已修復以下問題：未提供任何應用程式群組隱私設定給 CreateAppGroup 對話方塊時，發生 Null 指標例外狀況。
  • 修復用戶裝置上沒有 Facebook 應用程式和瀏覽器時，應用程式會當機的問題。
  • 修復 AndroidManifest.xml 中應用程式編號的整數溢位問題（PR-435）

Audience Network

新增項目

  • 新增 MediaView 的原生影片支援

修改項目

  • AdChoicesView 現在預設為僅限可點擊的文字，可選擇使用現有的可展開圖示

修復項目

  • WebView 現在使用 ApplicationContext 以避免記憶體流失。
  • 已修復舊版 Android 中 View.getLocationOnScreen 的 Null 指標例外狀況

4.4.1 - 2015 年 7 月 13 日

Audience Network

修復項目

  • 避免針對插頁和原生格式自動重新整理在用戶端上觸發的 onError
  • 避免在螢幕關閉時，針對橫幅格式自動重新整理
  • 剖析無效的要求參數錯誤
  • 導致「廣告未準備好」例外狀況的罕見競爭條件

4.4.0 - 2015 年 7 月 8 日

Facebook SDK

新增項目

  • 新增 FacebookSdk.sdkInitialize 全部完成時的回呼
  • 新增相片上傳協助工具方法至 GraphRequest 類別。

修改項目

  • 已將預設的圖形 API 版本更新為 2.4 版。開發人員現在必須在所有的圖形 API 端點中明確要求欄位（如名稱、地點等）。
  • 已修改 LoginBehavior enum 的命名，以更貼切地表達實際的登入行為。

修復項目

  • 因為沒有網路導致登入失敗時，現在會呼叫 onError 而非 onCancel。

Audience Network

修復項目

  • 修復 DownloadImageTask 的 OutOfMemoryError

4.3.0 - 2015 年 6 月 25 日

Facebook SDK

新增項目

  • 將透過遠端服務擷取 Google 廣告主。

修改項目

  • 升級至 roboelectric 3
  • 將範例的命名空間從 com.facebook 變更為 com.example
  • 停用 SharePhoto 和 ShareVideo 的參數。在需要之處使用 GraphRequest 來分享影片和相片。
  • 更新 Buck 組建。（PR 426 和 423）

修復項目

  • 「Hello Facebook」應用程式範例要求不必要的權限（透過對話方塊分享）。
  • 建立登入記錄器時若相關內容為 Null，會發生 Null 指標例外狀況。（PR 430）

Audience Network

修復項目

  • 裝置旗幟已開啟「不要保留活動」時，「返回」按鈕會觸發插頁當機
  • 明確以 Android 5.0 為目標的應用程式會發生混合內容 WebView 錯誤
  • 在 WebView 已終結後呼叫 activateAd()，WebView 會當機

4.2.0 - 2015 年 5 月 28 日

Facebook SDK

新增項目

  • 為 ShareApi 新增社交關係圖節點，並為相片／影片新增參數
  • 新增對 Gradle 2.4 的支援
  • 新增翻譯
  • Iconicus Applinks 範例
  • 能夠指定 WebDialog 用於登入的主題。
  • 可存取裝置的非專屬資訊，並隨著應用程式事件一起傳送，以改善 Facebook 分析工具的分析報告。

修改項目

  • 移除 LoginButton 的自訂要求代碼
  • 將 Gradle 更新至 2.4 版（PR 421）
  • 將 Android 工具更新至 1.2.3 版
  • 移除 jcandksolutions android-unit-test
  • 將「分享」、「發送」和「登入」按鈕中的 onClickListener 呼叫從動作處理常式的結尾移至開頭。

修復項目

  • 登入完成後，Login Manager 在保留相關內容時發生記憶體流失問題。
  • PR 419：已修復多層次相關內容包裝函式的解除包裝。
  • 現在可在 Android Studio Designer 中使用檢視
  • 在 OpenGraphShareContent 上設定 peopleId 或 placeId 失敗的問題。
  • 某些內容 URI 無法透過原生對話方塊分享影片。

Audience Network

修復項目

  • 已修復某些應用程式在顯示插頁廣告時會擲回例外狀況的問題

4.1.2 - 2015 年 5 月 14 日

Facebook SDK

修復項目

  • 透過 ShareApi 分享「開放社交關係圖」物件，可能無法正確執行巢狀物件。
  • 在某些情況下，登入流程期間會不正確地呼叫 OnCancel。

Audience Network

無變更

4.1.1 - 2015 年 5 月 6 日

Facebook SDK

修復項目

  • 所有透過 ShareApi 分享的「開放社交關係圖」內容都需要 user_messages 權限。
  • 使用檔案 URI 而非內容 URI 的影片無法透過 ShareApi 分享。

Audience Network

修復項目

  • Null 用戶代理程式的 Null 指標例外狀況。
  • 使原生廣告範本的圖像變得模糊時會攔截到 OutOfMemoryError。
  • 使原生廣告範本的圖像變得模糊時會攔截到所有錯誤。
  • 使原生廣告範本的圖像變得模糊時會使用較少的記憶體。

4.1.0 - 2015 年 4 月 30 日

Facebook SDK

新增項目

  • 已新增一個方法讓您重新整理存取權杖的權限。
  • 已新增要求「遊戲邀請」結果的收件人。
  • 支援 SharePhoto 物件的相片解說。
  • 支援以更可靠的方式上傳大型影片。
  • 支援重新嘗試上傳影片。
  • 驗證是否遺漏資訊清單項目。
  • 從自訂對話方塊呼叫 ShareApi 時能夠提供訊息。
  • 在 Scrumptious 中透過 ShareApi 分享時的進度對話方塊。
  • Style 屬性標籤以命名空間表示。
  • 支援 Travis CI。

修復項目

  • 問題：用戶發生「無法找到 com.facebook.katana.provider.AttributionIdProvider 的提供者資訊」錯誤訊息。
  • 傳遞無存取權杖的 Intent 時，createFromNativeLinkingIntent 會當機。
  • 快速取消登入時，會發生 Null 指標例外狀況。
  • 錯誤：登出時未清除網頁檢視 Cookie。
  • 錯誤：Scrumptious 應用程式的地點挑選工具。
  • ShareApi 中對發佈執行嚴格權限檢查。
  • 問題：記錄應用程式安裝事件時未記錄應用程式版本。
  • Scrumptious 無法分享相機拍攝的相片，但可從圖庫中選擇。
  • 已修復以下錯誤：建立網頁對話方塊失敗時，支援程式庫會發生當機。
  • 已修復以下錯誤：存取權杖非 Null 時，您無法設定不同的權限。
  • 已修復以下錯誤：當應用程式編號置於 AndroidManifest.xml 中，而非資源檔案時，無法剖析應用程式編號。
  • 已修復以下錯誤：避免「開放社交關係圖」動作使用 fb:explicitly_shared。
  • 提取要求 411：錯誤訊息提及 LoginActivity 而非 FacebookActivity。
  • 提取要求 415：網頁檢視的記憶體流失。

此版本有重大變更。如需詳細資訊，請參閱升級指南。從 Android SDK 4.0.1 升級至 4.1.0。

Audience Network

新增項目

  • NativeAdsManager 可協助批次擷取廣告。
  • NativeAdView 會提供可配置的原生廣告檢視範本，並透過 NativeAdViewAttributes 物件進行配置
  • NativeAdScrollView 會提供水平捲動體驗，主控 NativeAdView 或自訂檢視
  • 協助工具檢視畫面可協助實作原生廣告：
    • AdChoicesView 可在自訂原生檢視中加入可展開的廣告選擇圖示
    • MediaView 可處理 NativeAd 圖像的下載和顯示，同時維持長寬比

修改項目

  • 已改善應用程式範例，有助展現 NativeAdView 範本的優點

修復項目

  • 其他故障修復

4.0.1 - 2015 年 4 月 2 日

Facebook SDK

新增項目

  • 已在 Scrumptious 中新增明確的橫向版面配置。
  • 可在版面配置中設定 LoginButton 的 tooltip_mode 屬性。

修復項目

  • 應用程式設定更新為由 FacebookSdk 上的執行程式擷取。
  • LoginButton NUX 設定更新為由 FacebookSdk 上的執行程式擷取。
  • 已更新「登入」按鈕，以便正確測量大小。
  • 已修復透過 ShareApi 上傳影片功能。
  • GingerBread 裝置一律會停用與頁面編號相關的 LikeView。

4.0 - 2015 年 3 月 25 日

Facebook Android SDK 4.0 版是一個重大升級版本，其特色包括：

  • 已改善「登入」程式撰寫模型。
  • 已改善「分享」程式撰寫模型，以及支援更多無需擁有存取權杖即可進行分享的方式。
  • 已改善錯誤處理和錯誤復原機制。
  • SDK 現在允許開發人員對整個專案執行 ProGuard，進而降低最終 APK 的大小。

以上說明 SDK 3.x 版和 4.0 版之間的主要差異。如需有關升級的詳細資訊，請參閱從 Android SDK 3.x 升級至 4.x。

Facebook SDK

新增項目

登入：

分享：

  • ShareApi 類別有助於透過圖形 API 分享。

對話方塊：

  • 強型別對話方塊類別 - 已新增至「應用程式邀請」、「應用程式群組建立」、「應用程式群組加入」、「遊戲邀請」、「訊息」和「分享」。每個 *Dialog 類別各有一個相關聯的 *Content 類別和 Builder，因此您能夠輕鬆設定參數。

修改項目

  • 已停用 - 已移除 3.x 版中標示 @deprecated 的任何類別或方法。某些功能特定的類別已移至其各自的套件中，例如 com.facebook.login 和 com.facebook.share。

  • 圖形 API - 已移除 GraphObject、OpenGraphObject 和 OpenGraphAction 類別，改為直接使用 JSON 物件。使用 OG 物件／動作進行分享的應用程式，仍可在 ShareOpenGraphObject 和 ShareOpenGraphAction 類別中使用協助工具方法來建置 OG 物件／動作。這樣便能讓開發人員在整個專案中都使用 ProGuard。

  • 移除 UiLifecycleHelper - 此項目已移除，用於傳遞登入或對話方塊結果的各種 onActivityResult 或 handleOnActivityResult 呼叫現在皆列於 CallbackManager 類別。

  • LoginFragment - 已移除。

  • 挑選工具片段 - 已移除。

分享：

  • 分享類別 - 許多用於分享的類型已修改。請參閱在 Android 分享。

  • 對話方塊變更 - 所有 *Dialog 類別已轉換為使用 FacebookCallback 和 CallbackManager。

  • 自動網頁後援 - 如果裝置未安裝 Facebook 應用程式，ShareDialog 和 AppInviteDialog 會自動回復為使用網頁對話方塊。請參閱在 Android 分享：內建分享後援。

登入：

  • AccessToken 現在包含 userId。

  • 替換類別 - Session 和 UserSettingsFragment 已移除，並替換為 LoginManager 和 AccessToken 類別。LoginActivity 已替換為 FacebookActivity。

錯誤處理