# 使用 CLI 執行預覽

安裝 <.localized_link href="/guides/install-tuist">Tuist CLI</.localized_link>，然後執行共享的預覽連結。你不需要產生該預覽的建置系統：

```bash
tuist run {url}
```

Tuist 會為你的作業系統、CPU 架構和目標裝置選擇相容的建置版本。私人預覽需要通過身分驗證並具備專案存取權限。

## 行動應用程式 {#mobile-applications}

選擇已連接的裝置或模擬器：

```bash
tuist run --device "My device" {url}
```

Android 裝置和模擬器必須透過 ADB 連接。你也可以從預覽頁面下載 APK，並將其安裝在允許從該來源安裝的 Android 裝置上。Apple 建置版本必須符合目標平台並滿足其簽署要求。若是 IPA 檔案，請在目標裝置上開啟預覽連結以進行安裝。

## 命令列預覽 {#command-line-previews}

在 `--` 之後傳遞引數：

```bash
tuist run {url} -- --help
tuist run {url} -- build --configuration Release
```

`--` 之後的所有內容都會原樣轉發，包括 `--verbose`、`--quiet` 和 `--path`。子引數不會納入 Tuist 命令分析。

預覽會在你目前的工作目錄、環境以及終端機輸入/輸出下執行，並回傳可執行檔的結束狀態碼。它不會取代已安裝的 CLI，也不會將其加入 `PATH`。CLI 發行版在執行後仍會保留在 Tuist 的本地 `previews` 快取中，以便產生的專案可以繼續參考它們；刪除該快取也會移除這些參考的目標。

桌面和 CLI 預覽是以目前使用者身分執行，而非在沙箱中執行。請僅執行你信任的作者和拉取請求所產生的建置版本。

## 選擇版本 {#select-a-version}

`tuist run` 也接受帶有 `latest` 的應用程式名稱、分支名稱或提交雜湊：

```bash
tuist run App@latest # Latest App preview associated with the project's default branch
tuist run App@my-feature-branch # Latest App preview associated with a branch
tuist run App@00dde7f56b1b8795a26b8085a781fb3715e834be # Preview associated with a commit
```

這些選擇器需要對應的 Git 中繼資料已發布。對於省略 Git 中繼資料的工作流程，請改用特定的預覽 URL。

如需存取權限與組織方式，請參閱 <.localized_link href="/guides/features/previews#visibility">可見性與追蹤</.localized_link>。
