콘텐츠로 이동

Gradle 프리뷰

Gradle에서 직접 Android 앱과 네이티브 명령줄 도구를 빌드하고 공유하세요. 프로젝트를 연결하고 인증하려면 Gradle 프로젝트 가이드부터 시작하세요.

Android 앱#

bash
./gradlew :app:tuistShareDebug

dev.tuist 설정 플러그인은 Android Gradle Plugin(8.8.2 이상)의 각 애플리케이션 변형(variant)에 대해 tuistShare<Variant> 태스크를 등록합니다. app와 Debug를 애플리케이션 모듈과 변형으로 바꾸세요. 예를 들어 제품 flavor에는 :app:tuistShareDemoDebug를 사용합니다. 이 태스크는 APK를 게시하기 전에 Gradle이 선언한 아티팩트 종속성을 통해 빌드합니다. 빌드 출력이 최신 상태이거나 빌드 캐시에서 복원된 경우에도 작동합니다.

서명된 단일 범용 애플리케이션 APK만 지원됩니다. Android의 디버그 변형은 일반적으로 디버그 서명 키를 사용하며, 릴리스 변형에는 자체 서명 구성이 필요합니다. 이 태스크는 인증 또는 업로드 전에 APK 서명을 검증합니다. 서명되지 않았거나 유효하지 않은 APK, 인스트루멘테이션 APK, 분할 APK는 거부됩니다. 라이브러리 모듈, 테스트 APK, Android App Bundle(.aab)은 게시 대상이 아닙니다.

네이티브 명령줄 도구#

Gradle의 cpp-application 또는 swift-application 플러그인을 사용하는 프로젝트는 각 네이티브 바이너리에 대해 공유 태스크를 제공합니다.

bash
./gradlew :app:tuistShareMainDebug

이 태스크는 런처와 런타임 라이브러리를 포함하여 설치된 배포판을 빌드하고 패키징합니다. 릴리스 바이너리에는 tuistShareMainRelease를 사용하세요. 여러 머신을 대상으로 하는 프로젝트는 각 바이너리마다 태스크가 있으며, ./gradlew :app:tasks --all를 실행하여 이름을 찾을 수 있습니다.

arm64 또는 x86_64용 네이티브 macOS 및 Linux 실행 파일이 지원됩니다. Gradle 플러그인이 요구하는 툴체인을 사용하여 대상 플랫폼에서 빌드하세요. JVM 애플리케이션과 생성된 런처 스크립트는 이 통합에서 지원되지 않습니다.

게시 동작#

공유 태스크는 Tuist CLI를 호출하지 않고 플러그인의 기존 Tuist 자격 증명을 사용하여 게시합니다. 일반적인 assemble, build 및 테스트 태스크는 프리뷰를 게시하지 않습니다.

공유 후 프로젝트에서 프리뷰를 열어 링크를 복사하세요. 동일한 빌드와 트랙을 다시 공유하면 빌드 캐시 히트 후에도 게시를 재사용합니다. 업로드가 실패하거나 확인되지 않으면 공유 태스크가 실패하며, 성공적인 프리뷰로 보고되지 않습니다.

CI 및 트랙#

플러그인의 다른 인증된 기능에 사용하는 것과 동일한 자격 증명으로 CI 인증을 구성한 다음 명시적으로 게시를 요청하세요.

bash
./gradlew :app:tuistShareDebug --track nightly

동일한 방식으로 네이티브 공유 태스크에 --track nightly를 추가하세요. 태스크는 구성된 Tuist 프로젝트, 서버 URL 및 프록시 설정을 사용합니다. 프리뷰 게시에는 항상 인증이 필요합니다. Git 리비전 메타데이터, 릴리스 노트, 자동 풀 리퀘스트 댓글은 이러한 태스크에 첨부되지 않습니다.

호스팅된 Tuist에서는 아티팩트 게시물이 30일 후에 만료됩니다. 자체 호스팅 인스턴스는 TUIST_APP_PREVIEW_RETENTION_DAYS를 사용합니다. 이 값을 설정하지 않으면 이 계열의 만료가 비활성화됩니다. 만료된 게시물은 동일한 의도를 반복해서 복구할 수 없습니다.

기존 APK 공유#

이 워크플로우 외부에서 빌드된 APK의 경우 또는 레거시 업로드 흐름으로 릴리스 노트를 포함하려면 CLI를 계속 사용할 수 있습니다.

bash
tuist share app/build/outputs/apk/debug/app-debug.apk \
--track nightly --release-notes "Improve checkout"

게시된 빌드 실행, 액세스, 트랙 및 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"
}