# 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 の build-tools およびコマンドラインツールをインストールし、`ANDROID_HOME` または `ANDROID_SDK_ROOT` を設定してください。テスト APK および Android App Bundle はサポートされていません。
- **Apple:** macOS でビルドおよび検証された、アドホック署名付きのシミュレーターおよび macOS アプリケーション。物理デバイス用ビルド、フレームワーク、エクステンション、テストはサポートされていません。実験的な tree アーカイブではなく、アーカイブ出力を使用してください。
- **コマンドラインツール:** 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> があります。どちらのワークフローも、公開をキャッシュされたグラフ実行から分離したままにします。
