如何配置Ivy从GitLab私有项目Maven仓库下载构件？

1. 编写Ivy配置文件（ivysettings.xml） #

在项目中创建或修改ivysettings.xml，通过<credentials>配置Basic Auth信息，同时指定GitLab私有仓库的地址（格式一般为https://gitlab.com/api/v4/projects/{项目ID}/packages/maven，替换成你的实际项目ID）。

示例配置：

<ivysettings>
    <settings defaultResolver="gitlab-repo"/>
    <!-- 配置GitLab认证信息 -->
    <credentials host="gitlab.com" realm="GitLab Packages" username="你的GitLab用户名" passwd="你的个人访问令牌"/>
    <!-- 定义GitLab仓库解析器 -->
    <resolvers>
        <ibiblio name="gitlab-repo" m2compatible="true" root="https://gitlab.com/api/v4/projects/12345/packages/maven"/>
    </resolvers>
</ivysettings>

• 重点注意：realm值要和GitLab返回的认证头部一致，通常是GitLab Packages；passwd建议使用GitLab的个人访问令牌（需勾选read_api和read_repository权限），不要直接用账号密码。

2. 在Ant任务中关联Ivy配置 #

修改你的Ant脚本，让<ivy:resolve>加载并使用上述配置：

修改后的Ant代码示例：

<!-- 加载Ivy配置文件 -->
<ivy:settings file="ivysettings.xml"/>
<ivy:resolve>                          
    <dependency org="org.some"       
                name="artefact"  
                rev="0.0.1-SNAPSHOT" />
</ivy:resolve>                         
                                       
<ivy:retrieve />                       

3. 更安全的方式：用系统变量传递凭据 #

如果不想把凭据硬编码在配置文件里，可通过系统变量传递：

• 运行Ant时添加参数：ant -Divy.gitlab.username=你的用户名 -Divy.gitlab.token=你的令牌
• 修改ivysettings.xml引用变量：

<credentials host="gitlab.com" realm="GitLab Packages" username="${ivy.gitlab.username}" passwd="${ivy.gitlab.token}"/>

常见验证要点 #

• 确认GitLab访问令牌的权限足够（至少能读取对应项目的包仓库）
• 检查仓库地址中的项目ID是否正确，项目ID可在GitLab项目的「设置→通用」页面找到
• 若遇到401错误，核对realm值是否正确，也可通过浏览器访问仓库地址查看返回的认证头部信息

内容的提问来源于stack exchange，提问作者Jörn Guy Süß