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 Graph API 3.1 版

修改項目

修正項目

  • 各種錯誤修正。

4.34.0 - 2018 年 6 月 18 日

Facebook SDK

新增項目

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

修改項目

  • 已提升與 Graph API 3.0 的兼容性。

修正項目

  • 各種錯誤修正。

4.33.0 - 2018 年 5 月 1 日

Facebook SDK

新增項目

  • 升級至 Facebook Graph 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 中管理版本感知相依性

修改項目

修正項目

  • Messenger 分享功能小幅修正
  • 各種錯誤修正

Account Kit

新增項目

  • 升級為 AccountKit Graph API 版本 1.3

修改項目

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

修正項目

  • 已修正新式 JIO 號碼的解析功能

4.29.0 - 2017 年 12 月 5 日

Facebook SDK

新增項目

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

  • 全新 Messenger 分享 SDK 功能：網誌文章

修正項目

  • XCode 9／iOS 11 SDK 專用 bitcode 釋出

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 碼

修正項目

  • 新增要求配置時對 ExperimentationConfiguration 進行的 null 檢查。

Account Kit

新增項目

  • 您現在可以為 Manifest 選擇預設語言，不需要再加入英文翻譯。

修正項目

  • 用戶介面細微修正

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 v131 版，方可使用此功能。
  • 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 Pointer 故障問題。

4.22.0 - 2017 年 4 年 18 日

Facebook SDK

新增項目

  • 已新增 Places Graph。
  • Facebook 登入專用的快速登入功能：已在 Login Manager 中新增擷取登入狀態功能。
  • 已更新使用 Graph API v2.9 版。

修改項目

  • 「智能登入」本地化更新
  • FBSDKShareLinkContent 的 title、description、caption 和 image 欄位已停用。請執行適當的動作以移除這些項目。

Account Kit

新增項目

  • 透過語音通話驗證手機號碼的備用方式。
  • 呼叫登出端點以進行登出

修改項目

  • 已新增額外記錄
  • 已更新重新傳送短訊流程的用戶體驗
  • 改善小螢幕的使用體驗
  • LoginType 不再需要包含在 SkinManager 和 AdvancedUiManager 中
  • 改善 UX 中披露文字的顯示方式
  • 使用面板時不需要 AppLoginTheme
  • 已升級為 v1.2 版 Account Kit Graph 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 Media Player 記憶體流失問題

Account Kit

無變更。

4.20.0 - 2017 年 3 月 1 日

Facebook SDK

修改項目

  • 更新及本地化 SmartLogin 對話框。
  • 現在系統將會立即傳送推送憑證。請參閱文件以了解詳情。

Audience Network

新增項目

  • 已新增不同的成效及穩定性優化功能。

修改項目

  • Android Manifest 不再需要 AudienceNetworkActivity。

修正項目

  • 已修正原生廣告輪播子項無法觸發 onAdClickedListener 的問題。
  • 已修正原生廣告輪播點擊在模擬器中故障的問題。

Account Kit

新增項目

  • 已加入 4 種新的本地化語言。
  • 推出經典、當代及半透明介面，可輕易自訂用戶介面。

修改項目

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

修正項目

  • 已修正多個錯誤。

4.19.0 - 2017 年 1 月 25 日

Facebook SDK

修改項目

  • 應用程式啟動時，Facebook SDK 現在會自動初始化。在大部分的情況下無需再手動呼叫 FacebookSDK.sdkInitialize()。請參閱升級指南以了解詳情。
  • 初始化 SDK 時，系統現在會呼叫已啟用的應用程式。若要停用此功能，請按照升級指南中的指示操作。
  • 已更新 LoginButton 的外觀及風格。請參閱升級指南以了解詳情。

修正項目

  • ActivityLifecycleTracker 可能出現的記憶體流失問題

Audience Network SDK

新增項目

  • 已新增前台／後台接聽程式至 MediaView。

修正項目

  • 已修正 Android API < 18 的 NativeAdsManager 故障問題。
  • 影片播放結束後，MediaViewListener 內的 onComplete 方法現可被正常呼叫。
  • 已修正不受支援的通訊協定而導致啟動應用程式內瀏覽器所產生的故障問題。

Account Kit SDK

修改項目

  • 應用程式啟動時，Account Kit SDK 現在會自動初始化。在大部分的情況下無需再手動呼叫 AccountKit.initialize()。請參閱升級指南以了解詳情。
  • Account Kit 即時驗證按鈕已預設為「繼續」

修正項目

  • 已修正檔案被標記為 WORLD_ 時， Android 7+ 就會擲出異常的故障問題
  • 已修正入口畫面的後退鍵主題化問題
  • 將焦點放在確認代碼入口畫面的第一個輸入欄位
  • 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／FireTV 應用程式新增「智能登入」。請參閱網誌文章以了解詳情。無需更改 API 即可使用這個新功能。

修改項目

  • 已更新 Android 支援資料庫

修正項目

  • 已修正開放式圖表分享內容標註用戶的問題。

Audience Network

修正項目

  • 已修正 SQLiteDatabaseLockedException

Account Kit

新增項目

  • 電話號碼登入的即時驗證

修改項目

  • 已改善錯誤代碼回報
  • 已更新使用 1.1 Account Kit Graph 端點
  • 已更新記錄的連線階段
  • 已移除取消的呼叫

4.16.1 - 2016 年 10 月 7 日

Facebook SDK

修改項目

Audience Network

修正項目

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

4.16.0 - 2016 年 9 月 27 日

Facebook SDK

新增項目

  • 已新增 FacebookSdk.setGraphApiVersion 讓不同版本的 Graph API 能夠使用全域設定

修正項目

  • PR-483 已修正潛在 DeadObjectExceptions 問題
  • PR-483 已修正潛在 DeadObjectExceptions 問題
  • 改善網頁對話框動畫處理

Audience Network

新增項目

  • 應用程式內瀏覽器可於 WebView 開啟連結廣告
  • InstreamVideoAdView 類別，以支援串流廣告版位

修改項目

  • 影片快取限制更新為 64mb 以便預取
  • MediaView 停用 setAutoplay 及 setAutoplayOnMobile

修正項目

  • 修正 MediaView 參考資料中 LocalBroadcastReceiver 導致的記憶體流失問題
  • 修正如果 WebView 在 Cookie 同步的裝置上更新時發生的 NullPointerException 異常問題

Account Kit SDK

新增項目

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

修改項目

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

修正項目

  • 使用開發人員提供的國碼／區碼，而不是手機中的國碼／區碼
  • Lollipop 及更低階裝置中的矢量圖形
  • Lollipop 及更低階裝置中的鍵盤展示行為

4.15.0 - 2016 年 8 月 23 日

Facebook SDK

修改項目

  • PR-470 讓開發人員能夠在圖表要求的路徑元素中指定查詢參數
  • 與應用程式及遊戲群組關聯的類別與方法都已經停用
  • 已修改裝置登入用戶介面來使用 Roboto 字體

修正項目

  • 改善 Facebook 登入的 Chrome 自訂分頁處理作業
  • 改善發生硬碟受損時，應用程式事件持續性的處理作業
  • 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

修正項目

  • 已修正當活動顯示於鍵盤鎖上方時出現的瀏覽次數記錄問題

4.13.2 - 2016 年 7 月 1 日

Facebook SDK

修正項目

  • 修正航班應用程式中切換活動時造成事件遺失的問題

Account Kit SDK

修正項目

  • 登入期間的 NPE

4.13.1 - 2016 年 6 月 17 日

Facebook SDK

修正項目

  • 修正 AppEventsLogger Null Pointer 異常問題

4.13.0 - 2016 年 6 月 15 日

Facebook SDK

修改項目

  • 讓 Chrome 自訂分頁可以在 Chrome 測試版與開發版中開啟
  • 讓 Chrome 自訂分頁存取憑證可用於 Web View 對話框
  • 使用 AppEventsLogger 明確地記錄 activateApp 中的安裝次數

修正項目

  • 修正應用程式事件記錄器活動洩漏問題
  • 修正 AppEventsLogger 中可能發生的死結問題
  • 修正翻譯中的 %@
  • 修正 unmarshalling: 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

修正項目

  • 當讀取 HttpURLConnection 上的 responseCode 時，在較舊的 Android 裝置上處理 NoSuchAlgorithmException

Audience Network

修改項目

  • 因應 Google Play 的警告，已移除 X509TrustManager 的使用

修正項目

  • 已修正 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。

修正項目

  • 已修正沒有安裝 Facebook 應用程式時，ShareDialog 就無法分享引文的問題。
  • 已修正特定情況下，將應用程式事件串列化至磁碟時，Proguard 脫除編序資訊而造成異常的問題。
  • 已修正損壞的應用程式事件快取檔案無法遭清理的問題
  • 已修正當應用程式於完成分享或登入程序後啟動，然後在登入或分享期間被終止的潛在故障問題。
  • 已修正部分魅族裝置上的安全性與 NPE

Audience Network

修正項目

  • 已修正因無效的子計數造成的 RecyclerView 故障
  • 已修正無法呼叫 MPA 子 adListeners 的問題

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。

修改項目

  • 已更新使用 Graph API v2.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 整合。
    • 新裝置授權登入行為。
    • 登入、傳送、分享及讚好按鈕現在都可以鍵盤或遠端輸入裝置配搭使用。

修改項目

  • 現在裝置的當地語言可與所有圖像要求一同傳送。這樣 Graph 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

修正項目

  • 在未附加至片段的「傳送／分享」按鈕上設定分享內容時發生 NPE。

Audience Network

無變更

4.8.0 - 2015 年 11 月 11 日

Facebook SDK

新增項目

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

修正項目

  • 已修正發生異常時連線可能洩漏的問題

修改項目

  • 設定主題操作現在會套用至所有網頁檢視，而不只是「登入」網頁檢視（PR 448）
  • 已更新 Scrumptious 應用程式，從而與原生片段而非支援片段相容

Audience Network

修正項目

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

修改項目

  • Apache HTTP 已替換為第三方 AndroidHttpClient

4.7.0 - 2015 年 10 月 7 日

Facebook SDK

修正項目

  • 建立含 Null 動作類型的 GameRequestContent 時可能出現 NPE（PR 445）

修改項目

  • 已移至 Graph 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 物件。

修正項目

  • 已修正透過 Reflection 取得識別碼的問題。（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 對話框時發生 NPE。
  • 已修正當用戶裝置上沒有 Facebook 應用程式或瀏覽器時的應用程式故障問題。
  • 已修正 AndroidManifest.xml 中應用程式編號的整數溢位問題（PR-435）

Audience Network

新增項目

  • 已新增 MediaView 的原生影片支援

修改項目

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

修正項目

  • WebView 現在使用 ApplicationContext 以避免記憶體流失。
  • 已修正舊版 Android 中 View.getLocationOnScreen 的 NPE

4.4.1 - 2015 年 7 月 13 日

Audience Network

修正項目

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

4.4.0 - 2015 年 7 月 8 日

Facebook SDK

新增項目

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

修改項目

  • 已更新預設 Graph API 為 2.4 版。開發人員現在必須在所有的 Graph 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，會發生 NPE。(PR 430)

Audience Network

修正項目

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

4.2.0 - 2015 年 5 月 28 日

Facebook SDK

新增項目

  • 已在 ShareApi 新增圖表節點，並在相片／ 影片新增參數
  • 已新增有關 Gradle 2.4 的支援
  • 已新增翻譯
  • Iconicus 應用程式連結範例
  • 能夠指定「登入」網頁對話框所用的主題。
  • 可存取裝置的非獨特資訊，並隨應用程式事件傳送，以改善 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 時出現 NPE 異常問題。
  • 模糊處理原生廣告範本的圖像時捕捉 OutOfMemoryError。
  • 模糊處理原生廣告範本的圖像時捕捉所有錯誤。
  • 模糊處理原生廣告範本的圖像時使用較少記憶體。

4.1.0 - 2015 年 4 月 30 日

Facebook SDK

新增項目

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

修正項目

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

此版本有重大變更。如需詳細資訊，請參閱升級指南。從 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 上的 Executor 能夠擷取。
  • 已更新 LoginButton NUX 設定，讓 FacebookSdk 上的 Executor 能夠擷取。
  • 已更新「登入」按鈕，以便正確測量大小。
  • 已修正透過 ShareApi 上載影片。
  • GingerBread 裝置一律會停用與頁面編號相關的 LikeView。

4.0 - 2015 年 3 月 25 日

Facebook Android SDK v4.0 版是一個重大升級版本，當中包括下列項目：

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

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

Facebook SDK

新增項目

登入：

分享：

  • ShareApi 類別可協助用戶透過 Graph API 分享內容。

對話框：

  • 增強型對話框類別—已新增至「應用程式邀請」、「應用程式群組建立」、「應用程式群組加入」、「遊戲邀請」、「訊息」及「分享」。每個 *Dialog 類別都有相關的 *Content 類別和 Builder，以便您輕鬆設定參數。

修改項目

  • 已停用—系統已移除 3.x 中所有標記為 @deprecated 的類別或方法。某些特定功能類別已被移至各自的套件中，例如 com.facebook.login 和 com.facebook.share。

  • Graph 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 取代。

錯誤處理