Where can I find detailed documentation about how Swift projects are compiled?

I'm working on Swift builds at scale, and I'd like to read as much as I can about how exactly incremental builds work vs. whole-module, maybe how .swiftdeps is used, etc. Where can I find links about that stuff? Thanks.

https://github.com/apple/swift/blob/master/docs/Driver.md, https://github.com/apple/swift/blob/master/docs/DriverInternals.rst, and https://github.com/apple/swift/blob/master/docs/DriverParseableOutput.rst are a good start. Dependency tracking for incremental builds has changed a lot recently, so I'm not sure there's a lot of documentation on that yet.

4 Likes