已生成嘅 Xcode 專案

Note

自動生成嘅 scheme 會自動包含 tuist inspect build 後續動作。

如果你唔想喺已生成嘅 scheme 中追蹤構建洞察，可以使用 buildInsightsDisabled 嚟停用。

如果你使用帶有自訂 scheme 嘅已生成專案，你需要自己添加後續動作。對於 Mise：

swift

let project = Project(
    name: "MyProject",
    targets: [
        // Your targets
    ],
    schemes: [
        .scheme(
            name: "MyApp",
            shared: true,
            buildAction: .buildAction(
                targets: ["MyApp"],
                postActions: [
                    .executionAction(
                        title: "Inspect Build",
                        scriptText: """
                        $HOME/.local/bin/mise x -C $SRCROOT -- tuist inspect build
                        """,
                        target: "MyApp"
                    )
                ],
                runPostActionsOnFailure: true
            ),
            runAction: .runAction(configuration: "Debug")
        )
    ]
)

如果你唔使用 Mise，你需要確保 tuist 喺 scheme 嘅環境中可用，因為 Xcode 後續動作唔會繼承你 shell 嘅 PATH。對於 Homebrew 安裝：

swift

buildAction: .buildAction(
    targets: ["MyApp"],
    postActions: [
        .executionAction(
            title: "Inspect Build",
            scriptText: """
            export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
            tuist inspect build
            """,
            target: "MyApp"
        )
    ],
    runPostActionsOnFailure: true
)

CI 中嘅構建洞察#

要喺 CI 上追蹤構建洞察，請確保 CI 已驗證。

對於由 Xcodebuild 驅動嘅 CI，你需要：

喺調用 xcodebuild 動作時使用 tuist xcodebuild。
將 -resultBundlePath 添加到你嘅 xcodebuild 命令中。

如果冇 -resultBundlePath，就唔會生成所需嘅活動日誌同結果包，而 tuist inspect build 亦都無法分析構建。

機器指標#

構建洞察可以包括喺構建期間捕獲嘅機器級別性能指標（CPU、記憶體、網絡同磁碟使用量）。要啟用此功能，請設置一個輕量級後台守護進程，持續採樣系統指標：

bash

tuist setup insights

呢個會運行一個本地守護進程，喺後台採樣指標。數據會由 tuist inspect build 自動拾取並隨構建報告上傳。

喺構建之前喺你嘅 CI 機器上運行 tuist setup insights，以同樣捕捉嗰度嘅機器指標。

要停止收集機器指標，請運行：

bash

tuist teardown insights

呢個會卸載守護進程嘅 LaunchAgent，移除其 plist，並從 ~/.local/state 刪除採樣嘅指標同守護進程日誌，因此後台唔會有任何東西繼續運行。

自訂元數據#

你可以透過環境變量將元數據附加到構建，以改善篩選。

環境變量#

變量	格式	描述
`TUIST_BUILD_TAGS`	逗號分隔	一個變量中包含多個標籤。
`TUIST_BUILD_VALUE_*`	單一值	鍵值對，其中後綴係鍵。

示例#

喺調用你嘅構建之前，喺 CI 或你嘅 shell 中設置呢啲值：

bash

export TUIST_BUILD_TAGS="nightly,ios-team,release-candidate"

bash

export TUIST_BUILD_VALUE_TICKET="PROJ-1234"
export TUIST_BUILD_VALUE_PR_URL="https://github.com/myorg/myrepo/pull/123"