# Gradle 預覽

直接從 Gradle 構建並分享 Android 應用程式及原生命令列工具。請先參閱<.localized_link href="/guides/get-started/gradle-project">Gradle 專案指南</.localized_link>以連接專案並進行身份驗證。

## Android 應用程式

```bash
./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`外掛程式的專案，會為每個原生二進制檔案獲得一個分享任務：

```bash
./gradlew :app:tuistShareMainDebug
```

該任務會構建並打包已安裝的分發套件，包括其啟動器和執行時函式庫。對於 release 二進制檔案，請使用`tuistShareMainRelease`。針對多部機器的專案會為每個二進制檔案提供一個任務；執行`./gradlew :app:tasks --all`以查找它們的名稱。

支援 arm64 或 x86_64 的原生 macOS 和 Linux 可執行檔。請在目標平台上，使用 Gradle 外掛程式所需的工具鏈進行構建。此整合不支援 JVM 應用程式及其產生的啟動器腳本。

## 發布行為

分享任務會使用外掛程式現有的 Tuist 憑證進行發布，無需呼叫 Tuist CLI。一般的`assemble`、`build`和測試任務絕不會發布預覽。

分享後，請在專案中開啟**預覽**以複製連結。重複分享相同的構建和軌道會重用其發布內容，包括在快取命中之後。失敗或未確認的上傳會導致分享任務失敗；它們不會被報告為成功的預覽。

## CI 與軌道

使用與外掛程式其他需要身份驗證的功能相同的憑證來設定<.localized_link href="/guides/integrations/continuous-integration">CI 身份驗證</.localized_link>，然後明確請求發布：

```bash
./gradlew :app:tuistShareDebug --track nightly
```

以相同方式將`--track nightly`添加到原生分享任務中。任務會使用已設定的 Tuist 專案、伺服器 URL 和代理設定。預覽發布始終需要身份驗證。Git 修訂元數據、發布說明和自動拉取請求評論不會由這些任務附加。

在託管的 Tuist 上，工件發布會在 30 天後過期。自託管實例使用`TUIST_APP_PREVIEW_RETENTION_DAYS`；若不設定則會停用此類別的過期機制。已過期的發布無法透過重複相同意圖來恢復。

## 分享現有 APK

對於在此工作流程之外構建的 APK，或希望在舊版上傳流程中包含發布說明，CLI 仍然可用：

```bash
tuist share app/build/outputs/apk/debug/app-debug.apk \
  --track nightly --release-notes "Improve checkout"
```

請參閱<.localized_link href="/guides/features/previews#run-a-preview">執行預覽</.localized_link>以了解如何執行已發布的構建、存取權限、軌道以及 README 徽章。

## 使用 tuist share 嘅追蹤頻道 {#share-tracks}

對於使用 `tuist share` 發佈嘅工作流程，請使用 `--track` 選擇追蹤頻道：

```bash
tuist share App --track beta
tuist share App --track nightly
```

## 版本說明 {#release-notes}

為個別構建使用追蹤頻道來分組環境，並使用版本說明：

```bash
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"
```

將 `App` 替換為你嘅應用程式名稱、應用程式檔案路徑或可執行分發及其 `--executable` 選項。版本說明係選用嘅純文字，最多 10,000 個字符。第一行非空白行會以單行摘要形式出現喺預覽列表中，因此構建編號同其他識別資訊可以一目了然。長行會被截斷；完整說明會顯示喺詳細頁面。搜尋結果會匹配顯示名稱同完整版本說明，包括摘要中未顯示嘅行。支援多行說明，例如 `--release-notes "$(< release-notes.txt)"`。佢哋不會更改應用程式嘅顯示名稱或其追蹤頻道。

### 兼容性 {#preview-metadata-compatibility}

版本說明不會更改構建所屬嘅預覽。預覽收到嘅第一組說明會被保留：後續上傳可以為沒有說明嘅預覽添加說明，但不能覆蓋或清除現有說明。喺版本說明功能存在之前上傳嘅預覽仍然有效，無需說明。

自託管部署需要支援版本說明同追蹤頻道過濾嘅伺服器版本，以及更新咗嘅客戶端。較舊嘅伺服器會忽略說明。有關列表端點嘅追蹤頻道同搜尋過濾器，請參閱 [API 參考](https://tuist.dev/api/docs)。

## 拉取/合併請求評論 {#pullmerge-request-comments}

> [!WARNING]
> **需要 Git 平台整合**
>
> 要獲取自動拉取/合併請求評論，請將你嘅 <.localized_link href="/guides/server/accounts-and-projects">遠程項目</.localized_link> 與 Git 平台整合：<.localized_link href="/guides/integrations/gitforge/github">GitHub</.localized_link>、<.localized_link href="/guides/integrations/gitforge/origin">Cursor Origin</.localized_link> 或 <.localized_link href="/guides/integrations/gitforge/entire">Entire</.localized_link>。

一旦你嘅 Tuist 項目與你嘅 Git 平台連接，請喺 CI 中成功構建應用程式後添加 <.localized_link href="/cli/share">`tuist share`</.localized_link>。Tuist 會直接喺你嘅拉取/合併請求中發佈預覽連結，以便審查者無需本地構建即可測試：

![帶有 Tuist 預覽連結嘅 GitHub 應用程式評論](/images/guides/features/github-app-with-preview.png)

## 自動化 {#automations}

使用 `--json` 從 `tuist share` 獲取 JSON 輸出：

```bash
tuist share --json
```

使用結果進行自定義自動化，例如從 CI 發佈 Slack 消息。`url` 鍵包含完整預覽連結；`qrCodeURL` 指向用於喺設備上打開預覽嘅 QR 碼圖像：

```json
{
  "id": 1234567890,
  "url": "https://tuist.dev/preview/1234567890",
  "qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}
```

