XcodeGen iOS workflow

Quick start

• Treat project.yml (or project.yaml) as the source of truth; regenerate with xcodegen generate before building.
• Do not edit the generated .xcodeproj directly; delete and regenerate as needed.

Build / Run

• For “Designed for iPad on Mac” builds, use a macOS destination with variant=Designed for iPad when available.
• For tests, prefer an iOS Simulator if any vendor frameworks lack Mac Catalyst support.

Tests

• Ensure the test target is added to the scheme and has a host app if required.
• If tests show 0 cases, recheck the scheme and any test plan configuration.
• If @testable import fails, confirm the host app module name and that tests build for the same destination as the host.