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