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,并传递 --revision 以关联 Git 提交。
传递 --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 应用,需在 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 集成有单独的 构件发布指南。这两种工作流都将发布与缓存图执行分开。