動作

分析規則時建立的動作。

這個物件僅供測試之用，可從動作供應商取得。在規則的實作函式中，通常不需要存取 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。