跳至内容

Once 预览

Once 可以将应用构件发布到 Tuist,让团队成员无需在本地重新构建即可试用某个构建版本。这需要 Once 0.74.0+ 以及配备构件接收器的 Tuist 服务器。Once 0.73.x 则使用旧版的单载荷适配器。

配置目标地址#

完成Once 入门指南,然后在工作区的 once.toml 中添加构件绑定。如果提供者已为缓存配置过,可直接复用:

toml
[infrastructures.tuist]
kind = "tuist"
account = "acme"
project = "app"
[infrastructure.artifacts]
name = "tuist"
bash
once auth login --provider tuist
once artifact publish MyApplication --track review

接收器会保留完整的集合、成员清单和载荷,包括未知接口。受支持的原生接口会根据项目的默认可见性、访问权限和分发设置,异步投影为预览。通用构件内容保持私有,即使在公开项目中也是如此。回执仅确认构件已存储,并不表示预览处理已完成;其 URL 会打开项目的预览列表。

符合条件的应用#

Apple 投影接受用于在 macOS 上导出的临时签名 macOS 和模拟器应用的 dev.once.apple-install.v2 元数据。真机应用不符合条件。Android 投影接受带有已验证签名的 dev.once.android-install.v1 元数据。Once 仅批准自动发布经过调试签名且非插桩的 APK。未知接口仍可作为构件下载,但不会创建预览。Android 安装链接会保留 .apk 文件名,尽管载荷是按内容摘要存储的。

选择在构建后发布#

toml
[infrastructure]
publish_on_build = ["MyApplication"]
bash
once artifact publish MyApplication --allow-on-build
once build MyApplication

所有请求的构建都必须成功。自动发布还需要生产者对整个闭包的批准,以及针对此机器、工作区、确切端点、目标和稳定 Tuist 项目目标的本地授权。如果没有策略或授权,就不会发出构件发布的网络请求。普通的 Once 构建不会产生隐式发布的副作用。

重放相同的已保留发布会验证远程回执并避免再次上传。这与 tuist share 的重复构建行为不同。

保留期#

在托管的 Tuist 上,构件发布会在 30 天后过期。自托管实例使用 TUIST_APP_PREVIEW_RETENTION_DAYS;不设置该变量将禁用此类族的过期机制。过期记录会作为墓碑保留,无法通过重放相同意图来重新激活。现有的 tuist share 签名、可见性和分发工作流保持不变。

请参阅运行预览,了解如何运行已发布的构建、管理访问权限、跟踪分支以及在 README 中添加徽章。

Apple 预览#

对于符合条件的 Apple 模拟器和 macOS 预览,请参阅Tuist macOS 配套应用说明。真机应用仍然不符合 Once 发布条件。