build-swift-project

Build and test the LocalizeAR Swift project using build.sh scripts. Use this skill whenever building, testing, or cleaning the project. NEVER use xcodebuild or swift build directly - always use build.sh.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/build-swift-project

SKILL.md

Build LocalizeAR Project

This skill manages building and testing the LocalizeAR Swift project using build scripts that properly configure compilers.

CRITICAL: Always Use build.sh

NEVER use these commands directly:

xcodebuild
swift build
swift test

ALWAYS use build.sh scripts instead - they configure Apple Clang to prevent gcc-12 conflicts from Homebrew.

Main Library (LocalizeAR)

Located at project root. Use ./build.sh:

Command	Description
`./build.sh`	Debug build
`./build.sh test`	Build and run tests
`./build.sh release`	Optimized release build
`./build.sh clean`	Remove build artifacts

Example Apps

LARExplorer (macOS)

Located at Examples/LARExplorer/. Use ./Examples/LARExplorer/build.sh:

Command	Description
`./Examples/LARExplorer/build.sh`	Debug build
`./Examples/LARExplorer/build.sh test`	Run unit tests
`./Examples/LARExplorer/build.sh release`	Release build
`./Examples/LARExplorer/build.sh clean`	Clean artifacts

LARScan (iOS)

Located at Examples/LARScan/. Use ./Examples/LARScan/build.sh if available.

Example Requests

"Build the project" → ./build.sh
"Run the tests" → ./build.sh test
"Build LARExplorer" → ./Examples/LARExplorer/build.sh
"Test LARExplorer" → ./Examples/LARExplorer/build.sh test
"Clean everything" → ./build.sh clean

Why build.sh?

The build scripts:

Set CC and CXX to Apple Clang (not Homebrew's gcc-12)
Prevent "unrecognized command-line option" errors
Match CI/CD configuration exactly
Display compiler versions for verification