facebook-android-sdk 版本演进全解析：从 CHANGELOG 读懂登录、分享与数据合规的关键变更

移动开发认证鉴权社交【免费下载链接】facebook-android-sdkUsed to integrate Android apps with Facebook Platform.项目地址https://gitcode.com/gh_mirrors/fa/facebook-android-sdk点击查看免费下载本文以仓库根目录的 CHANGELOG.md 为脉络系统梳理 facebook-android-sdk 从 4.39.0 到 18.3.0 的版本演进史既涵盖 SSO 单点登录、Integrity 信号保护、Google AdServices 归因等新增能力也覆盖 Bolts 模块化、AndroidX 迁移、Java 8 兼容等结构性重构并结合仓库源码逐一印证关键变更的实现细节。读完本文你将掌握该 SDK 各版本的能力边界、破坏性变更清单以及登录/事件上报两条主线的技术演进逻辑可直接用于评估升级成本与排查版本相关行为差异。一、CHANGELOG 格式约定与版本语义CHANGELOG.md 严格遵循 Keep a Changelog 规范与 SemVer 语义化版本规范每个版本条目按Added / Changed / Fixed / Removed / Deprecated / Other分类组织其中### Added与### Fixed出现频率最高是判断新功能与稳定性修复的主要窗口。文件末尾维护了一份完整的版本对照表将每个版本号映射到相邻版本的 compare 链接方便回溯任意两个版本之间的 diff。从版本节奏可以观察出几条明显规律大版本号X.0.0通常伴随破坏性变更例如 13.0.0 移除 tokenless 请求、14.0.0 移除 Open Graph 分享类、15.0.0 迁移 Gradle 脚本升级前必须仔细阅读对应小节。Graph API 版本同步升级6.0.0、8.0.0、9.0.0、11.0.0 分别将默认 Graph API 版本提升到 v6.0、v8.0、v9.0、v11.0其中 8.0.0 明确提示当前版本使用 Graph API v8.0如需使用最新版本请在 GraphRequest 调用中显式指定。平台政策驱动的合规改动集中在 18.xAD_ID 权限、Google Privacy Sandbox AdServices 权限、Integrity 保护均在近几个大版本内密集落地。二、18.xSSO 登录、安全加固与隐私合规时代1. 18.3.0Facebook App 内单点登录SSO18.3.0 是当前 CHANGELOG 中标记为已发布的最新特性版本更上方仅剩空的[Unreleased]占位其核心新增是Single Sign-OnSSO支持用户可直接通过已安装的 Facebook App 完成登录无需重新输入凭据。从源码看该能力由两个类协同实现均位于 facebook-common/src/main/java/com/facebook/login/FBLoginSSOLauncher.kt负责完整生命周期——通过 AndroidXActivityResultLauncher启动 SSO Activity、解析返回的 bundle extras 生成 token再委托LoginManager.onActivityResult完成 token 持久化与回调分发。其launch()方法内部先校验当前是否已有 AccessToken已有则直接返回 false再检查FeatureManager.Feature.LoginSSO是否被 GateKeeper 开启随后调用NativeProtocol.createFBLoginSSOIntents构造 Intent 并逐一解析。若所有 Intent 均不可解析则依据isFb4aInstalled()判定是未安装 Facebook Appfb4a_not_installed还是App 版本过旧fb4a_outdated。FBLoginSSONoAppDialog.kt即 CHANGELOG 所述 Continue with Facebook 回退对话框。当 Facebook App 缺失或过旧时展示用户点击继续后通过LoginManager.startLoginWithForceConfirmation回退到标准 Web 登录流程Chrome Custom Tabs。注意FBLoginSSOLauncher构造函数的showWithoutFBApp参数默认 true控制是否展示该回退对话框。对应的单元测试 FBLoginSSOLauncherTest.kt 覆盖了启动、结果解析与取消路径可作为接入该 API 的行为参考。此外LoginManager.kt中还有pendingSsoContext静态字段用于向后续logIn()调用传递 SSO 上下文。2. 18.2.3登录安全参数与一批稳定性修复18.2.3 是 Added 条目最多的补丁版本主要新增redirect_uri 支持为 WebView、CustomTab 与原生 AppKatana三种登录处理器提供安全登录重定向。配置入口在 FacebookSdk.ktgetRedirectURI()从应用清单 meta-data 读取调用链最终传入WebViewLoginMethodHandler、CustomTabLoginMethodHandler等处理器相关行为在 WebViewLoginMethodHandlerTest.kt、CustomTabLoginMethodHandlerTest.kt 中有测试覆盖。intent_uri_package_target 参数支持 CustomTab 与 Katana 登录流程的 Intent 包目标指定同样由FacebookSdk.getIntentUriPackageTarget()提供。Integrity 的 protected data metadata 标志与 banned params 管理器用于向 Integrity 上报被禁止的参数名相关逻辑可追踪至 FeatureManager.kt 中IntelligentIntegrity特性与 IntegrityManager 的映射。Deep Link 请求的 referrer 支持。AdServices API 调用前增加Build.VERSION.SDK_INT检查避免在旧系统上误调新 API。Fixed 部分值得注意的包括FetchedAppGateKeepersManager的ConcurrentModificationException并在静态初始化阶段规避 Kotlin 反射、AttributionIdentifiers中AtomicBoolean的误用、ImageDownloader.RequestKey.equals的 identity 比较、FileLruCache内容标签检查逻辑、跨多个类的共享可变字段补上Volatile、LegacyTokenHelper与Utility的变量遮蔽、CustomRedirectWebDialog的 WebView 尺寸回归以及 Gaming Graph token 的刷新改为逐个请求执行。Changed 部分则反映工程实践升级Gradle 8.5与 gradle/wrapper/gradle-wrapper.properties 中distributionUrlgradle-8.5-bin.zip一致、升级 install-referrer 依赖gradle/libs.versions.toml 中为2.2、用RoundingMode.HALF_UP替换废弃的BigDecimal.ROUND_HALF_UP、为安全合规用SecureRandom替换java.util.Random、移除 WebDialog 中的 SSL bypass 代码路径、停止将 Access Token 与事件一同持久化、使用 debug-gated 的logd()替代Log.d()、Kotlin 的.use{}统一管理 I/O 资源等。3. 18.0.xGoogle Privacy Sandbox AdServices 权限18.0.2 与 18.0.3 为接入 Google Privacy Sandbox AdServices API 新增了四个权限ACCESS_ADSERVICES_ATTRIBUTION、ACCESS_ADSERVICES_AD_ID、ACCESS_ADSERVICES_CUSTOM_AUDIENCE以及ACCESS_ADSERVICES_TOPICS。这些权限已实际写入 facebook-core/src/main/AndroidManifest.xml与com.google.android.gms.permission.AD_ID一并声明。CHANGELOG 明确给出两个退出机制若需禁用任一 AdServices 权限请在宿主应用清单中为对应权限添加tools:noderemove节点标记AD_ID 权限自 13.0.0 起默认加入可参照 Google Play 政策说明移除。18.0.1 修复了潜在的 Ad-Services 命名空间冲突18.0.2 同步升级了 Kotlin、Gradle 与 Android Gradle Plugin 等一批依赖。18.0.0 则改进了对Google Play Billing Library 57的应用内购买事件上报支持当前版本目录中 billing 依赖为7.0.0。三、登录与认证能力的演进主线12.x → 18.x登录模块是 CHANGELOG 中迭代最密集的方向按时间线可梳理为12.0.0/12.0.1新增基于OpenID Connect 标准的登录能力当时标记为 beta并加入AuthenticationToken缓存以增强 OIDC 体验Login 与 Share kit 全面支持 AndroidX Activity Result API使用androidx.activityv1.2.0 或androidx.fragmentv1.3.0 的 context 时无需再覆写onActivityResult()。12.1.0修复用户已授权且以openidscope 登录时可能启动多个登录 Intent 的 bug为原生游戏引入 Tournaments仅限合作方。12.2.0增加从 FB 界面进入时解析 gaming payload 与 tournament 数据的入口 Intent 解析为 crash/error 上报增加 data processing options。12.3.0存在 client token 时避免 tokenless 请求为 13.0 移除做铺垫修复数据访问重授权。13.2.0client token 变为强制要求——SDK 初始化会校验 client token缺失则抛出异常新增LoginManager.createLogInActivityResultContract()与FacebookDialog.createActivityResultContractForShowingDialog()暴露 Activity Result 契约。前者在 LoginManager.kt 中以内部类FacebookLoginActivityResultContract实现可配合ActivityResultLauncher使用。15.2.0MessengerThreadParams与ShareToMessengerParams转写为 KotlinJava 侧不再直接访问实例变量必须改用 getter如params.getMetadata()而非params.metadata同时移除废弃的LoginBehavior.WEB_VIEW_ONLY设置。源码可确认 MessengerThreadParams.kt 目前为 Kotlinclass且字段为val。14.1.1修复 AndroidX activity/fragment 1.5.0 在未安装 Facebook App 时破坏登录流程的问题。16.x/17.x/18.x继续走向 SSO 与更严格的合规见上文。四、隐私、信号处理与 Integrity 保护从 7.1.0 引入DataProcessingOptions同时弃用 UserProperties API、8.2.0 增加设备端信号处理能力尚未激活起SDK 的事件上报逐步转向设备端隐私保护17.0.0声明Integrity 支持更多用例违反 Meta 政策的 App 将不再被允许发送流量。源码侧 IntegrityManager.kt 提供了具体实现processParameters()对事件参数逐个做模型预测ModelManager.Task.MTML_INTEGRITY_DETECT命中address/health等类型时移除原参数并将受限参数挪入_onDeviceParams字段同目录的 VVPManager.kt 负责视频观看保护VVP配置解析。16.0.1修复AttributionIdentifiers与InstallReferrer的 ANR 问题。12.2.0 的 FixedAndroid 12 及以上在 GMS 可用且isTrackingLimited关闭时AppEvents 会上报 attribution ID 与 anonymous ID受 Google Play 新政时间点控制。5.8.0启动自动高级匹配Automatic Advanced Matching5.1.0支持在开发者后台开启后自动记录 Google Play 的 Subscribe 与 StartTrial 事件5.0.1支持 Audience Network 的 campaign 归因。五、模块化重构与工程基础升级1. Bolts 库迁移为独立 kit13.1.013.1.0 将废弃 Bolts 库的全部类迁移到独立的facebook-boltskit各 kit 依赖它以保持向后兼容并计划逐步移除依赖。当前仓库中该 kit 位于 facebook-bolts/src/main/java/com/facebook/bolts/包含Task、TaskCompletionSource、CancellationToken、CancellationTokenSource、AppLink、BoltsExecutors等 15 个 Kotlin 文件测试位于 facebook-bolts/src/test/kotlin/com/facebook/bolts/。12.0.0 还进一步收紧了 Bolts APIcom.facebook.bolts.AppLinkResolver只接收非空参数并返回非空值并移除了com.facebook.bolts.Capture。2. AndroidX 与 Java 87.0.0 / 13.0.07.0.0 完成AndroidX 迁移旧 support 库用户需升级后使用 v713.0.0 将 Java source/target 兼容性设为Java 8并要求接入方也将 source/target 设为 1.8 及以上。3. Gradle 工程现代化15.0.0 / 18.2.315.0.0 将除maven.gradle与 sample 项目外的 Gradle 脚本从 Groovy 迁移为 Kotlin DSL同时在 debug 构建上启用 jacoco 收集覆盖率从源码构建而非 Maven 发布版本时可能遇到 debug 构建启动崩溃官方文档给出了解决方案18.2.3 将 Gradle 升级到 8.5。仓库中 settings.gradle.kts 与 jacoco.gradle.kts 即是这一演进的落地证据。4. 版本目录统一管理依赖gradle/libs.versions.toml 采用 Gradle Version Catalog 集中管理minSdk 15、compileSdk/targetSdk 34、kotlin 1.8.20、billing7.0.0、installreferrer2.2等与 CHANGELOG 中历次依赖升级条目一一对应。六、破坏性变更与移除项盘点升级时需重点留意的 Breaking Changes均以当前仓库状态验证13.0.0移除tokenless 请求支持——所有 Graph API 请求必须关联 access token未登录用户需通过 client token 构造 token移除废弃的LikeView及关联类LikeButton、LikeContent、LikeDialog、废弃的 Device Sharing 类、废弃的 Messenger Sharing 内容类、Fblite Login、PerformanceGuardian 与端到端 dumpsys 测试工具。14.0.0移除废弃的ShareOpenGraphAction、ShareOpenGraphContent、ShareOpenGraphValueContainer、ShareOpenGraphObject当前源码中已不存在这些类Open Graph 故事仅以链接分享形式呈现。15.2.0移除LoginBehavior.WEB_VIEW_ONLYMessenger 参数类字段改由 getter 访问。11.0.0AccessToken的token、applicationId、userId、permissions变为非空GraphResponse构造函数要求非空GraphRequest移除废弃的签名 key hash 校验。13.2.0 起client token 强制必填。12.0.0移除com.facebook.bolts.Capture与AppEventsLogger中一批废弃函数、ViewIndexer.sendToServerUnity(String)。值得注意的例外是11.0.0 的版本跳跃CHANGELOG 从 11.3.0 直接跳回 9.1.1无 10.x 条目这是版本线规划所致不影响使用。七、性能、稳定性与运行时兼容性修复历次版本中大量 Fixed 条目围绕运行时健壮性代表性修复包括ANR 治理16.2.0 弃用ExecutorService.scheduleAtFixedRate改用scheduleWithFixedDelay已在 ANRDetector.kt 的源码中确认11.1.0 引入 ANR 检测器仅收集由 Facebook SDK 引发的 ANR可通过关闭自动记录事件禁用16.0.1 修复归因标识与 install referrer 的 ANR。Android 版本兼容8.1.0 针对 Android 11 包可见性变化做登录切换缓解11.1.1 修复 Android 11 上从非视觉 context 访问 WindowManager 的 bug11.1.0/11.1.1 支持 Android S 的包校验和 API15.0.1 修复 target Android 12 时组件缺android:exported导致的崩溃12.2.0 修复 Android 12 的归因上报策略。并发与内存5.5.2 修复 Codeless 内存泄漏11.1.1 修复云端游戏的竞态条件18.2.3 一批线程安全修复Volatile、AtomicBoolean、ConcurrentModificationException。WebView 可用性13.1.0 修复 WebView 不可用时的崩溃。八、如何基于 CHANGELOG 制定升级策略结合本仓库结构与 CHANGELOG建议按以下流程评估升级先读版本间隔利用 CHANGELOG 末尾的版本对照表如18.2.3 → 18.3.0确认要跨越的版本区间逐条比对 Added/Removed/Deprecated。核对 manifest 与依赖关注 AdServices 权限是否需要tools:noderemove、AD_ID 权限、client token 配置参考 facebook-core/src/main/AndroidManifest.xml 与 gradle/libs.versions.toml。关注登录 API 变化检查是否使用onActivityResult旧流程13.x 起推荐 AndroidX Activity Result 契约、是否使用 OIDC/AuthenticationToken、是否受 SSO 新流程影响相关行为可对照 login 模块测试。回归事件上报链路Integrity 过滤、VVP、自动事件等均影响 AppEvents可结合 facebook-core/src/test/kotlin/com/facebook/appevents/ 下的测试理解预期行为。保留 debug 构建注意点若从源码构建15.0.0 起 jacoco 覆盖可能导致 debug 构建启动问题需按官方 issue 说明处理。总而言之CHANGELOG.md 完整呈现了 facebook-android-sdk 从早期 Graph API 调用库演进为模块化、合规化现代 SDK 的全过程将其与仓库源码登录模块、Integrity 模块、manifest 权限声明、Gradle 版本目录对照阅读是准确评估版本行为、制定升级与排查方案最可靠的路径。赞分享移动开发认证鉴权社交【免费下载链接】facebook-android-sdkUsed to integrate Android apps with Facebook Platform.项目地址https://gitcode.com/gh_mirrors/fa/facebook-android-sdk点击查看免费下载相关推荐Facebook iOS SDK 版本演进与升级实战从 CHANGELOG 读懂 v19.0.0 关键变更与迁移路径Facebook iOS SDK 版本演进与升级实战从 CHANGELOG 读懂 v19.0.0 关键变更与迁移路径 本文以 Facebook iOS SDK移动开发认证鉴权社交数据分析Bazel 版本发布全史从 CHANGELOG 读懂版本演进、LTS 策略与关键变更Bazel 版本发布全史从 CHANGELOG 读懂版本演进、LTS 策略与关键变更 导读 CHANGELOG.md 是 Bazel 开源构建系统最权威的版本构建工具Loki 依赖视角下的 OpenTelemetry Go SDK 版本演进全解从 CHANGELOG 读懂 1.46.0 之前的每一次关键变更Loki 依赖视角下的 OpenTelemetry Go SDK 版本演进全解从 CHANGELOG 读懂 1.46.0 之前的每一次关键变更 本文以仓库内可观测性日志分析后端微服务对象存储云原生上一篇libiec61850电力自动化通信协议栈的技术架构与实践应用下一篇5分钟跑通抖音无水印下载单条、主页批量采集与直播录制全流程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考