<addSnapshot> 要素は <capture> 要素の子であり、外部スナップショットを実行してそのコンテンツを当該スナップショットに追加すべきであることを示します。
<addSnapshot> 手順の使用は、<addSnapshot> 手順の代わりに、呼び出されたスナップショットの prepare 手順を呼び出し側スナップショットの prepare ブロックの最後に追加し、呼び出されたスナップショットの cleanup 手順を呼び出し側スナップショットの cleanup ブロックの先頭に追加し、呼び出されたスナップショットの capture 手順を呼び出し側スナップショットの capture ブロックに追加するのと意味的に同じです。 したがって、呼び出される側および呼び出し側のスナップショットブロックによって参照されるファイルが重複しないように注意する必要があります。
<capture> 要素には任意の数の <addSnapshot> 手順を指定でき、呼び出される側のスナップショットはその <capture> 要素に任意の数の <addSnapshot> 手順を含むことができます。
<addSnapshot> コールアウトを使用してファイルをスナップショットに間接的に追加する場合、スナップショットのキャプチャを開始した最上位のコンポーネントは (<addFile> 命令が入ったコンポーネントとは対照的に) ファイルの所有者と見なされます。 同様に、スナップショットに対して diff が実行される場合は、スナップショットを開始した最上位コンポーネントの diff 無視命令だけが考慮されます。 <addSnapshot> コールアウトの結果として出現したコンポーネントに含まれる diff 無視命令は考慮されません。
名前 |
型 |
必須 |
構成可能 |
説明 |
---|---|---|---|---|
blockName |
文字列 |
はい |
不可 |
実行する外部スナップショットブロックの名前 |
名前 |
数 |
説明 |
argList |
0 または 1 |
スナップショットブロックに渡す引数の一覧 |
installed component targeter |
0 または 1 |
スナップショットブロックに含まれるコンポーネントを特定する。 指定しないと、<thisComponent> が使用される |