動作

回報問題 查看原始碼 Nightly · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

分析規則時建立的動作。

這個物件僅供測試之用,可從 Actions 供應商取得。一般來說,您不需要在規則的實作函式中存取 Action 物件或其欄位。您可能想參閱規則頁面,進一步瞭解如何在定義自訂規則時使用動作,或是參閱API 參考資料,瞭解如何建立動作。

這個物件的部分欄位僅適用於特定類型的動作。不適用的欄位會設為 None

成員

args

sequence Action.args

已凍結的 Args 物件清單,其中包含動作引數的相關資訊。這些物件含有準確的引數資訊,包括涉及展開動作輸出目錄的引數。不過,在分析階段無法讀取 Args 物件。如要取得分析階段可用的引數,但不需太精確,請參閱 argv

請注意,部分類型的操作尚未支援顯示這個欄位。對於這類動作類型,則為 None。可能會傳回 None

argv

sequence Action.argv

針對由 ctx.actions.run()ctx.actions.run_shell() 建立的動作,這是指令列要執行的引數不變清單。請注意,如果是殼層動作,前兩個引數會是殼層路徑和 "-c"。 可能會傳回 None

內容

string Action.content

針對由 ctx.actions.write()ctx.actions.expand_template() 建立的動作,如果可在分析階段運算期間計算檔案的內容,則系統會寫入檔案內容。如果內容必須在執行階段才能確定,例如需要展開 Args 物件中的目錄時,值就會是 None。 可能會傳回 None

env

dict Action.env

「已修正」環境變數這項作業只會納入由動作定義明確設定的環境設定,因此會略過僅在執行環境中預先設定的設定。

輸入

depset Action.inputs

這項操作的一組輸入檔案。

助憶鍵

string Action.mnemonic

此動作的助憶法。

輸出內容

depset Action.outputs

這項操作的輸出檔案。

substitutions

dict Action.substitutions

如果是透過 ctx.actions.expand_template() 建立的動作,則為一個不可變動的字典,其中包含替換對應項目。可能會傳回 None