Once 預覽
Once 可將應用程式構件發布至 Tuist,讓團隊成員無需在本機重新建置即可試用該版本。此功能需要 Once 0.74.0+ 以及具備構件接收器的 Tuist 伺服器。Once 0.73.x 則改用舊版的單一負載配接器。
設定目的地#
完成開始使用 Once,然後在工作區的 once.toml 中加入構件綁定。若提供者已設定用於快取,請直接复用:
[infrastructures.tuist]
kind = "tuist"
account = "acme"
project = "app"
[infrastructure.artifacts]
name = "tuist"
once auth login --provider tuist
once artifact publish MyApplication --track review
接收器會保留完整集合、成員清單與負載,包括未知的介面。支援的原生介面會依據專案的預設可見性、存取權限與分發設定,以非同步方式投影為預覽。一般構件內容仍維持私密,即使在公開專案中亦然。收據僅確認構件已儲存,不代表預覽處理已完成;其 URL 會開啟專案的預覽清單。
符合資格的應用程式#
Apple 投影接受 dev.once.apple-install.v2 中繼資料,適用於在 macOS 上匯出的臨時簽署 macOS 與模擬器應用程式。實體裝置應用程式不符合資格。Android 投影接受帶有已驗證簽章的 dev.once.android-install.v1 中繼資料。Once 僅核准自動發布除錯簽署且非檢測用的 APK。未知介面仍可作為構件下載,但不會建立預覽。Android 安裝連結會保留 .apk 檔名,即使負載是儲存在內容摘要之下。
選擇在建置後發布#
[infrastructure]
publish_on_build = ["MyApplication"]
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 companion app 說明。實體裝置應用程式仍不符合 Once 發布資格。