Android
將 tuist inspect bundle 指向應用程式套件或可安裝檔案,以分析 Android 套件:
tuist inspect bundle App.aab
tuist inspect bundle App.apk
分析 .apk 需要 aapt2,它隨附於 Android SDK 建構工具。設定 ANDROID_HOME 或 ANDROID_SDK_ROOT 讓 Tuist 能夠找到它,或者將 aapt2 加入 PATH。分析 .aab 不需要任何外部工具。
指令會將 bundle 上載至 Tuist,並回傳一個詳細概覽的連結,包括內容掃描同模組細分:

標籤#
上傳 bundle 時附加標籤,以區分建置變體、環境或發布渠道。Bundle 標籤遵循與 Build Insights 標籤相同的慣例:
tuist inspect bundle App.ipa --tags paid production
在 CI 中,你也可以使用 TUIST_BUNDLE_TAGS 設定以逗號分隔的標籤:
TUIST_BUNDLE_TAGS="paid,production" tuist inspect bundle App.ipa
明確的 --tags 會取代環境變數中的標籤。標籤可包含字母、數字、連字號及底線,每個 bundle 最多 10 個標籤,每個標籤最多 50 個字元。Android bundle 也適用相同選項。--json 僅限本機使用,不會上傳標籤或 bundle。
標籤會顯示在 bundle 名稱旁邊及 bundle 詳細資訊中。使用儀表板的 標籤 篩選器並輸入標籤,以在 bundle 清單中包含或排除該標籤。比對為精確且區分大小寫,即使篩選運算子標示為 包含 和 不包含:paid 不會匹配 paid-extra。若要從 CLI 進行篩選:
tuist bundle list --tags paid production
CLI、API(?tags=paid,production)及 MCP list_bundles 工具(tags: ["paid", "production"])會回傳包含 所有 指定標籤的 bundle。API 上傳接受 bundle.custom_metadata.tags;清單及詳細回應則回傳 custom_metadata.tags。現有未帶標籤的 bundle 仍照常可用。標籤僅用於篩選 bundle 清單;不會影響大小圖表或自動比較及閾值基準。
現有用戶端可繼續上傳及讀取不帶標籤的 bundle。更新後的用戶端也能讀取省略 custom_metadata 的舊版伺服器回應。儲存及篩選標籤需要支援 bundle 標籤的伺服器版本:舊版伺服器會忽略上傳中繼資料並拒絕標籤篩選。當未提供標籤時,更新後的用戶端會省略上傳中繼資料及標籤查詢參數。
了解 bundle 大小#
對於每個已分析的 bundle,Tuist 會回報兩個數值:
- 安裝大小:應用程式安裝到裝置後所佔用的空間。
- 下載大小:使用者下載的壓縮大小。對於 Apple bundle,此數值僅針對
.ipa(封存檔大小)回報;若輸入為.xcarchive或.app,則無法提供。
大小以位元組儲存,並採用十進位慣例顯示,其中 1 MB 為 1,000,000 位元組,1 GB 為 1,000,000,000 位元組——與 Apple 回報儲存空間及應用程式大小的慣例相同(參見 Apple 裝置如何測量儲存容量)。733,446,863 位元組的安裝大小會顯示為 733.4 MB。
持續整合#
若要追蹤 bundle 大小隨時間的變化,請在 CI 上分析 bundle。首先,請確保你的 CI 已 通過驗證。
Tuist 也需要知道要將 bundle 回報至哪個專案。如果你尚未連接專案,請執行 tuist init,或自行宣告 handle:
let tuist = Tuist(fullHandle: "my-account/my-project")
project = "my-account/my-project"
對於沒有 Swift manifest 的專案(例如 Gradle 專案),請使用 tuist.toml。當兩個檔案同時存在時,Tuist.swift 具有優先權。
GitHub Actions 工作流程範例:
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
run: tuist inspect bundle App.ipa
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
# .aab is recommended over .apk for more accurate size analysis
run: tuist inspect bundle App.aab
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
設定完成後,你可以查看 bundle 大小隨時間的變化:

Pull/Merge Request 評論#
若要取得自動 pull/merge request 評論,請將你的 Tuist 專案 與 Git forge 整合:GitHub、Cursor Origin 或 Entire。
當你的 Tuist 專案與 Git 平台(例如 GitHub)連接後,每當你執行 tuist inspect bundle 時,Tuist 會直接在 pull/merge request 中張貼評論:

大小閾值#
若要使用大小閾值,請將 Tuist GitHub App 連接至你的專案。你可以在專案的整合頁面進行此操作。
大小閾值允許你在 bundle 大小相對於基準分支的增加超過設定的百分比或絕對大小時封鎖 pull request。當違反閾值時,Tuist 會在 PR commit 上建立 GitHub Check Run,並在解決大小增加問題前封鎖合併:

Check run 會顯示基準大小、目前大小以及以設定單位表示的變化。如果增加是有意為之,你可以直接在 GitHub UI 中點擊 接受 按鈕來接受:

設定#
若要設定閾值,請前往專案的 設定 > Bundles 分頁:

選擇 安裝大小 或 下載大小,然後選擇 閾值類型:
- 百分比 (%):限制相對於基準大小的增長。支援小數百分比,例如
0.47。現有的百分比閾值會保留其設定的數值及行為。 - 絕對大小 (MB):以固定數量限制增長,與基準大小無關。輸入
1.5以允許最多 1.5 MB 的增長。MB 使用十進位單位:1 MB = 1,000,000 位元組。數值必須解析為正整數位元組數。

兩種類型都會與設定的 基準分支 上最新的 bundle 進行比較,該 bundle 需具有相同名稱、相同 bundle 類型(例如 .app 或 .ipa),且至少有一個共同平台,因此模擬器 .app 只會與模擬器 .app 上傳進行比較。可選的 Bundle 名稱 將規則限制於該 bundle。只有當增長 超過 限制時檢查才會失敗;相等增長、大小不變及減少則會通過。若沒有匹配的基準或所選指標沒有記錄的大小,則會跳過該規則。絕對限制支援零大小基準;百分比限制會繼續跳過它,因為百分比增長未定義。
限制誰可以接受#
預設情況下,任何擁有儲存庫寫入權限的人都可以接受大小增加,因為 GitHub 只會向他們顯示按鈕。若要縮小範圍,請在 設定 > Bundles 下設定 誰可以接受:
- 任何人:預設值。任何擁有儲存庫寫入權限的人。
- 選定的 GitHub 用戶:僅限你添加的 GitHub 用戶名。
不在列表中的人會使檢查保持失敗狀態並附上解釋,而按鈕仍會顯示給可以使用它的人。