SuperAPI AI 工具集

ios-upgrade-mobile-sdk-12-to-13

编程与开发

查看项目

更新于 10-16 21:05

技能介绍

用途

该技能用于将已有的 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