跳至內容

Android

將 tuist inspect bundle 指向應用程式套件或可安裝檔案,以分析 Android 套件:

bash
tuist inspect bundle App.aab
bash
tuist inspect bundle App.apk
Note

分析 .apk 需要 aapt2,該工具隨附於 Android SDK 建置工具中。設定 ANDROID_HOME 或 ANDROID_SDK_ROOT 以便 Tuist 找到它,或將 aapt2 加入 PATH。分析 .aab 不需要外部工具。

此指令會將套件上傳至 Tuist,並回傳詳細概覽的連結,包含內容掃描與模組細目:

已分析的套件

標籤#

上傳套件時附加標籤,以區分建置變體、環境或發布管道。套件標籤的慣例與 Build Insights 標籤相同:

bash
tuist inspect bundle App.ipa --tags paid production

在 CI 中,你也可以使用 TUIST_BUNDLE_TAGS 設定以逗號分隔的標籤:

bash
TUIST_BUNDLE_TAGS="paid,production" tuist inspect bundle App.ipa

明確指定的 --tags 會取代環境變數中的標籤。標籤可包含字母、數字、連字號和底線,每個套件最多 10 個標籤,每個標籤最多 50 個字元。相同的選項也適用於 Android 套件。--json 僅限本機使用,不會上傳標籤或套件。

標籤會顯示在套件名稱旁邊以及套件詳細資訊中。使用儀表板的 標籤 篩選器並輸入標籤,以在套件清單中包含或排除該標籤。比對為精確且區分大小寫,即使篩選運算子標示為 包含 和 不包含:paid 不會比對 paid-extra。若要從 CLI 進行篩選:

bash
tuist bundle list --tags paid production

CLI、API(?tags=paid,production)和 MCP list_bundles 工具(tags: ["paid", "production"])會回傳包含 所有 指定標籤的套件。API 上傳接受 bundle.custom_metadata.tags;清單和詳細回應會回傳 custom_metadata.tags。現有未帶標籤的套件仍照常可用。標籤用於篩選套件清單;它們不會改變大小圖表或自動比較與閾值基準。

現有用戶端可以繼續上傳和讀取不帶標籤的套件。更新後的用戶端也可以讀取省略 custom_metadata 的舊版伺服器回應。儲存和篩選標籤需要支援套件標籤的伺服器版本:舊版伺服器會忽略上傳中繼資料並拒絕標籤篩選。當未提供標籤時,更新後的用戶端會省略上傳中繼資料和標籤查詢參數。

了解套件大小#

對於每個已分析的套件,Tuist 會回報兩個值:

  • 安裝大小:應用程式安裝到裝置後所佔用的空間。
  • 下載大小:使用者下載的壓縮大小。對於 Apple 套件,此值僅針對 .ipa(封存檔的大小)回報;對於 .xcarchive 或 .app 輸入則無法提供。

大小以位元組儲存,並使用十進位慣例顯示,其中 1 MB 為 1,000,000 位元組,1 GB 為 1,000,000,000 位元組——這與 Apple 用來回報儲存空間和應用程式大小的慣例相同(請參閱 Apple 裝置如何測量儲存容量)。733,446,863 位元組的安裝大小會顯示為 733.4 MB。

持續整合#

若要追蹤套件大小隨時間的變化,請在 CI 上分析套件。首先,請確保你的 CI 已 通過驗證。

Tuist 也需要知道要將套件回報給哪個專案。如果你尚未連接專案,請執行 tuist init,或自行宣告處理常式:

swift
let tuist = Tuist(fullHandle: "my-account/my-project")
toml
project = "my-account/my-project"

對於沒有 Swift 資訊清單的專案(例如 Gradle 專案),請使用 tuist.toml。當兩個檔案都存在時,Tuist.swift 具有優先權。

GitHub Actions 工作流程範例:

yaml
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
run: tuist inspect bundle App.ipa
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
yaml
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 }}

設定完成後,你可以查看套件大小隨時間的變化:

套件大小圖表

Pull/Merge Request 留言#

需要 Git Forge 整合

若要取得自動的 Pull/Merge Request 留言,請將你的 Tuist 專案 與 Git Forge 整合:GitHub、Cursor Origin 或 Entire。

一旦你的 Tuist 專案與 Git 平台(例如 GitHub)連接,每當你執行 tuist inspect bundle 時,Tuist 就會直接在你的 Pull/Merge Request 中張貼留言:

帶有已檢查套件的 GitHub App 留言

大小閾值#

需要 Git Forge 整合

若要使用大小閾值,請將 Tuist GitHub App 連接到你的專案。你可以從專案的整合頁面進行此操作。

大小閾值允許你在套件大小相對於基準分支增加超過設定的百分比或絕對大小時封鎖 Pull Request。當違反閾值時,Tuist 會在 PR 提交上建立 GitHub Check Run,直到解決大小增加問題前都會封鎖合併:

顯示套件大小閾值超出的 PR 狀態檢查

檢查運行會顯示基準大小、目前大小以及以設定單位表示的變化。如果增加是故意的,你可以直接從 GitHub UI 點擊 接受 按鈕來接受:

顯示閾值違規的 GitHub 檢查運行

設定#

若要設定閾值,請前往專案的 設定 > 套件 標籤:

套件大小閾值設定

選擇 安裝大小 或 下載大小,然後選擇 閾值類型:

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

絕對套件大小成長閾值設定

兩種類型都會與設定的 基準分支 上最新的套件進行比較,該套件必須具有相同的名稱、相同的套件類型(例如 .app 或 .ipa),並且至少有一個共同的平台,因此模擬器 .app 只會與模擬器 .app 的上傳進行比較。可選的 套件名稱 會將規則限制在該套件。只有當成長幅度 超過 限制時,檢查才會失敗;成長幅度相等、大小不變或減少則會通過。如果沒有相符的基準或所選指標沒有記錄的大小,則會跳過該規則。絕對限制支援零大小的基準;百分比限制會持續跳過它,因為百分比成長未定義。

限制誰可以接受#

預設情況下,任何擁有儲存庫寫入權限的人都可以接受大小增加,因為 GitHub 會向他們顯示按鈕。若要縮小範圍,請在 設定 > 套件 下設定 誰可以接受:

  • 任何人:預設值。任何擁有儲存庫寫入權限的人。
  • 選定的 GitHub 使用者:僅限你新增的 GitHub 使用者名稱。

不在清單上的人會讓檢查保持失敗狀態並附上說明,而按鈕仍會顯示給有權使用的人。