<toplevelRef> 要素は、現在の複合コンポーネントによって宣言または継承が行われた最上位のコンポーネント参照を特定します。このターゲッターを使用できるのは、複合コンポーネント内のステップだけです。
<toplevelRef> 要素は、<checkDependency>、<createDependency>、<call>、<uninstall>、および <addSnapshot> ステップのターゲッターとして使用できます。
このターゲッターは、name、path、および version 属性が参照先コンポーネントに基づいて事前定義されることを除き、意味的に <installedComponent> ターゲッターと同じです。詳細は、「 <installedComponent> インストール済みコンポーネントターゲッター」を参照してください。
<toplevelRef> ターゲッターには次の属性があります。
versionOp – オプション属性で、参照先コンポーネントのバージョンをターゲットホスト上にインストールされたコンポーネントのバージョンと比較する際に使用する演算子を指定します。複数のインストール済みコンポーネントが適用される場合、最後にインストールされたコンポーネントが使用されます。
使用できる値は、=、>=、および > です。この属性を指定しないと、>= が使用されます。
onlyCompat – オプション属性で、照合されるコンポーネントを指定します。true の場合、参照先コンポーネントと呼び出し互換性のあるコンポーネントだけを照合する必要があることを示します。デフォルト値は false です。
installPath – オプション属性で、参照先コンポーネントのインストールパス。この属性を指定しないと、任意のパスの最新の参照先コンポーネントインストールが使用されます。この値は、コンポーネントの解決処理の前に共通書式に変換されます。この属性は、単純置換変数を参照できます。
host – オプション属性で、参照先コンポーネントがインストールされているホスト。デフォルトでは、host は現在のホストです。host 属性の詳細は、「<retarget> ステップの属性」を参照してください。この属性は、単純置換変数を参照できます。