跳至內容

Bazel 預覽

從你現有的 Bazel target 發布 Android APK、Apple 模擬器與 macOS 應用程式,以及命令列工具。為每個你想分享的輸出新增一個預覽 target;你的一般建置流程保持不變。

設定#

將 rules_tuist(來自 Tuist 儲存庫) 加入 MODULE.bazel,並鎖定你要使用的 commit:

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",
)

保留你現有的應用程式 target、原生 SDK 與簽署設定。Bazel 會提供發布工具。

直接從 Bazel 登入:

bash
bazel run @rules_tuist//:login

這會與 Tuist CLI 和 Gradle 外掛程式共用憑證;已有的登入狀態亦可直接使用。在 CI 上,請使用 TUIST_TOKEN,或透過 Tuist 的 OIDC 驗證 執行登入 target。切勿將憑證放入 BUILD 檔案或規則屬性中。傳遞 -- --url https://tuist.example.com 以登入自託管實例。

僅在你的 BUILD.bazel 中載入你需要的 adapter:

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")

針對可執行 target(例如 cc_binary):

plaintext
load("@rules_tuist//:executable.bzl", "executable_preview")
executable_preview(name = "preview_cli", binary = ":my_tool")

可執行預覽包含該 target 宣告的執行階段檔案。在你的 Bazel target 中宣告你的工具所需的函式庫與資源,並使用在建置目錄之外也能運作的路徑。

建置與發布#

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 commit,請傳遞 --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: 以 ad-hoc 方式簽署的模擬器與 macOS 應用程式,需在 macOS 上建置並驗證。不支援實體裝置建置、framework、擴充元件與測試。請使用 archive 輸出,而非實驗性的 tree archive。
  • 命令列工具: 適用於 arm64 或 x86_64 的 macOS 或 Linux 可執行檔,包括通用 macOS 二進位檔。腳本需要在接收者的系統上具備 shebang 與直譯器。請在你的 target 中宣告執行階段相依性;Tuist 不會安裝缺少的函式庫或語言執行環境。

快取重放、失敗與保留#

重複相同的發布會重用現有的預覽,而不會再次上傳,即使 Bazel 從快取還原建置亦然。變更輸出、track 或 revision 會建立新的發布。上傳失敗會導致命令失敗;你可以重新執行以確認發布是否已完成,再嘗試一次。

該命令會連結到你專案的預覽,處理可能需要一點時間。預覽會使用專案的預設可見性。

在託管的 Tuist 上,構件發布會在 30 天後過期。自託管實例使用 TUIST_APP_PREVIEW_RETENTION_DAYS;若不設定,則此類別的過期機制會被停用。已過期的發布記錄無法透過重放相同的意圖來恢復。

請參閱 執行預覽,了解如何執行已發布的建置、存取權限、track 與 README 徽章。

Apple 預覽#

關於 Apple 模擬器與 macOS 預覽,請參閱 Tuist macOS companion app 說明。這些不會改變 Bazel 的應用程式資格或簽署要求。

相關工作流程#

現有的 Once 整合有獨立的 構件發布指南。兩種工作流程都將發布與快取的圖形執行分開。