Skip to content

dev-setup.md

Latest commit

 

History

History
102 lines (67 loc) · 1.88 KB

dev-setup.md

File metadata and controls

102 lines (67 loc) · 1.88 KB

Development Setup

Last updated: 2026-04-02

Current Verified Environment

The current machine has already been brought into a working macOS app development state.

Verified commands:

xcodebuild -version
xcrun --sdk macosx --show-sdk-version

Verified output on this machine:

  • Xcode 26.4
  • Build version 17E192
  • macOS SDK 26.4

Required Tooling

1. Full Xcode

Install the full Xcode app from the Mac App Store, then select it as the active developer directory:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

2. Homebrew helpers

Install project helper tools:

brew install xcodegen swiftformat xcbeautify

Current project usage:

  • xcodegen
    • regenerate Topleaf.xcodeproj from project.yml
  • swiftformat
    • keep Swift formatting consistent
  • xcbeautify
    • optional readable wrapper for xcodebuild logs

Optional:

brew install swiftlint

Project Commands

Regenerate the Xcode project

Run this after adding or removing source files:

xcodegen generate

Build

xcodebuild -project Topleaf.xcodeproj -scheme Topleaf -configuration Debug -derivedDataPath /tmp/TopleafDerivedData build

Test

xcodebuild -project Topleaf.xcodeproj -scheme Topleaf -configuration Debug -derivedDataPath /tmp/TopleafDerivedData test

Format

swiftformat Sources Tests

Notes

  • The generated project lives at /Users/lyk/Prj/topleaf/Topleaf.xcodeproj
  • Source of truth for project structure is /Users/lyk/Prj/topleaf/project.yml
  • The local git remote is:
git@github.com:C23333/topleaf.git
  • xcodebuild may print CoreSimulator-related warnings in CLI environments even when macOS app build/test succeeds

Latest Verification

Verified on 2026-04-07:

  • build passed
  • tests passed
  • total tests passing: 14