SuperAPI AI 工具集

ios-upgrade-mobile-sdk-13-to-14

编程与开发

查看项目

更新于 10-16 20:05

技能介绍

iOS Salesforce Mobile SDK — 从 13.x 升级到 14.0

用途

该技能用于将现有 iOS 应用从 Salesforce Mobile SDK 13.x 升级到 14.0 版本。它由自主编码代理消费使用:每个参考文件都是自包含的,包含精确的权威代码、文件路径和 CLI 命令。

主要能力与参考文件

升级场景:

  • 升级 SDK 13.x → 14.0,参考 references/upgrade-13-to-14.md,前提是 SDK 13.x 已集成。

横向参考:

  • 已移除的 API、协议变更、已弃用成员、新增 API、版本号提升,参考 references/breaking-changes.md。
  • 构建、运行时及行为错误症状,参考 references/troubleshooting.md。

检测规则

在执行升级之前,对工作目录运行以下检查:

  1. 检查 Podfile 中的 platform :ios, '17.,或任何被固定到版本 '13.. 的 pod。
  2. 检查 <ProjectName>.xcodeproj/project.pbxproj 中 SalesforceMobileSDK-iOS-SPM 条目下版本为 13. 的 XCRemoteSwiftPackageReference。
  3. 检查 project.yml 中版本为 13. 的 SalesforceMobileSDK-iOS-SPM 条目。

如果检测到 SDK 13 且 SDK 14 尚未存在,则适用本技能。

不变量

无论项目形态如何(CocoaPods、手工管理的 SPM,或 xcodegen + SPM),以下规则均成立:

  • 不要从零重建 Xcode 工程。保留所有手工维护的目标配置、签名设置和 scheme 设置。
  • 不要重命名或移动应用源文件。只有 SDK 版本标识符以及被移除或重命名的 API 需要变更。
  • 不要更改非 SDK 的构建设置(bundle ID、签名身份、capabilities),除非升级明确要求。
  • 仅在两个位置同时提升部署目标。Podfile/project.yml/project.pbxproj 中的声明与 Xcode 工程中的 IPHONEOS_DEPLOYMENT_TARGET 必须一致。不一致会导致 CocoaPods 拒绝安装,或生成无法通过 App Store 校验的归档。
  • pod install 之后,暂存 .xcworkspace 和 Podfile.lock 的变更,但不要暂存整个 Pods/ 目录。Pods/ 目录是生成产物,提交它会膨胀仓库并引发合并冲突。
  • 永远不要向 xcodebuild 传递 CODE_SIGNING_ALLOWED=NO。它会剥离 keychain entitlement,并在升级后静默破坏登录。

权威来源

当本技能中的 SDK API 与现实不符时,以上游发布说明和 Objective-C 头文件为准。

发布地址:https://github.com/forcedotcom/SalesforceMobileSDK-iOS/releases/tag/v14.0.0

适用场景

适用于需要将 iOS 应用中的 Salesforce Mobile SDK 从 13.x 升级到 14.0 的工程,无论是使用 CocoaPods、手工管理的 SPM,还是 xcodegen 加 SPM 的项目形态。

限制

本技能仅覆盖从 13.x 到 14.0 的升级路径;其他版本区间、Android 平台或全新集成等情形暂未提供说明。