Bazel 프리뷰
기존 Bazel 타겟에서 Android APK, Apple 시뮬레이터 및 macOS 앱, 그리고 명령줄 도구를 배포하세요. 공유하려는 각 출력물에 대해 프리뷰 타겟을 추가하면 일반 빌드는 변경되지 않습니다.
설정#
Tuist 리포지토리의 rules_tuist를 MODULE.bazel에 추가하고 사용할 커밋을 고정하세요:
bazel_dep(name = "rules_tuist")
git_override(
module_name = "rules_tuist",
remote = "https://github.com/tuist/tuist.git",
commit = "FULL_COMMIT_SHA",
strip_prefix = "bazel",
)
기존 애플리케이션 타겟, 네이티브 SDK 및 서명 설정은 그대로 유지하세요. Bazel이 배포 도구를 제공합니다.
Bazel에서 직접 로그인하세요:
bazel run @rules_tuist//:login
이 과정은 Tuist CLI 및 Gradle 플러그인과 자격 증명을 공유하며, 기존 로그인 상태도 유효합니다. CI 환경에서는 TUIST_TOKEN을 사용하거나 Tuist의 OIDC 인증으로 로그인 타겟을 실행하세요. BUILD 파일이나 규칙 속성에 자격 증명을 절대 포함하지 마세요. 자체 호스팅 인스턴스에 로그인하려면 -- --url https://tuist.example.com을 전달하세요.
BUILD.bazel에서 필요한 어댑터만 로드하세요:
load("@rules_tuist//:android.bzl", "android_preview")
android_preview(name = "preview_android", app = ":android_app")
Apple 애플리케이션용:
load("@rules_tuist//:apple.bzl", "apple_preview")
apple_preview(name = "preview_ios", app = ":ios_app")
apple_preview(name = "preview_macos", app = ":macos_app")
cc_binary와 같은 실행 가능 타겟용:
load("@rules_tuist//:executable.bzl", "executable_preview")
executable_preview(name = "preview_cli", binary = ":my_tool")
실행 가능 프리뷰에는 타겟에 선언된 런타임 파일이 포함됩니다. 도구에 필요한 라이브러리와 리소스를 Bazel 타겟에 선언하고, 빌드 디렉터리 외부에서도 작동하는 경로를 사용하세요.
빌드 및 배포#
bazel run //:preview_android -- \
--publish --project acme/app --track review
bazel run //:preview_ios --platforms=//platforms:ios_simulator -- \
--publish --project acme/app --track review
bazel run //:preview_macos -- --publish --project acme/app --track review
bazel run //:preview_cli -- --publish --project acme/app --track review
애플리케이션 및 시뮬레이터 플랫폼 라벨을 자신의 것으로 교체하세요. 자체 호스팅 Tuist 오리진을 위해 --url을 전달하고 Git 커밋을 연결하려면 --revision을 전달하세요.
성공한 빌드를 공유하려면 --publish --project account/project을 전달하세요. --publish 없이 또는 --no-publish과 함께 실행하면 아무 것도 업로드되지 않으며 로그인도 필요하지 않습니다. 일반적인 bazel build은 캐시 히트 경우를 포함하여 절대 배포하지 않습니다. tuist bazel setup는 캐싱과 인사이트를 활성화하지만 배포는 하지 않습니다.
지원되는 출력물#
- Android: 디버그 빌드를 포함한 서명된 애플리케이션 APK. Android SDK 빌드 도구 및 명령줄 도구를 설치하고
ANDROID_HOME또는ANDROID_SDK_ROOT을 설정하세요. 테스트 APK와 Android App Bundle은 지원되지 않습니다. - Apple: macOS에서 빌드되고 검증된 ad-hoc 서명된 시뮬레이터 및 macOS 애플리케이션. 물리 장치 빌드, 프레임워크, 확장 프로그램 및 테스트는 지원되지 않습니다. 실험적 트리 아카이브 대신 아카이브 출력을 사용하세요.
- 명령줄 도구: arm64 또는 x86_64용 macOS 또는 Linux 실행 파일(범용 macOS 바이너리 포함). 스크립트는 수신자 시스템에 shebang과 인터프리터가 필요합니다. 타겟에 런타임 종속성을 선언하세요. Tuist는 누락된 라이브러리나 언어 런타임을 설치하지 않습니다.
캐시 재사용, 실패 및 보존#
동일한 배포를 반복하면 Bazel이 캐시에서 빌드를 복원하더라도 기존 프리뷰를 다시 업로드하지 않고 재사용합니다. 출력물, 트랙 또는 리비전을 변경하면 새로운 배포가 생성됩니다. 업로드 실패 시 명령이 실패하며, 다시 시도하기 전에 배포가 완료되었는지 확인하기 위해 명령을 다시 실행할 수 있습니다.
명령은 프로젝트의 프리뷰로 링크되며, 여기서 처리에는 잠시 시간이 걸릴 수 있습니다. 프리뷰는 프로젝트의 기본 가시성을 사용합니다.
호스팅된 Tuist에서는 아티팩트 배포가 30일 후에 만료됩니다. 자체 호스팅 인스턴스는 TUIST_APP_PREVIEW_RETENTION_DAYS을 사용합니다. 이 값을 설정하지 않으면 이 계열의 만료가 비활성화됩니다. 만료된 배포 기록은 동일한 의도를 다시 실행하여 복구할 수 없습니다.
배포된 빌드 실행, 액세스, 트랙 및 README 배지에 대해서는 프리뷰 실행을 참조하세요.
Apple 프리뷰#
Apple 시뮬레이터 및 macOS 프리뷰의 경우 Tuist macOS 동반 앱 지침을 참조하세요. 이는 Bazel의 애플리케이션 자격 조건이나 서명 요구 사항을 변경하지 않습니다.
관련 워크플로#
기존 Once 통합에는 별도의 아티팩트 배포 가이드가 있습니다. 두 워크플로 모두 배포를 캐시된 그래프 실행과 분리하여 유지합니다.