本頁面由 Cloud Translation API 翻譯而成。

密封動作

目標和動力

在任何建構系統中定義建構動作時，請務必正確並完整指定該動作的輸入和輸出內容漸進式建構作業 (在對來源稍有變更之後進行部分重新建構) 必須確認建構圖表中呈現的資訊皆正確無誤辨識並執行重建作業如果這項資訊有誤或不完整重新建構可能會產生錯誤結果，或導致完全不同的結果乾淨的建構作業

只會讀取其宣告的輸入內容，且只會寫入其宣告內容的動作宣告的輸出內容對建構系統而言是密封的。今天我們沒有完全遺傳的架構而是可以進行數十種動作以及讀取/寫入不在宣告輸入/輸出中的檔案這樣我們就不用在實際工作環境中完全仰賴漸進式重建。必須要求我們執行完整簡潔的版本，速度會慢約 10 倍。

再者，這些非密封的動作通常表明自己有連貫性工程師運作並浪費時間正在嘗試排解問題

這項專案的目標是調查並修正所有非密封化的例項建構動作

熟悉 GN 和 BUILD.gn 檔案很重要，特別是指定類型：

在許多情況下，您也需要瞭解 depfile 的運作方式：

如需更多重要資訊，請參閱本指南：

選擇任何標示為非密封的建構目標。如下所示：

action("foo") {
  ...
  # TODO(https://fxbug.dev/xxxxx): delete the line below and fix this
  hermetic_deps = false
}

如果要瞭解動作無法密封的原因，就需要使用動作追蹤工具這項工具會在追蹤時執行所有建構動作然後將這些存取與宣告的這些動作的輸入 / 輸出 / depfile

如要在本機重現問題，請先移除 hermetic_deps = false，然後請按照下列方式設定建構作業：

fx set what --args=build_should_trace_actions=true

使用上述設定執行建構作業應會產生錯誤可行的疑難排解資訊。

根據預設，CQ 會執行動作追蹤，因此您可以使用本 API 取得相同的來解決連線問題

如果問題已提報，該錯誤應包含錯誤訊息中的資訊如果沒有錯誤，請回報錯誤並記錄您收集的資訊

有幾個常見原因可能造成歷史上的問題。您可以在本指南。如果您遇到的問題未列於指南中，請考慮改善指南內容

如果您可以移除 hermetic_deps = false，並仍成功建構若是使用追蹤記錄或追蹤嘗試通過，就表示您的變更已可套用至現場業務代表受過訓練會提交 AI 客戶商機以供審查