If the library I want to document is primarily tracked with a Package.swift cross-platform definition, what's the optimal way to build and render documentation?
Can I still use xcodebuild docbuild
with the Package.swift format for the project, or does the documentation system require a fully-defined Xcode project wrapped around it?
Or do I need to open the Package.swift
file in Xcode and then generate the docc archive from Xcode's Product menu?
xcodebuild docbuild
still works with a Package.swift file. You'll need to add a -scheme
argument to tell xcodebuild
which target to build; you can run xcodebuild -list
to see the list. For example, you can run xcodebuild docbuild -scheme MyPackage
to build a DocC Archive for the MyPackage scheme. The archive bundle will appear in your Derived Data directory (for example, ~/Library/Developer/Xcode/DerivedData/MyPackage-[hash]/Build/Products/Debug/MyPackage.doccarchive
).