變更記錄

    Facebook iOS SDK 變更記錄

    Facebook iOS SDK 的變更記錄和版本說明。

    5.0.0 及更新版本

    有關 5.0.0 及更新版本的變更記錄，請查看 GitHub 上的 facebook/facebook-objc-sdkCHANGELOG.md。

    4.44.0 - 2019 年 4 月 5 日

    2019 年 4 月 2 日 | 完整變更記錄

    新增項目

    • 為應用程式事件新增參數 _inBackground

    修復項目

    • 各種錯誤修復

    4.40.0 - 2019 年 1 月 22 日

    Facebook SDK

    新增項目

    修訂項目

    修復項目

    • 各種錯誤修復

    4.39.1 - 2019 年 1 月 15 日

    Facebook SDK

    新增項目

    修訂項目

    修復項目

    • 各種錯誤修復

    4.39.0 - 2018 年 12 月 5 日

    Facebook SDK

    新增項目

    修訂項目

    • 應用程式內購買自動記錄功能已預設為開啟。所有 iOS 自動記錄購買事件均會自動驗證。

    修復項目

    • 各種錯誤修復

    4.38.0 - 2018 年 10 月 23 日

    Facebook SDK

    新增項目

    修訂項目

    修復項目

    • 解決 Xcode 10／iOS 12 的 Bitcode 故障
    • 各種錯誤修復

    4.37.0 - 2018 年 9 月 27 日

    Facebook SDK

    新增項目

    修訂項目

    修復項目

    • 各種錯誤修復

    4.36.0 - 2018 年 8 月 30 日

    Facebook SDK

    新增項目

    • 新的應用程式內購買自動記錄進階配對功能，適用於應用程式事件解除安裝追蹤新標準事件

    修訂項目

    修復項目

    • 各種錯誤修復

    4.35.0 - 2018 年 7 月 26 日

    Facebook SDK

    新增項目

    • 開放存取 Graph API 3.1 版
    • 新增 [FBSDKAppEvents clearUserID];

    修訂項目

    修復項目

    • 各種錯誤修復。

    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 版
    • 新增 FBSDKACCESSTOKEN CURRENTACCESSTOKENISACTIVE 便利方法

    修訂項目

    修復項目

    • 更妥善處理失效登入事件
    • 各種錯誤修復

    4.32.0 - 2018 年 4 月 11 日

    Facebook SDK

    新增項目

    修訂項目

    • 新增支援，為 getCurrentLocation 呼叫提供自訂位置。

    修復項目

    • 修復有關完成區塊的當機情況。
    • 修復藍牙警示問題。

    Account Kit SDK

    新增項目

    修訂項目

    修復項目

    4.31.1 - 2018 年 3 月 5 日

    Facebook SDK

    新增項目

    修訂項目

    修復項目

    • 修復批次要求 POST 參數的錯誤

    4.31.0 - 2018 年 2 月 28 日

    Facebook SDK

    新增項目

    修訂項目

    修復項目

    Account Kit SDK

    新增項目

    修訂項目

    修復項目

    4.30.0 - 2018 年 1 月 24 日

    Facebook SDK

    新增項目

    修訂項目

    修復項目

    • 小幅修復 Messenger 分享功能
    • 修復在驗證連線階段中間鎖定裝置的問題

    Account Kit SDK

    新增項目

    • 升級為 AccountKit Graph API 版本 1.3

    修訂項目

    • 移除偏好設定 API

    修復項目

    4.29.0 - 2017 年 12 月 5 日

    Facebook SDK

    新增項目

    修復項目

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

    4.28.0 - 2017 年 11 月 7 日

    Facebook SDK

    修訂項目

    • 停用「應用程式邀請」功能。
    • 停用「原生讚好按鈕」。
    • 捕捉隱含購買交易記錄中的收據資料。

    4.27.0 - 2017 年 9 月 26 日

    Facebook SDK

    新增項目

    • 對 Xcode 9 的支援

    修復項目

    • iOS 11 錯誤修復

    4.26.0 - 2017 年 8 月 24 日

    Facebook SDK

    新增項目

    • 裝置登入和分享的 QR Code

    修復項目

    • 緩和 UIApplication 中的 keyWindow 為 nil 時 SafariViewController 不顯示的問題

    4.25.0 - 2017 年 7 月 26 日

    Facebook SDK

    修復項目

    • 修復 Carthage 整合工具

    Audience Network

    修訂項目

    • 記錄分派自統一記錄的事件類型（之前主控台只會記錄編號）
    • 為插頁影片廣告新增對離線播放的支援
    • 提供額外支援，以便裝置在更改顯示方向後繼續顯示插頁廣告
    • 稍為重新設計 AdUnitsSample 專案（現在包含 Instream 範例）
    • 移除 InstreamAdSample 專案
    • 新增 FBMediaViewVideoRenderer 的播放屬性
    • 將 FBMediaViewVideoRenderer 時間長度屬性的預設值更改為 kCMTimeIndefinite

    修復項目

    • 記錄分派自統一記錄的事件類型（之前主控台只會記錄編號）
    • 為插頁影片廣告新增對離線播放的支援
    • 提供額外支援，以便裝置在更改顯示方向後繼續顯示插頁廣告
    • 稍為重新設計 AdUnitsSample 專案（現在包含 Instream 範例）
    • 移除 InstreamAdSample 專案

    4.24.0 - 2017 年 6 月 26 日

    Facebook SDK

    新增項目

    • 將「使用 Facebook 帳戶繼續」按鈕本地化

    修復項目

    • FBSDKSharingDialog canShow 會在有設定時驗證內容

    Audience Network

    新增項目

    • 在 FBNativeAd 新增其他 AdChoices 屬性
    • 在 FBAdSettings 新增 backgroundVideoPlaybackAllowed 屬性

    修訂項目

    • 改善 FBRewardedVideoAd 版面

    修復項目

    • 修復 FBMediaView 中偶爾出現的除錯警告

    4.23.0 - 2017 年 5 月 25 日

    Facebook SDK

    修復項目

    • 修復 iOS 8／9 的 PlacesKit 範例應用程式當機問題

    Audience Network

    新增項目

    • 新增 FBMediaViewVideoRenderer 以自訂原生影片廣告
    • 由於與舊版 Xcode 版本編譯存在相容性問題，還原了使用 LTO 建構的資料庫
    • 除錯輸出格式改為只有分行表格，以減小 SDK 大小
    • 新增動態資料庫組建（FBAudienceNetworkDynamicFramework）

    修訂項目

    • 簡化 FBAdChoicesView 的公開介面

    修復項目

    • 更新影片播放器資料庫至最新穩定版本
    • 修復原生影片廣告的競爭條件問題（空白畫面錯誤）

    Account Kit

    新增項目

    • 在手機登入的國碼／區碼選擇器中新增國旗／區旗

    修訂項目

    • 改善本地化
    • 改善無障礙輔助控制選項

    修復項目

    • 修復按鈕消失和標籤錯誤的用戶介面問題

    4.22.1 - 2017 年 5 月 12 日

    Account Kit

    修復項目

    • 修復 App Store 審查過程中的不支援語言問題。

    4.22.0 - 2017 年 4 年 18 日

    Facebook SDK

    新增項目

    修訂項目

    • 更新為使用 Graph API v2.9 版。
    • 停用 FBSDKShareLinkContent 的 title、description、caption 和 image 欄位。請執行適當的動作以移除這些項目。

    Audience Network

    修復項目

    • 修復在 FBMediaView 中未有呈現圖像廣告內容的重大錯誤
    • 修復 Xcode 8.3 模組對應組建錯誤

    Account Kit

    新增項目

    • 透過語音通話驗證手機號碼的備用方式
    • 另加兩種面板：現代與半透明
    • 呼叫登出端點以登出帳戶

    修訂項目

    • 新增額外記錄功能
    • 更新重新傳送短訊流程的用戶體驗
    • 改善小螢幕的使用體驗
    • 改善用戶體驗中披露文字的顯示方式
    • 在標題中顯示錯誤訊息，而不是在 actionBar 中顯示

    修復項目

    • 改善右至左語言（阿拉伯文和希伯來文）的支援
    • 修復 iOS 8 和 iOS 9 的用戶體驗
    • 改善無障礙輔助的識別碼

    4.21.0 - 2017 年 4 年 5 日

    Audience Network

    新增項目

    • 重新設計插頁廣告，並為成效型廣告和品牌影片廣告新增影片自動播放功能。
    • 新增對 iOS 應用程式擴充功能的支援，以在鍵盤應用程式中顯示廣告。

    修復項目

    • 修復播放影片廣告時的一些記憶體流失問題。

    4.20.2 - 2017 年 3 月 16 日

    Account Kit

    修復項目

    • 修復 i385 和 x86_64 缺少架構的問題。

    4.20.1 - 2017 年 3 月 10 日

    Account Kit

    修復項目

    • 修復 App Store 審查過程中的不支援語言問題。

    4.20.0 - 2017 年 3 月 1 日

    Facebook SDK

    修訂項目

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

    Account Kit

    新增項目

    • 經典面板選項。

    修復項目

    • 修復「重新傳送短訊」按鈕上的計時器。

    修訂項目

    • 未選擇主題時的預設用戶介面現會是經典面板，而不是舊的預設外觀。
    • 微調視覺設計。

    Audience Network

    修復項目

    • 將 iOS SDK 靜態資料庫大小減少至 55 MB。
    • 改善 SDK 品質和效能。

    4.19.0 - 2017 年 1 月 25 日

    Facebook SDK

    修訂項目

    • 現於 SDK 初始化期間呼叫 [FBSDKAppEvents activateApp]。無需在程式碼中呼叫 activateApp
    • 更新 FBSDKLoginButton 的外觀和風格。請參閱升級指南以了解詳情

    Account Kit

    新增項目

    • 記錄國碼／區碼

    修復項目

    • 允許在國碼／區碼選擇器中使用 Account Kit 進階用戶介面主題
    • 確保小型裝置上能看到「下一步」按鈕

    Audience Network

    新增項目

    • 為 FBMediaView 新增 aspectRatio 屬性，為想要因應檢視畫面內容尺寸調整應用程式版面的發佈商提供提示。這將允許發佈商執行一些操作，例如調整動態消息中廣告單元的高度，或為縱向影片廣告顯示專門版面。長闊比例為闊度除以高度大於或等於 0.0。
    • 新增 applyNaturalWidth 和 applyNaturalHeight，以便根據 aspectRatio 屬性來按目前 FBMediaView 的尺寸更改闊度或高度。請查看原生廣告開發人員文件，以進一步了解如何使用這些新 API。
    • 在 FBAdSetting 中新增 setMediaViewRenderingMethod，用於配置 FBMediaView 的呈現方法。可用的呈現方法有 FBMediaViewRenderingMethodDefault、FBMediaViewRenderingMethodMetal、FBMediaViewRenderingMethodOpenGL 和 FBMediaViewRenderingMethodSoftware。

    修復項目

    • 修復完整性檢查的效能和穩定性問題。
    • 改善影片廣告的影片播放穩定性。
    • 切換 iPhone 5 裝置上 OpenGL 模糊影像呈現程序的軟件遞補，以防止當機。
    • 修復點擊橫額／插頁廣告連結時偶爾出現的白畫面錯誤。
    • 修復 FBInstreamAdViewDelegate 的 adViewDidClick 回呼方法未被呼叫的錯誤。
    • 修復先前版本中收到報告的一些記憶體流失和當機問題。

    4.18.0 - 2016 年 11 月 30 日

    Facebook SDK

    修復項目

    • 改善連線欠佳時的設定擷取功能
    • 更新記錄事件命名

    Account Kit

    修復項目

    • 修復所有輸入畫面上的鍵盤行為

    4.17.0 - 2016 年 10 月 26 日

    Facebook SDK

    新增項目

    • 在 FBSDKAppEvents 新增 setUserID: 及 updateUserProperties:。請瀏覽此處以了解詳情。
    • 在 iOS 10 的 FBSDKApplicationDelegate 中新增 application:openURL:options:。

    修復項目

    • 修復在 FBSDKLoginManager 回呼中無分派情況下呈現用戶介面的潛在問題。
    • 修復 FBSDKLoginManager 過早解除配置的錯誤。
    • 修復舊版本 Xcode 的組建。PR 845

    Audience Network

    修復項目

    • 修復中長方形廣告的版面限制
    • 修復原生廣告範本中缺少選擇器的當機問題

    Account Kit

    修訂項目

    • 更新連線階段記錄功能
    • 移除取消回呼
    • 更新為使用 1.1 Account Kit Graph 端點

    4.16.1 - 2016 年 10 月 10 日

    Facebook SDK

    修訂項目

    • 更新為使用 Graph API 2.8

    Audience Network

    修復項目

    • 修復未在 FBNativeAdDelegate 上呼叫 nativeAdDidClick: 的問題
    • 移除導致 App Store 拒絕的 UIImagePickerController 引用

    4.16.0 - 2016 年 9 月 27 日

    Facebook SDK

    新增項目

    • 新增 FBSDKSettings setGraphAPIVersion: 以允許全域設定不同的 Graph API 版本。

    Audience Network

    新增項目

    • 新增 FBInstreamAdView 以支援插播廣告版位

    修訂項目

    • 在 FBMediaView 上停用 autoplayEnabled 設定器，改用伺服器端控制選項
    • 改善展示／點擊可靠度
    • 更新 FnF 影片播放器資料庫以提高可靠度和效能

    修復項目

    • 移除 FnF 影片播放器資料庫中對 PHAsset 的無意參照，以免導致 App Store 靜態分析失敗

    Account Kit SDK

    修訂項目

    • 改善重新傳送流程，更清楚地說明用戶會在何時收到新的確認短訊

    修復項目

    • 改善小螢幕裝置的版面（iPhone 4s、iPhone 5）

    4.15.1 - 2016 年 9 月 9 日

    Facebook SDK

    • 針對 Xcode 8 GM 和 iOS 10 更新。
    • 停用 FBSDKAppEventsUtility fetchDeferredAppInvite:。

    4.15.0 - 2016 年 8 月 26 日

    Facebook SDK

    停用項目

    • 停用 FBSDKAppGroupAddDialog 和 FBSDKAddGroupJoinDialog 介面。

    修訂項目

    • 由 NSURLConnection 開始，SDK 現使用 NSURLSession 而非 NSURLConnection 來發出 Graph API 要求。

    修復項目

    • PR 836：傳遞正確的網頁檢視登入參數
    • 修復透過 FBSDKLoginButton 登出時 iPad 上的當機問題。
    • 修復使用 Cocoapods 時的本地化問題
    • 透過 FBSDKShareAPI 分享相片時會傳回個別相片編號；SDK 先前是會傳回相簿帖子編號。

    Audience Network

    新增項目

    • 改善除錯資訊的可視度

    修訂項目

    • 更改應用程式商店 SKStoreProductViewController 以允許除倒置之外的所有方向
    • 從 SDK 移除未使用的元件
    • 清理與優化 FBAdEnvironmentData

    修復項目

    • 進一步修復導致 FNF／AVFoundation 混合物件當機情況的 FBAdConfigManager 計時問題
    • 處理不良用戶代理程式的其他錯誤情況
    • 修復由於在兩個不同位置檢查方向，而導致插頁廣告以不正確的方向呈現的問題
    • 減少有效情況下 FBAdConfigManager 的錯誤記錄
    • 修復用戶端事件記錄功能的當機問題

    Account Kit SDK

    修復項目

    • 確保在用戶按下 Cancel 時呼叫 viewControllerDidCancel 委派方法
    • 修復 iOS 10 呈現問題

    v4.14.0 - 2016 年 7 月 13 日

    Facebook SDK

    修訂項目

    • 更新為使用 Graph API 2.7 版
    • 就 FBSDKCoreKit、FBSDKLoginKit、FBSDKShareKit 新增動態框架目標和 Carthage 支援。

    修復項目

    • 將已停用的 UIActionSheet 換為 UIAlertController
    • 修復所有權限撤銷後個人資料相片為空的問題

    Audience Network

    新增項目

    • 改善 SKStoreProductViewController，提供更可靠的負載和自動逾時功能

    修復項目

    • 改善大小和效能
    • 修復 FBAdConfig 的計時問題，以免一起使用 AVFoundation 和 FNF* 物件，進而造成「未知選擇器」當機問題
    • 從模組對應移除 "objc_arc" 標示

    AccountKit

    修復項目

    • 更新 viewControllerForLoginResume 的方法簽名

    v4.13.1 - 2016 年 6 月 16 日

    Audience Network

    修復項目

    • 改善效能和大小
    • 移除不適用於發佈版本組建的內部除錯實用工具（FBAdThreadWatchdog）

    v4.13.0 - 2016 年 6 月 15 日

    Audience Network

    修復項目

    • 修復影片資料庫中所使用的衝突性選擇器（dataAvailable）
    • 修復影片資料庫中的死結
    • 修復 FBAdConfigManager 執行緒問題導致的罕見當機情況
    • 優化與提升效能

    v4.12.0 - 2016 年 5 月 19 日

    Facebook SDK

    新增項目

    • 新增 [FBSDKShareAPI.accessToken] 以允許更改用於共用的存取憑證（提取要求 826）

    修訂項目

    • 初始登入現在能夠傳送「重新要求」標示，因此先前遭到拒絕的權限能夠出現在登入對話框中

    修復項目

    • 修復 AppEvents 由於缺少連線階段編號而可能當機的情況。
    • 修復某些情況下存取憑證到期日期為重新整理日期的錯誤。

    Audience Network

    新增項目

    • 使用與 Facebook 應用程式相同的技術，為 FBMediaView 加入新的高效能影片播放器，不再有用戶介面停頓
    • 為 FBMediaView 加入高效能且基於 Metal 的全新模糊影像呈現器，並以 OpenGL 作為遞補
    • 加入新的相依項目：libxml2 和 C++ 執行階段

    修訂項目

    • 改善檢視控制器錯誤偵測

    修復項目

    • 停用自動播放功能時，FBMediaView 會顯示封面圖像，而非影片首個影格
    • FBMediaView 現會為不同長闊比例的輪播圖像加入模糊效果（如有必要）
    • FBMediaView 會按照輪播影像的媒體快取標示運作
    • 修復 FBNativeAdsCachePolicyAll 媒體快取標示
    • 修復 iOS 7 裝置上旋轉為橫向畫面時影片停止的問題
    • 修復影片結束後無法重新開始的問題

    AccountKit

    新增項目

    • 新增 AccountKit 的 Cocoapods 支援
    • 新增為 headerButtonTitleColor 設定主題的功能。
    • 新增在主題中指定自訂內容邊界的功能
    • 新增使用進階用戶介面自訂功能時自訂文字位置的功能
    • 新增使用進階用戶介面自訂功能時取消登入的功能

    修復項目

    • 修復國碼／區碼清單中已設定風格的標題之呈現
    • 修復已設定風格的電郵輸入欄位之呈現
    • 修復進階用戶介面主題設定的錯誤，即在電郵驗證畫面報告錯誤步驟的問題

    v4.11.0 - 2016 年 4 月 12 日

    Facebook SDK

    新增項目

    • 新增 -[FBSDKAppEvents logPushNotification*] 和 -[FBSDKAppEvents setPushNotificationsDeviceToken:]。詳情請參閱推送宣傳活動文件。
    • 新增 -[FBSDKAppLinkUtility fetchDeferredAppInvite:] 以支援 iOS 上的延遲應用程式邀請應用程式連結，並新增 FBSDKAppInviteContent.promotionCode 和 FBSDKAppInviteContent.promotionText 以方便在邀請中加入推廣活動代碼。詳情請參閱應用程式邀請文件。
    • 新增 -[FBSDKProfile loadCurrentProfileWithCompletion:]
    • 新增 FBSDKHashTag 和 FBSDKShareMediaContent 以支援分享雜湊標籤和混合內容，例如相片和影片。詳情請參閱分享功能文件。
    • 新增 FBSDKShareLinkContent.quote 以支援連結引文分享功能。
    • 新增 FBSDKShareVideo.previewPhoto 以提供代表影片的相片。

    修訂項目

    • 更新為使用 Graph API v2.6。
    • 改善 FBSDKAppEvents 的連線階段追蹤準確度，包括用於識別連線階段逾時門檻的可配置值，其位於應用程式的 Facebook 分析工具設定。
    • 如果應用程式的 plist 中配置了不正確的方案，SDK 會引發例外狀況。
    • 更新 xctool 和 Bolts（v1.7）子模組。

    修復項目

    • 修復對 Cocoapods 0.39 和 1.0.0-beta6 的支援
    • 修復 FBSDKAppEventsDeviceInfo 中靜態變數的範圍被錯誤地設為全域範圍的問題。

    Audience Network

    新增項目

    • 新增原生廣告的影片預先快取功能

    修訂項目

    • 將全螢幕影片播放器變更為從內嵌播放器的目前時間開始，而非從頭開始

    修復項目

    • 修復 iOS 7 插頁廣告呈現方向錯誤的問題

    AccountKit

    FBNotifications

    v4.10.1 - 2016 年 3 月 16 日

    Facebook SDK

    • 修復某些受影響情況下應用程式事件的時區準確度。

    Audience Network

    • 改善 Xcode 7.3-beta 相容性
    • 將功能配置載入程序移至 SDK 的首次呼叫
    • 改為在除錯級別而非錯誤級別記錄功能配置載入程序
    • 修復關閉 AdChoices 檢視畫面時發生的當機情況
    • 停用模組支援以修復過多連結器警告

    v4.10.0 - 2016 年 2 月 10 日

    Facebook SDK

    修訂項目

    • 將 Bolts 子模組更新至 1.6。
    • 不再需要 Facebook 伺服器的應用程式傳輸安全允許清單。

    修復項目

    • 修復 FBSDKWebDialog 的呈現問題（修復邊界對齊功能）。
    • 修復 Graph 要求上覆寫明確「locale」參數的錯誤。
    • 從 FBSDKLoginKit 移除開發團隊編號（GitHub 提取要求 #813：@IgorOvechko）。

    Audience Network

    新增項目

    • 在 FBMediaView 新增輪播廣告支援。

    修復項目

    • 修復 SFSafariViewController 不分派已取消事件的問題。
    • 修復 FBNativeAdTableViewCellProvider 原生廣告註冊問題。
    • 修復 FBAdURLSession 中罕見的當機問題。
    • 修復從 C 字串到 NSString 轉換的記憶體流失問題。
    • 修復網絡可達性中的記憶體流失問題。
    • 修復圖像網址無效時 FBAdCache 中的記憶體流失問題。
    • 修復 iOS 7 中使用 [NSString containsString:] 所導致的當機問題。

    v4.9.1 - 2016 年 1 月 16 日

    修復項目

    • 修復所有框架的 Bitcode 支援。

    v4.9.0 - 2016 年 1 月 13 日

    Facebook SDK

    新增項目

    • 新增 FBSDKCatalog 範例應用程式。
    • 新增用於建立 tvOS 應用程式的 FBSDKTVOSKit.framework。詳情請參閱我們的 tvOS 指南。

    修訂項目

    • 將 Bolts 子模組更新為 1.5，以及將 OHHTTPStubs 子模組更新為 4.6。

    修復項目

    • 修復 FBSDKLikeControl 社交語句以配合地區設定。
    • 修復 FBSDKAppEvents 中在某些情況下不傳送歸因的錯誤。
    • 修復 FBSDKLoginButton 委派對象以僅在按鈕登入事件時接收 loginButtonWillLogin:。
    • 修復從背景執行緒傳送 activateApp 時，FBSDKAppEvents 不傳送事件的錯誤。
    • 修復 README 文件（GitHub 提取要求 #810：@orta）。
    • 修復將無索取新權限的要求視為取消的登入錯誤。
    • 修復 FBSDKLoginButton 關於預設高度的 headerdoc 註解（GitHub 提取要求 #804：@revolter）。
    • 修復 FacebookSDKStrings.bundle 中缺少希伯來文本地化的問題
    • 修復對 Cocoapods-1.0.0-beta2 的支援
    • 修復 Xcode 7.2 的 ENABLE_BITCODE 標示

    Audience Network

    修訂項目

    • 移除 StoreKit 依賴項目。
    • 更新網絡連線以使用 NSURLSession。
    • 改善 AVPlayer/AVPlayerItem 效能，略為提升影片滾動效能

    修復項目

    • 修復 CGColorGetComponents 的堆積溢位錯誤
    • 修復計時器引起的罕見當機問題
    • 修復 iPad 裝置上狀態列可視度變更問題
    • 修復表格檢視模式下原生廣告範本上的手勢辨識工具被移除的問題
    • 修復主執行緒上用戶介面存取導致的當機情況
    • 修復插頁或橫額廣告吞沒 WKWebView 呈現錯誤的問題
    • 修復由不需要的模組除錯資訊所引起的連結工具警告問題
    • 修復 FBNativeAdView 在單獨使用時從不載入內容的問題

    v4.8.0 - 2015 年 11 月 11 日

    Facebook SDK

    新增項目

    • FBSDKShareAPI 現可分享以檔案網址初始化的 FBSDKShareVideo 內容。

    修訂項目

    • 將 OHHTTPStubs 更新至 3.1.12。
    • 將一些內部標題重新編排為「專案」而非「私人」範圍。

    修復項目

    • 修復 sharePhotoContent 無法在 FBSDKShareAPI 中設定 peopleIds 的問題。
    • 修復 shareVideoContent 以拒絕在 FBSDKShareAPI 中設定 peopleIds 和 placeId（Graph API 影片端點不支援）。

    Audience Network

    修訂項目

    • 改善 FBMediaView 效能：如果媒體檢視畫面已經達到或接近封面圖像的理想 1.9:1 比例，則完全跳過將影像模糊化的程序。

    修復項目

    • 解決使用 WebKit 呈現插頁廣告時插頁廣告展示記錄中罕見的競爭條件；適用於 iOS 8 和 9 裝置。
    • 修復當出現多個 UIWindows 或其不在視窗層級 UIWindowLevelNormal 時擷取目前檢視控制器的問題。
    • 移除對 AVFoundation、CoreMedia 和 CoreMotion 的直接參照以解決連結工具錯誤，有關項目現會在執行階段延後載入。

    v4.7.1 - 2015 年 10 月 26 日

    Facebook SDK

    此版本無任何二進位變更。

    修復項目

    • 修復登入 podspec 的問題。

    v4.7.0 - 2015 年 10 月 7 日

    Facebook SDK

    停用項目

    • 停用 [FBSDKProfile imagePathForPictureMode]。改為新增 [FBSDKProfile imageURLForPictureMode]。

    新增項目

    • 新增 [+FBSDKRequestConnection setDefaultConnectionTimeout:] 以允許為所有要求設定預設逾時值。

    修訂項目

    • SDK 現應配搭 Graph API v2.5 使用。詳情請參閱 Graph API 變更記錄。
    • 傳送到 GameRequestDialog 委派對象的完成結果現在將包含「to」鍵，其 NSArray 值中載有接收者。
    • 將 Bolts 子模組更新至 1.3.0
    • 為 FBSDKAccessTokeninit 及 new 新增註釋 NS_UNAVAILABLE。

    修復項目

    • 修復 SDK 範例中 FBSDKApplicationDelegate application:didFinishLaunchingWithOptions: 的用法。
    • 修復在使用 FBSDKLoginBehaviorWeb 及取消登入時 FBSDKLoginManager 可能發生的 EXEC_BAD_ACCESS 問題。
    • 修復 FBSDKLoginBehavior 上的 headerdoc 註解。
    • 修復使用 CocoaPods 為 iOS 9 編譯時出現的已停用警告。
    • 修復 SFSafariViewController 在登入流程中未有旋轉的方向問題。

    MessengerShareKit

    • 修訂目前 Messenger 版本不支援分享功能時向用戶顯示的提醒訊息。

    Audience Network

    修復項目

    • 修復在某些裝置上顯示橫額廣告、插頁廣告或連結廣告時記憶體消耗過多的問題
    • 改善橫額和插頁廣告的效能
    • 修復 3x 裝置上的 FBMediaView 縮放模糊問題
    • 修復重新整理閾值錯誤處理問題

    v4.6.0 - 2015 年 9 月 10 日

    Facebook SDK

    停用項目

    • 停用 FBSDKLoginManager 和 FBSDKAppInviteDialog 上的多個方法，由採用 fromViewController 參數的新多載取以代之。這解決了 iOS 9 上可能出現的各種展示問題。

    新增項目

    • 此 SDK 支援各種 iOS 9 功能，包括 Bitcode。此外，「登入」、「讚好」、「分享」對話框等 SDK 對話框會根據裝置自動判斷最佳的用戶介面，包括 SFSafariViewController 而非 Safari。請按照我們的 iOS 9 準備指南操作。

    修訂項目

    • 更新子模組，包括 Bolts（1.2.2）。
    • 從框架架構移除 armv7s 切片。
    • 新增 [FBSDKLoginButtonDelegate loginButtonWillLogin:]。

    修復項目

    • 修復 FBSDKLoginButton 的所選風格。
    • 修復測試用戶沒有存取憑證時 FBSDKTestUsersManager 當機的問題。
    • 修復可能導致某些登入失敗並顯示錯誤代碼 308 的登入錯誤。
    • 從範例的框架搜尋路徑移除舊有安裝路徑。
    • 修復有指定 click_time 的應用程式連結處理延遲問題（GitHub 提取要求 #789：@kookiekrak）。
    • 修復處理錯誤復原時可能過早關閉登入對話框的錯誤。

    MessengerShareKit

    • 更新為支援 iOS 9，包括 Bitcode。
    • 停用 [FBSDKMessengerSharer messengerPlatformCapabilities]

    Audience Network

    • 更新為支援 iOS 9，包括 Bitcode。

    修復項目

    • 改善全螢幕影片檢視畫面的本地化
    • 改善 FBMediaView 的圖像效能

    v4.5.1 - 2015 年 8 月 13 日

    Facebook SDK

    修復項目

    • 修復使用 iOS 7 時可能導致當機的錯誤。

    v4.5.0 - 2015 年 8 月 10 日

    Facebook SDK

    修訂項目

    • SDK 現以 zip 壓縮檔而非安裝程式形式來分發。加入指令碼以便手動安裝 Xcode 文件集。
    • SDK 會執行一些額外記錄程序，為 iOS 9 做好準備。請查看我們的 iOS 9 準備指南。
    • 如果指定了 FBSDKShareDialogModeNative 而裝置上的 Facebook 應用程式不支援有關內容，FBSDKShareDialog 現在會自動嘗試執行 FBSDKShareDialogModeBrowser。
    • 更新子模組 OHHTTPStubs、OCMock、xctool。

    修復項目

    • 修復從多個執行緒記錄不同事件的 FBSDKAppEvents 時可能導致當機的錯誤。
    • 修復在網絡錯誤的情況下呼叫 requestConnectionDidFinishLoading 時 FBSDKGraphRequestConnection 中的錯誤。

    MessengerShareKit

    新增項目

    • 新增將 Messenger 中的靜態和動畫圖像呈現為貼圖的支援。

    修訂項目

    • 停用 [FBSDKMessengerSharer messengerPlatformCapabilities] 來為 iOS 9 做好準備。無需檢查哪個版本的 Messenger 適用，只需傳送內容，SDK 就會提醒用戶是否需要更新 Messenger。

    Audience Network

    新增項目

    • 新增 FBMediaView 影片支援。

    修復項目

    • 修復 iOS 7 裝置的插頁廣告方向問題。
    • 修復在背景使用 OpenGL 導致使用 FBMediaView 時當機的問題。

    v4.4.0 - 2015 年 7 月 7 日

    Facebook SDK

    修訂項目

    • SDK 現應配搭 Graph API v2.4 使用。請查看 Graph API 變更記錄以了解詳細資訊。例如，Graph 端點傳回的預設欄位數量有所減少，您應該一律具體詢問所需的欄位。
    • 將 Bolts 更新至 1.2。
    • 更新 FBSDKShareLinkContent 的標題文件以闡明參數用法。
    • 修訂 RPSSample，並就遊戲結果加入額外的 FBSDKAppEvents。
    • 移除 FBSDKAppGroupContent 中未使用的 groupID 屬性。

    修復項目

    • 修復使用「分享」對話框時在開放式圖表動態中標記人物或地點的錯誤。
    • 修復 FBSDKShareDialog 在分享之前未有驗證內容的錯誤。
    • 修復 RPSSample 以將委派對象分配給其「分享」對話框。

    v4.3.0 - 2015 年 6 月 25 日

    Facebook SDK

    新增項目

    • 在 FBSDKShareAPI 中新增 graphNode 屬性。

    修訂項目

    • 透過整合分享表格分享內容的動作現在可以獲得正確的應用程式歸因。

    修復項目

    • 修復透過 FBSDKLoginManager 回呼中的「分享」對話框分享相片等內容時發生的當機情況。
    • 修復在 iPad 彈出視窗中呈現 FBSDKLoginButton 時的堆疊溢位問題
    • 修復使用讚好控制選項時的 NSKeyedUnarchiver 主控台錯誤。
    • 修復 refreshCurrentAccessToken 中的錯誤，以防止 currentAccessToken == nil 時出現錯誤邏輯。
    • 修復使用初始大小尺寸為 0 的 FBSDKProfilePictureView 時出現的主控台錯誤。

    MessengerShareKit

    修復項目

    • 修復會將包含「&」或「；」符號的中繼資料被截斷的錯誤。

    Audience Network

    修訂項目

    • 改善影像擷取與原生廣告範本的效能

    v4.2.0 - 2015 年 5 月 28 日

    Facebook SDK

    新增項目

    • 新增可選的 FacebookSDKStrings.bundle，為國際應用程式提供本地化字串

    修訂項目

    • 更新 Xcode 6.3 的專案
    • FBSDKTestUsersManager 現可正確地分頁瀏覽測試用戶帳戶結果。
    • 停用 FBSDKAppInviteContent.previewImageURL、FBSDKGameRequestContent.to 和 FBSDKGameRequestContent.suggestions，以避免非公開選擇器驗證警告
    • 移除 FBSDKShareAPI.createObjectsWithClientToken
    • 改善 Facebook Analytics 報告
    • 改善 OAuth 登入流程的安全性
    • 修訂 RPS 範例應用程式：將玩家手勢圖像加入開放式圖表分享功能中
    • 修訂 Iconicus 範例應用程式：新增從應用程式連結剖析鎖定位置的功能

    修復項目

    • 修復 FBSDKTestUsersManager 的模組對應
    • 修復 iOS 7 上網頁檢視對話框的橫向方向
    • 修復錯誤地嘗試將錯誤復原程序套用於用戶端憑證要求的錯誤
    • 修復阻止開放式圖表動作使用 fb:explicitly_shared 的錯誤。

    FBSDKMessengerShareKit

    修復項目

    • 嘗試在擴充功能中使用 Messenger SDK 時編譯失敗
    • 為區分大小楷的檔案系統將 FBSDKMessengerUrlHandler.h 重新命名為 FBSDKMessengerURLHandler.h

    Audience Network

    修復項目

    • 修復針對 iOS 6 組建時編譯失敗的問題
    • 修復 FBAdView 必須明確設定其框架的問題
    • 修復 FBNativeAdsManager 中有時無效廣告被傳回為有效廣告的問題
    • 修復 FBNativeAdTableViewCellProvider 所建立的儲存格之選擇風格

    v4.1.0 - 2015 年 4 月 30 日

    Facebook SDK

    新增項目

    • 新增 [FBSDKAccessToken refreshCurrentAccessToken] 以重新整理目前憑證。
    • 新增 FBSDKTestUsersManager 以簡化與測試用戶一起編寫測試的程序。
    • 在 FBSDKSharePhoto 新增屬性 caption。
    • 在 FBSDKShareAPI 新增屬性 message。

    修訂項目

    • FBSDKShareAPI 現在將警告主控台中缺少「publish_actions」，而不是立即擲回例外情況。
    • 為支援 Cocoapods 0.36，Facebook-iOS-SDK podspec 已停用，改用 FBSDKCoreKit、FBSDKLoginKit、FBSDKShareKit 單獨的 podspec。
    • 如果缺少 FacebookAppID 或網址方案，SDK 將擲回例外情況。
    • 移除 FBSDKAppInviteContent initWithAppLinkURL:。使用標準 init 並設定 appLinkURL 屬性。

    修復項目

    • 修復阻止從應用程式委派生命週期事件呼叫登入的錯誤。
    • 修復阻止開放式圖表動作使用 fb:explicitly_shared 的錯誤。
    • 修復系統帳戶儲存登入中不會重新提示缺少權限的錯誤。
    • 修復分享 API 參數中處理 NSURL 和 NSNumber 時的錯誤。
    • 修復阻止 FBSDKGraphRequestConnection 的委派對象接收「requestConnectionDidFinishLoading:」訊息的錯誤。
    • 修復可能導致對話框在完成之前過早解除配置的錯誤。
    • 更新 Bolts 子模組參照，以修復嘗試配合 Swift 使用 SDK 時產生模組對應的問題。

    FBSDKMessengerShareKit

    • FBSDKMessengerShareKit 現已在 GitHub（位於 facebook-ios-sdk 存放庫的 FBSDKMessegerShareKit 資料夾中）和 Cocoapods 上（使用 pod 'FBSDKMessengerShareKit'）提供

    修復項目

    • 修復 Messenger 按鈕以採用清晰的背景顏色。

    修訂項目

    • 移除 FBSDKMessengerURLHandlerCancelShareContext.h。請改用 FBSDKMessengerURLHandlerCancelContext.h。

    Audience Network

    新增項目

    • FBNativeAdsManager：協助批量檢索廣告。
    • FBNativeAdView：提供可配置的原生廣告檢視畫面
    • FBNativeAdScrollView：提供水平捲動體驗，代管 FBNativeAdView 或自訂原生廣告檢視畫面。
    • 用於協助實現原生廣告的輔助檢視畫面：FBAdChoicesView、FBMediaView、FBAdStarRatingView。
    • 有助在 UITableView 中使用原生廣告的協助工具。

    修復項目

    • 各種錯誤修復

    v4.0.1 - 2015 年 4 月 2 日

    Facebook SDK

    新增項目

    • 新增對 clang 模組的支援和 @import 的使用
    • 在 Swift 中使用時不需要 Obj-C 橋接標題
    • 加入新的範例應用程式 Iconicus，用於示範代管的應用程式連結

    修復項目

    • 修復相片內容的分享表格驗證

    v4.0 - 2015 年 3 月 25 日

    Facebook iOS SDK 4.0 版為重大升級版本。請參閱將 iOS SDK 從 3.x 升級到 4.x 一文。

    • 與 v3.x 相比，所有類別都被重新命名或移除，此變更記錄將說明語意上新增和移除的內容。
    • 不再支援 iOS 6。Facebook iOS SDK v4.0 需要用到 iOS 7 或更高版本。

    新增項目

    • FBSDKCoreKit.framework：此框架提供通用 SDK 類別、應用程式事件 API 和 Graph API 要求
    • FBSDKProfile：用以擷取公開個人檔案資料的可靠方法。
    • FBSDKGraphErrorRecoveryProcessor：用以處理 Facebook 錯誤的錯誤復原嘗試作業。
    • FBSDKUtility：幫助剖析網址的實用工具類別。
    • FBSDKLoginKit.framework：提供登入功能的框架。需要使用 FBSDKCoreKit。
    • FBSDKLoginManager：基於區塊的授權 API。
    • FBSDKShareKit.framework：提供分享功能的框架。需要使用 FBSDKCoreKit。
    • FBSDKGameRequestDialog：用於建立遊戲要求的強型別對話框。
    • FBSDKAppInviteDialog：用於傳送應用程式邀請的強型別對話框。
    • FBSDKShareAPI：用於透過 Graph API 執行分享動作的強型別執行程序。
    • FBSDKShareButton／FBSDKSendButton／FBSDKLikeButton：適用於分享功能的一站式按鈕。
    • FBSDKMessengerSharerKit.framework：用於在 Messenger 平台上組建內容的框架

    修訂項目

    • 移除所有標記為 @deprecated 的類型。
    • 現有類型已重新命名為以 FBSDK 作為前綴，而非 FB，例如 FBAppEvents -> FBSDKAppEvents。
    • FB*Dialogs 和 FB*DialogsParams。使用 FBSDKShareKit.framework 中適當的強型別對話框和內容模型。
    • FBAppCall 一般會由 FBSDKApplicationDelegate 取代。請參閱入門指南。
    • 以 FBSDKGraphRequest* 取代 FBSDKRequest*，並自動提供錯誤復原功能和更簡單的錯誤分類系統。請參閱升級指南。
    • FBSession 和 FBAccessTokenData 由 FBSDKLoginManager 和 FBSDKAccessToken 取代。請參閱升級指南。

    移除項目

    • FBAppLinkData。使用 Bolts.framework 中的 BFURL。
    • FBGraphObject。配合 FBSDKShareKit.framework 中的 FBSDKShareAPI 使用適當的開放式圖表內容模型。
    • FB*ViewController 和 FBCacheDescriptor。沒有替代選項。手動建立表格檢視畫面並將 Graph API 結果分頁。
    • FBSDKTokenCachingStrategy。沒有替代選項。FBSDKLoginManager 會自動將憑證快取到鑰匙圈。您可以觀察憑證變化以手動進行後期處理；請參閱 [FBSDKAccessToken currentAccessToken]。