Repolode
yonaskolb

yonaskolb/XcodeGen

YAML 또는 JSON 프로젝트 명세와 폴더 구조를 바탕으로 Xcode 프로젝트를 생성하는 Swift 커맨드라인 도구입니다.

스타
8,929
포크
919
열린 이슈
404
마지막 커밋
24일 전

어떤 프로젝트인가요?

XcodeGen은 타깃, 구성, scheme, 빌드 설정, 의존성을 정의하는 사람이 읽기 쉬운 명세 파일에서 Xcode 프로젝트를 생성합니다. 소스 디렉터리를 자동으로 분석해 Xcode의 그룹 구조에 반영하므로, 디스크에서 파일을 추가하거나 이동하면 Xcode에서 직접 수정하지 않아도 프로젝트에 적용됩니다.

.xcodeproj 파일은 필요할 때 다시 생성할 수 있으므로, 팀은 이 파일을 git에서 제외해 프로젝트 파일에서 흔히 발생하는 병합 충돌을 피할 수 있습니다. 명세를 여러 파일로 나눌 수 있고, 공유 빌드 설정 그룹을 사용하면 여러 타깃에서 같은 구성을 재사용할 수 있습니다. CI를 포함해 커맨드라인에서 생성 작업을 실행할 수 있습니다.

의존성으로 Swift Package Manager 패키지, Carthage 프레임워크, 시스템 SDK, 멀티플랫폼 프레임워크를 지원합니다. 해석된 명세를 여러 형식으로 출력할 수도 있으며, 변경 사항이 없으면 재생성을 건너뛰는 캐시 옵션도 제공합니다.

핵심 기능

  • 01YAML 또는 JSON 명세에서 Xcode 프로젝트를 생성하고, 폴더 구조에 맞춰 그룹을 동기화합니다.
  • 02.xcodeproj를 git에서 제외해 프로젝트 파일의 병합 충돌을 방지합니다.
  • 03빌드 설정 그룹으로 여러 타깃에서 빌드 설정을 공유합니다.
  • 04다양한 환경에 맞는 scheme을 자동으로 생성합니다.
  • 05공유 및 재정의를 위해 명세를 여러 파일로 나눕니다.
  • 06Swift 패키지, Carthage 프레임워크, SDK 의존성을 지원합니다.

활용 사례

  • iOS 또는 macOS 팀에서 병합 충돌을 피하기 위해 .xcodeproj 파일을 버전 관리에서 제외합니다.
  • 단일 명세를 바탕으로 CI 머신에서 Xcode 프로젝트를 생성합니다.
  • 타깃이 많고 빌드 설정을 공유하는 대규모 프로젝트를 관리합니다.
  • 템플릿 명세를 사용해 일관된 구성으로 새 프로젝트를 만듭니다.

빠른 시작

  1. 1

    최신 안정 버전의 Xcode가 설치되어 있는지 확인하세요

  2. 2

    Homebrew로 XcodeGen을 설치하세요

    brew install xcodegen
  3. 3

    현재 디렉터리에 있는 프로젝트 사양에서 Xcode 프로젝트를 생성하세요

    xcodegen generate

사용 전 알아둘 점

  • Xcode가 필요하므로 macOS에서의 Apple 플랫폼 개발에만 사용할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

XcodeGen은(는) 무엇인가요?
YAML 또는 JSON 프로젝트 명세와 폴더 구조를 바탕으로 Xcode 프로젝트를 생성하는 Swift 커맨드라인 도구입니다. XcodeGen은 타깃, 구성, scheme, 빌드 설정, 의존성을 정의하는 사람이 읽기 쉬운 명세 파일에서 Xcode 프로젝트를 생성합니다. 소스 디렉터리를 자동으로 분석해 Xcode의 그룹 구조에 반영하므로, 디스크에서 파일을 추가하거나 이동하면 Xcode에서 직접 수정하지 않아도 프로젝트에 적용됩니다.
XcodeGen은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
XcodeGen은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
XcodeGen은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. XcodeGen의 마지막 커밋은 2026년 10월 13일입니다.
XcodeGen은(는) 어디에 사용할 수 있나요?
iOS 또는 macOS 팀에서 병합 충돌을 피하기 위해 .xcodeproj 파일을 버전 관리에서 제외합니다. 단일 명세를 바탕으로 CI 머신에서 Xcode 프로젝트를 생성합니다. 타깃이 많고 빌드 설정을 공유하는 대규모 프로젝트를 관리합니다. 템플릿 명세를 사용해 일관된 구성으로 새 프로젝트를 만듭니다.
XcodeGen는 어떻게 설치하나요?
최신 안정 버전의 Xcode가 설치되어 있는지 확인하세요 Homebrew로 XcodeGen을 설치하세요: brew install xcodegen 현재 디렉터리에 있는 프로젝트 사양에서 Xcode 프로젝트를 생성하세요: xcodegen generate
XcodeGen은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yonaskolb/XcodeGen

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트