Android 版 Facebook SDK 的更新日志和版本说明。
有关 5.0.0 及更高版本的更新日志,请参阅 GitHub 上的 facebook/facebook-android-sdk/CHANGELOG.md。
已停用类:FacebookUninstallTracker
支持 Android Autofill(Android Oreo 中推出的一种新功能)
新增了 Messenger 分享 SDK 功能:博文
无更改。
无更改。
FBSDKShareLinkContent 的 title、description、caption 和 image 字段。请采取适当的措施移除对它们的使用。SkinManager 和 AdvancedUiManager 中必填的 LoginType 参数AppLoginTheme无更改。
无更改。
无更改。
无更改。
AudienceNetworkActivity。onAdClickedListener 的问题。FBInstreamAdView 中无法正确触发的问题FBAdChoicesView 可展开动画异常问题SQLiteDatabaseLockedExceptionCUSTOM_TAB 更改为 CHROME_CUSTOM_TABAppLinkData.ARGUMENTS_TAPTIME_KEYShareHashtag,以支持分享话题标签。详情请参阅 Android 分享。ShareMediaContent 以支持分享混合内容(例如照片和视频)。详情请参阅 Android 分享。ShareLinkContent.Builder.setQuote 以支持从链接分享引文。详情请参阅 Android 分享。AppInviteContent.setPromotionDetails 和 AppLinkData.getPromotionCode,以便在应用邀请中轻松加入优惠码。请参阅应用邀请了解更多详情。AppEventsLogger.activateApp(Application) 以大幅简化 Facebook 分析的使用流程。应从应用程序的 onCreate 调用此方法,而非在每个活动内调用。详情请参阅应用事件。DeviceLoginButton,用于设备流程身份验证,并支持设置重定向 URI。DeviceLoginManager,用于设备流程身份验证,并支持设置重定向 URI。无更改
注意:Facebook 已在适用于 Android 平台的 Audience Network jar 版本 4.6 中发现了展示记录漏洞,这个漏洞可导致较低的展示次数和收入。已在版本 4.7 中解决此漏洞,强烈建议升级到此版本。
无更改
此版本有一些重大更改。详情请参阅升级指南。将 Android SDK 从 4.0.1 升级到 4.1.0 版本。
Android 版 Facebook SDK 版本 4.0 是一次重大的版本升级,其主要特点是:
这是 SDK v3.x 与 v4.0 的主要区别。有关升级的详细信息,请参阅 将 Android SDK 从 3.x 升级至 4.x。
登录:
LoginManager 和 AccessToken - 这些新类可执行 Facebook 登录。更多详情请参阅 Android 版 Facebook 登录。
AccessTokenTracker - 这一新类会接收访问口令更改通知。这包括更新口令时或者不同用户登录时的更改。请参阅 Android 版 Facebook 登录 - 追踪访问口令。
Profile 和 ProfileTracker 是用于接收个人主页更改通知(例如当不同用户登录应用时)的新类。请参阅 Android 版 Facebook 登录 - 追踪当前的个人主页。
登录和图谱 API 错误 - LoginManager 现在可以解决与登录相关的 GraphRequest 错误。请参阅 LoginManager.resolveError()
分享:
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。
错误处理
FacebookRequestError - 错误分类已更新。
错误处理 - 已更新,新增了使用 SDK 处理错误的方法。请参阅使用 Android 版图谱 API 处理错误和解决问题。