configure 任務用於透過 XML 設定檔來配置 Ivy。您可以查閱設定檔文檔以獲取設定檔本身的詳細資訊。
從 Ivy 2.0 版本開始,也可以透過 settings 宣告來配置 Ivy。兩者的主要差異在於:使用 settings 宣告時,Ivy 的配置會在 settings 第一次被需要時(例如執行 resolve 時)才完成;而 configure 任務則會立即執行一次配置,這樣如果發生錯誤可以更容易被發現。
| 屬性 | 描述 | 必要 | 預設值 |
|---|---|---|---|
| settingsId | 用於 ivy 任務 settingsRef 屬性中的設定 ID。注意 ivy 任務會預設搜尋 ID 為 "ivy.instance" 的設定,這是預設值。 | 否 | "ivy.instance" |
| file | 要使用的設定檔路徑 | 否 | 若提供 file 則忽略 url。若兩者皆未提供,則嘗試尋找 ${ivy.settings.file},若仍無則使用預設設定檔 |
| url | 要使用的設定檔 URL | 否 | - |
| override | 指定當已經載入相同 ID 的另一個設定時該如何處理 | 否 | "notallowed" |
注意:HTTP 認證只有當 classpath 下有 commons-httpclient.jar 時才能使用。如果您在 Ivy 中使用的任何 URL(特別是在依賴解析時)需要 HTTP 認證,則必須提供 configure 任務的 host、realm、username 和 passwd 屬性。這些設定將在後續呼叫 ivy 任務時使用。
<ivy:configure />
或者使用 ${ivy.settings.file}(如果存在),或者使用預設設定檔。
<ivy:configure file="myconffile.xml" />
<ivy:configure url="https://mysite.com/myconffile.xml" />
<ivy:configure file="path/to/my/ivysettings.xml">
<credentials host="myhost.com" realm="My Realm" username="myuser" passwd="mypasswd" />
<credentials host="yourhost.com" realm="Your Realm" username="myuser" passwd="myotherpasswd" />
</ivy:configure>