用途
该技能用于将已有的 iOS 应用从 Salesforce Mobile SDK 12.x 升级到 13.2.1。它供自主编码智能体使用,每个参考文件都是自包含的,包含精确的权威源码、文件路径和 CLI 命令。
适用场景
| 场景 | 参考文件 | 前置条件 |
|---|---|---|
| 升级 SDK 12.x → 13.2.1 | references/upgrade-12-to-13.md | 已集成 SDK 12.x |
跨领域参考:
| 主题 | 参考文件 |
|---|---|
| 已移除的 API、协议变更、废弃成员、新 API | references/api-changes.md |
| 构建 / 运行时 / 行为错误症状 | references/troubleshooting.md |
检测规则
在继续操作前,对工作目录运行以下检查:
- 检查 Podfile 中是否包含 pod 'SalesforceSDKCore', '12. 版本字符串。
- 检查 Package.resolved 中是否有 "SalesforceSDKCore",版本以 12. 开头。
- 检查 Package.swift 依赖中 SalesforceMobileSDK-iOS-SPM 是否固定在 12.x 版本。
如果检测到 SDK 12 且未出现 pod 'SalesforceSDKCore', '13.(或等价的 SPM 版本)→ 该技能适用。
不变量
无论项目形态如何(CocoaPods 或 SPM),以下规则均成立:
- 不要从头重建 Xcode 项目。保留所有手工维护的目标配置、签名设置和 scheme 设置。
- 不要重命名或移动应用源文件。仅更改 SDK 版本标识符以及任何已移除/重命名的 API。
- 不要更改非 SDK 的构建设置(bundle ID、签名身份、能力),除非升级明确要求。
- 仅在同时修改两处时才提升部署目标。Podfile/Package.swift 声明与 Xcode 项目的 IPHONEOS_DEPLOYMENT_TARGET 必须匹配。不匹配会导致 CocoaPods 拒绝安装,或生成无法通过 App Store 验证的归档包。
- pod install 之后,暂存 .xcworkspace 和 Podfile.lock 的更改,但不要暂存整个 Pods/ 目录。Pods/ 目录是生成产物;提交它会膨胀仓库并引发合并冲突。
- 永远不要向 xcodebuild 传递 CODE_SIGNING_ALLOWED=NO。它会剥离 keychain 权限,并在升级后静默破坏登录。
权威来源
当本技能中的 SDK API 与实际不符时,以上游发布说明和 Objective-C 头文件为准。
Release: https://github.com/forcedotcom/SalesforceMobileSDK-iOS/releases/tag/v13.2.1