Tuist 사용했던 프젝을 열고 싶었을 뿐인데

hyun·2025년 5월 21일
2

iOS

목록 보기
20/54

Tuist 사용했던 옛날 프로젝트를 돌려보고 싶어서 git clone 후에

tuist fetch

명령어를 입력했는데 에러가 뜨지 모얌..

 Tuist

Xcode 프로젝트 생성을 자동화해주는 도구
쉽게 말해, 복잡한 .xcodeproj나 .xcworkspace 파일을 직접 만지지 않아도
코드로 정의한 설정 파일을 기반으로 자동으로 Xcode 프로젝트를 만들어주는 툴임

기존의 Xcode 프로젝트(.xcodeproj)는 사람이 직접 만들고 설정을 일일이 해줘야 하는데
이게 팀 프로젝트나 모듈이 많아질수록 매우 복잡하고 실수가 잦아지는데, Tuist로 이런 문제점을 해결할 수 있음

코드로 프로젝트 구조를 선언 가능 (Swift 문법으로)

Xcode 프로젝트를 자동 생성해줌

모듈화를 쉽게 지원함 (대규모 앱에서 유용)

빌드 속도 개선에도 도움됨

협업할 때 충돌 적음 (기존 .xcodeproj 파일은 Git 충돌 자주 남)

구조 예시

MyApp/
├── Project.swift        ← 프로젝트 설정 파일 (Swift 코드)
├── Tuist/Tuist 관련 설정 디렉토리
│   └── Config.swift     ← 전역 설정 등
├── App/
│   └── Sources/
└── ...

Project.swift에서 이런 식으로 설정함

import ProjectDescription

let project = Project(
  name: "MyApp",
  targets: [
    Target(
      name: "MyApp",
      platform: .iOS,
      product: .app,
      bundleId: "com.example.myapp",
      sources: ["Sources/**"]
    )
  ]
)

그리고 터미널에서 tuist generate 명령어만 실행하면…

👉 Xcode 프로젝트가 자동 생성됨!

자주 쓰는 명령어

명령어설명
tuist init새 Tuist 프로젝트 초기화
tuist fetch외부 패키지 의존성 가져오기
tuist generate.xcodeproj 자동 생성
tuist editTuist 설정용 Xcode 프로젝트 열기

tuist fetch
tuist generate

아는 게 이 두 개 뿐이라 generate도 해봤는데 안 돼서
에러 메시지 구글링 해봤더니 Swift toolchain이 꼬인 것 같다길래
정상적인 경로 (/Applications/Xcode.app/...)가 아니라 그랬나 ? 싶어서

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcode-select --install
sudo xcodebuild -license
tuist generate

이렇게 해봤는데 왜 안 되니...

xcrun: error: unable to find utility "swift", not a developer tool or in PATH

Consider creating an issue using the following link: https://github.com/tuist/tuist/issues/new/choose

이런 새로운 에러가 짜잔 ! 하길래 또 구글링 해보니
Xcode가 제대로 설치되지 않았거나 명령줄 도구(Command Line Tools) 설정이 꼬였을 때 발생하는 전형적인 문제라고 하는데,, 똑같이 다시 시도해봤더니 또 !! 새로운 에러가 떠서 결국 gpt 행..

Xcode가 macOS 14.2 SDK를 찾으려 하는데, 그 SDK가 실제로 /Applications/Xcode.app/... 경로에 없어서 에러가 뜬 거라고 함

설치된 Xcode 버전이 macOS 14.2 SDK를 지원하지 않거나,

Xcode가 부분적으로 손상됐거나,

여러 Xcode 버전이 설치되어 꼬였을 때 에러가 뜬다고 하는데....

못 해먹겠어서 Xcode를 떠나보내기로 함.

그냥 단순하게 Xcode가 꼬인거면 지우고 새로 깔면 되지. 라는 생각이었음

 Xcode 재설치

완전히 삭제 후 재설치

sudo rm -rf /Applications/Xcode.app

터미널에 이 코드를 이용해서 Xcode를 없애고
App Store에서 다시 설치함.

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

경로를 지정해주고 파일을 여니까 드디어 열림 !!
근데 코드는 안 돌아가길래 뭐지 싶었음.


근데 문제는 여기서 끝이 아니었음..

전에 작업하던 파일이 실행되지 않게 됨.. 원래 잘 돌아가던 코드였기에 그냥 바로 헬프미를 외침

거기서도 xcode를 재설치해야 한다는 결론이 나옴...!

음.. 그럼 아까 그 Tuist 프로젝트가 또 안 열리는 거 아닌가.. 싶었지만, 그냥 한 번 더 해보지 뭐. 라는 마음으로 삭제하고 설치하는 것 까지 도움을 받았는데

Finder 👉 응용 프로그램 👉 Xcode 👉 휴지통으로 이동

휴지통까지 다 비우고 재설치 한 뒤에 프로젝트 열어보니 잘 해결됨 !
Tuist 프로젝트 파일도 아까처럼 코드는 안 돌아가지만 무사히 잘 열림. 🥹

0개의 댓글