development-notes.md

Development Notes

Notes through the development process.

swift Command Line

The swift command should always run from the root of the package, at the same level of Package.swift.

Build the package:

swift build

Run package tests, note this runs all tests included in the package test target:

swift test

To run an specific testplan, use xcodebuild instead:

xcodebuild test \
    -scheme PreviewUtilities \
    -testPlan UnitTests \
    -destination 'platform=iOS Simulator,OS=26.4.1,name=iPhone 17 Pro'

To see the available destinations for testing:

xcodebuild -scheme PreviewUtilities -showdestinations

Documentation generation

Files that need version update:

• Documentation Catalog: package-version, on text and link.
• readme.md
• scripts/generate-static-docs
• scripts/serve-documentation

Build the documentation into the documentation worktree:

./scripts/generate-static-docs

Preview documentation in the documentation worktree:

./scripts/serve-documentation