# 用 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>。
