# Bazel 프리뷰

기존 Bazel 타겟에서 Android APK, Apple 시뮬레이터 및 macOS 앱, 그리고 명령줄 도구를 배포하세요. 공유하려는 각 출력물에 대해 프리뷰 타겟을 추가하면 일반 빌드는 변경되지 않습니다.

## 설정

Tuist 리포지토리의 [`rules_tuist`](https://github.com/tuist/tuist/tree/main/bazel)를 `MODULE.bazel`에 추가하고 사용할 커밋을 고정하세요:

```starlark
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에서 직접 로그인하세요:

```bash
bazel run @rules_tuist//:login
```

이 과정은 Tuist CLI 및 Gradle 플러그인과 자격 증명을 공유하며, 기존 로그인 상태도 유효합니다. CI 환경에서는 `TUIST_TOKEN`을 사용하거나 Tuist의 <.localized_link href="/guides/integrations/continuous-integration">OIDC 인증</.localized_link>으로 로그인 타겟을 실행하세요. BUILD 파일이나 규칙 속성에 자격 증명을 절대 포함하지 마세요. 자체 호스팅 인스턴스에 로그인하려면 `-- --url https://tuist.example.com`을 전달하세요.

`BUILD.bazel`에서 필요한 어댑터만 로드하세요:

```starlark
load("@rules_tuist//:android.bzl", "android_preview")

android_preview(name = "preview_android", app = ":android_app")
```

Apple 애플리케이션용:

```starlark
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`와 같은 실행 가능 타겟용:

```starlark
load("@rules_tuist//:executable.bzl", "executable_preview")

executable_preview(name = "preview_cli", binary = ":my_tool")
```

실행 가능 프리뷰에는 타겟에 선언된 런타임 파일이 포함됩니다. 도구에 필요한 라이브러리와 리소스를 Bazel 타겟에 선언하고, 빌드 디렉터리 외부에서도 작동하는 경로를 사용하세요.

## 빌드 및 배포

```bash
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 배지에 대해서는 <.localized_link href="/guides/features/previews#run-a-preview">프리뷰 실행</.localized_link>을 참조하세요.

## Apple 프리뷰

Apple 시뮬레이터 및 macOS 프리뷰의 경우 <.localized_link href="/guides/features/previews/run/macos">Tuist macOS 동반 앱 지침</.localized_link>을 참조하세요. 이는 Bazel의 애플리케이션 자격 조건이나 서명 요구 사항을 변경하지 않습니다.

## 관련 워크플로 {#publish-from-once}

기존 Once 통합에는 별도의 <.localized_link href="/guides/features/previews/once">아티팩트 배포 가이드</.localized_link>가 있습니다. 두 워크플로 모두 배포를 캐시된 그래프 실행과 분리하여 유지합니다.
