Tuist Metal SPM Bug

This is a known regression in Tuist 4.78.1+ caused by changes in PR #8207, which altered how Metal shader files (.metal) are handled in SPM dependencies. The bug occurs because Tuist now adds .metal files as both compiled sources and resources, leading to duplicate build tasks and errors during compilation. This stems from how ProjectFileElements.swift and ResourcesProjectMapper.swift collect files for targets, without filtering out .metal files that are already specified as resources, resulting in them being included twice in the build process PR #8207, ProjectFileElements.swift analysis.

There are open issues tracking this problem: #8219 and #8299. The main workarounds are to either revert to Tuist 4.78.0, use pure SPM integration, or switch your package product type to .framework (instead of .staticFramework), which prevents Tuist from generating the problematic resource bundle target community workaround. Another option is to use a normal framework with MACH_O_TYPE=staticlib and implement a custom BundleFinder to access resources, which avoids the resource bundle duplication issue discussion.

If you need Metal build settings (like MTL_ENABLE_DEBUG_INFO) to be respected, you must set them directly on the generated bundle target, as Tuist does not propagate these settings automatically issue #8299.

There is ongoing discussion about improving resource bundle handling for static frameworks, but for now, the above workarounds are the most reliable solutions.

To reply, just mention @dosu.

Share context across your team and agents. Try Dosu.

Have you found any workarounds? This is impacting my project too.

If you came here because of this issue too, then my workaround was to move the shader files outside of the Sources/{Target} and reference the folder explicitly in the Package.swift like this:

        .target(
            name: "Foo",
            dependencies: [...],
            resources: [.process("../../Resources/Shaders")] // <-- referencing it from outside the source folder
        ),

This will exclude it from being added to the compiled sources, but will keep in the resource bundle.

https://github.com/tddworks/ClaudeBar/actions/runs/23111613083/job/67129933992

ExecuteExternalTool /Applications/Xcode_26.2.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -v -E -dM -arch arm64 -isysroot /Applications/Xcode_26.2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX26.2.sdk -x c -c /dev/null

ExecuteExternalTool /Applications/Xcode_26.2.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swiftc --version

ExecuteExternalTool /Applications/Xcode_26.2.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -v -E -dM -isysroot /Applications/Xcode_26.2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX26.2.sdk -x c -c /dev/null

ExecuteExternalTool /Applications/Xcode_26.2.app/Contents/Developer/usr/bin/actool --version --output-format xml1

ExecuteExternalTool /Applications/Xcode_26.2.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/libtool -V

ExecuteExternalTool /Applications/Xcode_26.2.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/ld -version_details

Build description signature: 1e3ddec0c7e309fecdb9320bca2b537e
Build description path: /Users/runner/Library/Developer/Xcode/DerivedData/ClaudeBar-eisnjhvegwcegxbvwupeptxpuqbz/Build/Intermediates.noindex/XCBuildData/1e3ddec0c7e309fecdb9320bca2b537e.xcbuilddata
error: Unexpected duplicate tasks
    note: Target 'SwiftTerm_SwiftTerm' (project 'SwiftTerm'): MetalLink /Users/runner/Library/Developer/Xcode/DerivedData/ClaudeBar-eisnjhvegwcegxbvwupeptxpuqbz/Build/Products/Debug/SwiftTerm_SwiftTerm.bundle/Contents/Resources/default.metallib
    note: Target 'SwiftTerm_SwiftTerm' (project 'SwiftTerm'): MetalLink /Users/runner/Library/Developer/Xcode/DerivedData/ClaudeBar-eisnjhvegwcegxbvwupeptxpuqbz/Build/Products/Debug/SwiftTerm_SwiftTerm.bundle/Contents/Resources/default.metallib
error: Unexpected duplicate tasks
Testing failed:
    note: Target 'SwiftTerm_SwiftTerm' (project 'SwiftTerm') has compile command with input '/Users/runner/work/ClaudeBar/ClaudeBar/Tuist/.build/checkouts/SwiftTerm/Sources/SwiftTerm/Apple/Metal/Shaders.metal'
	Unexpected duplicate tasks
    note: Target 'SwiftTerm_SwiftTerm' (project 'SwiftTerm') has compile command with input '/Users/runner/work/ClaudeBar/ClaudeBar/Tuist/.build/checkouts/SwiftTerm/Sources/SwiftTerm/Apple/Metal/Shaders.metal'
	Testing cancelled because the build failed.


Test session results, code coverage, and logs:
** TEST FAILED **
	/Users/runner/work/ClaudeBar/ClaudeBar/TestResults.xcresult

same