Gradle 預覽
直接從 Gradle 構建並分享 Android 應用程式及原生命令列工具。請先參閱Gradle 專案指南以連接專案並進行身份驗證。
Android 應用程式#
./gradlew :app:tuistShareDebug
dev.tuist設定外掛程式會為 Android Gradle Plugin(8.8.2 或更高版本)中的每個應用程式變體註冊一個tuistShare<Variant>任務。將app和Debug替換為你的應用程式模組和變體,例如產品風格可使用:app:tuistShareDemoDebug。該任務在發布之前,會透過 Gradle 宣告的工件依賴關係來構建 APK。當構建輸出已是最新狀態或從構建快取中恢復時,此任務同樣有效。
僅支援單一、已簽署的通用應用程式 APK。Android 的 debug 變體通常使用 debug 簽署金鑰;release 變體則需要你自己的簽署設定。該任務會在身份驗證或上傳前驗證 APK 簽名。未簽署、無效、instrumentation 以及分割 APK 均會被拒絕。函式庫模組、測試 APK 和 Android App Bundles(.aab)並非發布目標。
原生命令列工具#
使用 Gradle 的cpp-application或swift-application外掛程式的專案,會為每個原生二進制檔案獲得一個分享任務:
./gradlew :app:tuistShareMainDebug
該任務會構建並打包已安裝的分發套件,包括其啟動器和執行時函式庫。對於 release 二進制檔案,請使用tuistShareMainRelease。針對多部機器的專案會為每個二進制檔案提供一個任務;執行./gradlew :app:tasks --all以查找它們的名稱。
支援 arm64 或 x86_64 的原生 macOS 和 Linux 可執行檔。請在目標平台上,使用 Gradle 外掛程式所需的工具鏈進行構建。此整合不支援 JVM 應用程式及其產生的啟動器腳本。
發布行為#
分享任務會使用外掛程式現有的 Tuist 憑證進行發布,無需呼叫 Tuist CLI。一般的assemble、build和測試任務絕不會發布預覽。
分享後,請在專案中開啟預覽以複製連結。重複分享相同的構建和軌道會重用其發布內容,包括在快取命中之後。失敗或未確認的上傳會導致分享任務失敗;它們不會被報告為成功的預覽。
CI 與軌道#
使用與外掛程式其他需要身份驗證的功能相同的憑證來設定CI 身份驗證,然後明確請求發布:
./gradlew :app:tuistShareDebug --track nightly
以相同方式將--track nightly添加到原生分享任務中。任務會使用已設定的 Tuist 專案、伺服器 URL 和代理設定。預覽發布始終需要身份驗證。Git 修訂元數據、發布說明和自動拉取請求評論不會由這些任務附加。
在託管的 Tuist 上,工件發布會在 30 天後過期。自託管實例使用TUIST_APP_PREVIEW_RETENTION_DAYS;若不設定則會停用此類別的過期機制。已過期的發布無法透過重複相同意圖來恢復。
分享現有 APK#
對於在此工作流程之外構建的 APK,或希望在舊版上傳流程中包含發布說明,CLI 仍然可用:
tuist share app/build/outputs/apk/debug/app-debug.apk \
--track nightly --release-notes "Improve checkout"
請參閱執行預覽以了解如何執行已發布的構建、存取權限、軌道以及 README 徽章。
使用 tuist share 嘅追蹤頻道#
對於使用 tuist share 發佈嘅工作流程,請使用 --track 選擇追蹤頻道:
tuist share App --track beta
tuist share App --track nightly
版本說明#
為個別構建使用追蹤頻道來分組環境,並使用版本說明:
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"
將 App 替換為你嘅應用程式名稱、應用程式檔案路徑或可執行分發及其 --executable 選項。版本說明係選用嘅純文字,最多 10,000 個字符。第一行非空白行會以單行摘要形式出現喺預覽列表中,因此構建編號同其他識別資訊可以一目了然。長行會被截斷;完整說明會顯示喺詳細頁面。搜尋結果會匹配顯示名稱同完整版本說明,包括摘要中未顯示嘅行。支援多行說明,例如 --release-notes "$(< release-notes.txt)"。佢哋不會更改應用程式嘅顯示名稱或其追蹤頻道。
兼容性#
版本說明不會更改構建所屬嘅預覽。預覽收到嘅第一組說明會被保留:後續上傳可以為沒有說明嘅預覽添加說明,但不能覆蓋或清除現有說明。喺版本說明功能存在之前上傳嘅預覽仍然有效,無需說明。
自託管部署需要支援版本說明同追蹤頻道過濾嘅伺服器版本,以及更新咗嘅客戶端。較舊嘅伺服器會忽略說明。有關列表端點嘅追蹤頻道同搜尋過濾器,請參閱 API 參考。
拉取/合併請求評論#
要獲取自動拉取/合併請求評論,請將你嘅 遠程項目 與 Git 平台整合:GitHub、Cursor Origin 或 Entire。
一旦你嘅 Tuist 項目與你嘅 Git 平台連接,請喺 CI 中成功構建應用程式後添加 tuist share。Tuist 會直接喺你嘅拉取/合併請求中發佈預覽連結,以便審查者無需本地構建即可測試:

自動化#
使用 --json 從 tuist share 獲取 JSON 輸出:
tuist share --json
使用結果進行自定義自動化,例如從 CI 發佈 Slack 消息。url 鍵包含完整預覽連結;qrCodeURL 指向用於喺設備上打開預覽嘅 QR 碼圖像:
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}