Ivy 參考文檔：Ivy 檔案（模組描述符）完整指南

Ivy 檔案概述

Ivy 的使用完全基於「Ivy 檔案」——模組描述符。Ivy 檔案是 XML 檔案，通常命名為 ivy.xml，包含模組依賴描述、發布的制品及其配置。

最簡單的 Ivy 檔案

<ivy-module version="2.0">
  <info organisation="myorg" module="mymodule"/>
</ivy-module>

支援 XSD 驗證

可在 ivy 檔案中宣告 XSD 以獲得 IDE 自動完成和驗證：

<?xml version="1.0" encoding="UTF-8"?>
<ivy-module version="2.0"
  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="https://ant.apache.org/ivy/schemas/ivy.xsd">
  <info organisation="myorg" module="mymodule"/>
</ivy-module>

動態 vs 固定的 Ivy 檔案

1. 開發用動態描述符

模組開發期間，描述符管理可能變動的依賴。可宣告動態依賴（如 "latest.integration" 或 "1.0.+"），變數提供更多彈性。動態 ivy 檔案隨時間產生不同結果，通常作為原始碼檔案受 SCM 控制。

2. 發布用確定描述符

每次發布需記錄特定修訂版本的依賴。發布的模組修訂版本取得固定、明確解析的依賴，不允許變數。這類靜態 ivy 檔案稱為 "resolved"，通常產生相同結果。確定的 ivy 檔案由 deliver 任務從動態 ivy 檔案產生，與發布制品一起儲存在倉庫中。

注意：雖然技術上可用動態 ivy 發布，但不推薦。

分層索引結構

ivy-module
  info
    license
    ivyauthor
    repository
    description
  configurations
    conf
  publications
    artifact
      conf
  dependencies
    dependency
      conf
      mapped
      artifact
        conf
    include
      conf
    exclude
      conf
    exclude
    override
  conflicts
    manager

ivy-module 元素

每個 Ivy 檔案的根標籤。

子元素