コンテンツへスキップ

Bazel プレビュー

既存の Bazel ターゲットから、Android APK、Apple シミュレーターおよび macOS アプリ、コマンドラインツールを公開します。共有したい出力ごとにプレビューターゲットを追加してください。通常のビルドは変更されません。

セットアップ#

Tuist リポジトリから rules_tuist を追加 し、使用するコミットを MODULE.bazel にピン留めします:

plaintext
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 の OIDC 認証 を使ってログインターゲットを実行してください。BUILD ファイルやルール属性に認証情報を含めないでください。-- --url https://tuist.example.com を渡して、セルフホストインスタンスにサインインします。

BUILD.bazel で必要なアダプターのみを読み込みます:

plaintext
load("@rules_tuist//:android.bzl", "android_preview")
android_preview(name = "preview_android", app = ":android_app")

Apple アプリケーションの場合:

plaintext
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 などの実行可能ターゲットの場合:

plaintext
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 バッジについては、プレビューを実行する を参照してください。

Apple プレビュー#

Apple シミュレーターおよび macOS プレビューについては、Tuist macOS コンパニオンアプリの手順 を参照してください。これらは Bazel のアプリケーション対象条件や署名要件を変更しません。

関連するワークフロー#

既存の Once 統合には、別の アーティファクト公開ガイド があります。どちらのワークフローも、公開をキャッシュされたグラフ実行から分離したままにします。