콘텐츠로 이동

Xcode 미리보기

애플리케이션을 빌드한 후 tuist share를 사용하여 Tuist 프로젝트에 게시하세요. 먼저 기존 Xcode 프로젝트 또는 생성된 프로젝트 가이드를 따라 프로젝트를 연결하세요.

빌드 및 공유#

Tuist로 생성된 프로젝트의 경우:

bash
tuist generate App
tuist xcodebuild build -scheme App -workspace App.xcworkspace \
-configuration Debug -sdk iphonesimulator
tuist share App

기존 Xcode 프로젝트의 경우:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -sdk iphonesimulator
tuist share App --configuration Debug --platforms iOS

스킴, 프로젝트 및 워크스페이스 이름을 자신의 것으로 바꾸세요. 릴리스 빌드를 공유하려면 빌드할 때 -configuration Release를 사용하고 공유할 때 --configuration Release를 사용하세요.

실제 기기#

수신자의 기기에 설치할 수 있는 프로비저닝 프로필로 기기 빌드에 서명하는 책임은 귀하에게 있습니다. 시뮬레이터 SDK 대신 기기 대상을 사용하여 빌드하세요:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -destination 'generic/platform=iOS'
tuist share App --configuration Debug --platforms iOS

이미 내보낸 IPA도 공유할 수 있습니다:

bash
tuist share App.ipa

수신자는 모바일 기기에서 IPA 미리보기 링크를 열어 애플리케이션을 설치할 수 있습니다. 인증과 프로젝트의 미리보기 공개 설정은 여전히 적용됩니다.

CI 및 빌드 번호#

기존 CI 인증을 사용하고 각 새 빌드마다 CFBundleVersion를 고유하게 만드세요. 예를 들어 GitHub Actions의 ${{ github.run_number }}를 사용하세요. 동일한 바이너리와 빌드 번호를 tuist share를 통해 다시 업로드하면 중복이 생성되지 않고 실패합니다.

bash
tuist share App --track beta --release-notes "Fix sign-in"

게시된 빌드 실행, 접근 권한, 트랙 및 README 배지에 대해서는 미리보기 실행을 참조하세요.

{#share-tracks}와 함께 tuist share로 트랙 관리#

tuist share를 사용하여 배포하는 워크플로우에서는 --track를 사용해 트랙을 선택하세요:

bash
tuist share App --track beta
tuist share App --track nightly

릴리스 노트#

환경 그룹에는 트랙을, 개별 빌드의 목적에는 릴리스 노트를 사용하세요:

bash
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"

App를 앱 이름, 애플리케이션 파일 경로 또는 실행 파일 배포 및 해당 --executable 옵션으로 대체하세요. 릴리스 노트는 최대 10,000자까지 입력할 수 있는 선택 사항인 일반 텍스트입니다. 첫 번째 비어 있지 않은 줄은 미리보기 목록에서 한 줄 스니펫으로 표시되므로 빌드 번호와 기타 식별 정보를 한눈에 확인할 수 있습니다. 긴 줄은 잘리며, 전체 노트는 상세 페이지에 표시됩니다. 검색 결과는 스니펫에 표시되지 않는 줄을 포함하여 표시 이름과 전체 릴리스 노트와 일치합니다. 여러 줄 노트도 지원되며, 예를 들어 --release-notes "$(< release-notes.txt)"와 같이 사용할 수 있습니다. 이러한 노트는 앱의 표시 이름이나 트랙을 변경하지 않습니다.

호환성#

릴리스 노트는 빌드가 속한 미리보기를 변경하지 않습니다. 미리보기가 받은 첫 번째 노트가 유지됩니다. 이후 업로드에서는 노트가 없는 미리보기에 노트를 추가할 수 있지만, 기존 노트를 덮어쓰거나 지울 수는 없습니다. 릴리스 노트 기능이 존재하기 전에 업로드된 미리보기는 노트 없이도 유효하게 유지됩니다.

셀프 호스팅 배포에는 릴리스 노트와 트랙 필터링을 지원하는 서버 버전과 업데이트된 클라이언트가 필요합니다. 이전 서버는 노트를 무시합니다. 목록 엔드포인트의 트랙 및 검색 필터에 대해서는 API 참조를 확인하세요.

풀/머지 요청 댓글#

Git 포지 통합 필요

자동 풀/머지 요청 댓글을 받으려면 원격 프로젝트를 Git 포지와 통합하세요: GitHub, Cursor Origin 또는 Entire.

Tuist 프로젝트가 Git 플랫폼과 연결되면 CI에서 애플리케이션 빌드가 성공한 후 tuist share를 추가하세요. Tuist는 풀/머지 요청에 미리보기 링크를 직접 게시하므로, 리뷰어가 로컬에서 빌드하지 않고도 테스트할 수 있습니다:

Tuist Preview 링크가 포함된 GitHub 앱 댓글

자동화#

tuist share에서 JSON 출력을 얻으려면 --json를 사용하세요:

bash
tuist share --json

CI에서 Slack 메시지를 게시하는 등 custom 자동화에 결과를 활용하세요. url 키에는 전체 미리보기 링크가 포함되며, qrCodeURL는 기기에서 미리보기를 열기 위한 QR 코드 이미지를 가리킵니다:

json
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}

수신자는 빌드 시스템 통합과 무관하게 Tuist macOS 앱 또는 iPhone 앱을 사용할 수 있습니다. iPhone 가이드에는 Tuist SDK를 사용한 앱 내 업데이트 알림도 포함되어 있습니다.