SuperAPI AI 工具集

android-upgrade-mobile-sdk-13-to-14

编程与开发

查看项目

更新于 10-16 20:05

技能介绍

该技能由 forcedotcom/salesforcemobilesdk-templates 提供,用于将现有的 Android Kotlin 应用从 Salesforce Mobile SDK 13.x 升级到 14.0。它面向自主编码智能体,所有参考文件均为自包含,包含精确的源真代码、文件路径和 CLI 命令。

【适用场景】 当用户要求升级 Mobile SDK 版本时使用;或当检测到项目中仍集成 SDK 13.x 时启用。技能文档给出的场景为:升级 SDK 13.x → 14.0,前提是 SDK 13.x 已集成且应用为 Kotlin,对应参考文件 references/upgrade-13-to-14.md。

【检测规则】 在继续之前,对工作目录运行以下检查: 检查 app/build.gradle.kts 中的 com.salesforce.mobilesdk: 版本字符串是否包含 13.; 检查 libs.versions.toml 中的 salesforceSDK = "13. 版本字符串; 如果检测到 SDK 13,且同一文件中任何位置均未出现 14.,则适用该技能。

【不变式(Invariants)】 这些规则无论项目形态(版本目录或内联依赖)如何都成立: 不要从头重建 Android 项目。保留所有手工维护的模块配置、签名配置和构建变体。 不要重命名或移动应用源文件。只有 SDK 版本标识符以及被移除/重命名的 API 会发生变化。 除非升级明确要求,不要更改 applicationId、签名配置或非 SDK 构建设置。 minSdk 必须提升到 31。SDK 14.0 要求最低 Android 12(API 31)。这会放弃对 Android 9、10 和 11 的支持——在应用前请确认应用的 Play 商店最低版本策略。 compileSdk 和 targetSdk 必须至少为 36。SDK 14.0 库本身的目标 compileSdk = 36(libs/SalesforceSDK/build.gradle.kts 中有明确的 // TODO: MSDK 14 will remain on 36. The next increment will be in MSDK 15.),因此使用 36 的应用完全兼容——这与 android-mobile-sdk 技能一致,后者生成的应用程序即为 36。37 也可以构建但不是必须的;它仅来自示例应用。不要强制升级到 37。 Gradle wrapper 必须更新到 9.4.1;AGP 必须更新到 9.1.1。 需将 Kotlin 插件与 android.builtInKotlin 标志协调一致。存在两种有效配置:在 AGP 内置 Kotlin 激活的情况下(android.builtInKotlin 为 true 或未设置),从 plugins { } 中移除 id("org.jetbrains.kotlin.android"),因为保留它会冲突;或者在 gradle.properties 中设置 android.builtInKotlin=false 并保留该插件。(Mobile SDK 库自身设置了 builtInKotlin=false,但那是库的内部构建选择,不会通过 Maven 传播到消费方应用——在 AGP 9 上的消费方应用默认获得内置 Kotlin,因此优先选择路径 A,仅在有意为之的情况下选择路径 B。)在确认该标志之前,不要移除插件。参见 references/upgrade-13-to-14.md 第 4 步。 构建目标:除非有理由使用其他变体,否则从项目根目录运行 ./gradlew assembleDebug。

【交叉参考文档】 被移除的 API、变更的签名、新增的 API:references/breaking-changes.md 构建/运行时/行为错误症状:references/troubleshooting.md

【源真(Source of Truth)】 当本技能中的 SDK API 与实际情况不一致时,以发布版中的上游 Kotlin 源码为准。 发布版:https://github.com/forcedotcom/SalesforceMobileSDK-Android/releases/tag/v14.0.0