使用fastlane时SPM的Xcode项目标签被替换为通用名如何解决
使用fastlane版本号插件获取、更新项目版本号或构建编号时,会触发project.pbxproj文件的非预期变更:所有SPM依赖的文件引用原本对应的专属注释标签,会被替换为SwiftPackageProductDependency、RemoteSwiftPackageReference、BuildFile这类通用名称。
这类变更仅涉及注释文本,不影响实际构建流程,但只要后续在Xcode GUI中对项目做任何调整(新增、删除、移动文件),这些注释就会自动恢复为原有专属标签,导致Git中出现大量无意义的冗余变更,大幅提升筛选有效改动的成本。
变更对照
原有正常的项目文件行:
B21693D8256DC06F00F98045 /* FirebaseMessaging in Frameworks */, B21693E6256DC0F100F98045 /* FirebaseFirestore in Frameworks */, B21693A4256DBFB500F98045 /* Segment in Frameworks */, B2CC9E5325647C8D00AC7158 /* Sentry in Frameworks */,
插件触发后的异常变更行:
B21693D8256DC06F00F98045 /* BuildFile in Frameworks */, B21693E6256DC0F100F98045 /* BuildFile in Frameworks */, B21693A4256DBFB500F98045 /* BuildFile in Frameworks */, B2CC9E5325647C8D00AC7158 /* BuildFile in Frameworks */,
每次调用该插件的版本修改方法都会触发这类变更,且只要项目文件被Xcode修改,通用标签就会自动回滚为原有内容。
- 执行
xcodebuild -resolvePackageDependencies:对注释标签的恢复无任何效果 - 执行
swift package generate-xcodeproj:因项目不存在根目录Package.swift文件,直接报错error: root manifest not found无法执行 - 考虑引入第三方命令行pbxproj修改工具:为临时问题引入额外依赖成本过高,且不确定能否复现Xcode的注释生成逻辑
根因规避
该插件触发问题的核心原因是,其底层解析、重写project.pbxproj的逻辑没有兼容Xcode对SPM节点的注释生成规则。直接替换触发异常的版本更新逻辑即可从根源解决问题:
- 优先使用fastlane原生内置的
update_app_version、update_build_number动作,这类官方维护的动作重写pbxproj的逻辑完全对齐Xcode格式规范,不会出现注释标签被通用化替换的问题 - 如果需要第三方插件的特定能力,可替换为基于官方
xcodeproj库实现的版本修改工具,避免使用自定义手写pbxproj解析逻辑的老旧插件
命令行自动修复
如果暂时无法替换现有插件,可在lane执行流程的最后一步自动完成pbxproj格式标准化,完全模拟Xcode GUI修改项目的效果,无需手动在Xcode中做增删文件的操作:
xcodeproj是fastlane生态的官方基础依赖,不算额外引入的重依赖,安装后可直接在lane中添加以下逻辑:
require 'xcodeproj' # 替换为你项目的xcodeproj路径 project_path = '你的项目.xcodeproj' project = Xcodeproj::Project.open(project_path) # 触发全量注释重写,和Xcode保存项目的效果完全一致 project.save()
- 执行后,所有被替换的通用注释会自动恢复为原有专属标签,完全抵消插件触发的冗余变更,不会残留无关diff。
Git层兜底
如果不想调整现有工作流,可通过Git的diff过滤规则,针对pbxproj文件的这类注释变更做屏蔽,将所有匹配/* BuildFile、/* SwiftPackageProductDependency这类通用标签的行从diff结果中隐藏,仅展示真正影响项目逻辑的有效改动。
内容的提问来源于stack exchange,提问作者shim

