Maven 包仓库

发布您的用户或组织的 Maven 包。

要求

要使用 Maven 包仓库，您可以使用 Maven 或 Gradle。以下示例使用 Maven 和 Gradle Groovy。

配置包仓库

要注册包仓库，您首先需要将您的访问令牌添加到 settings.xml 文件中。

<settings>
  <servers>
    <server>
      <id>gitea</id>
      <configuration>
        <httpHeaders>
          <property>
            <name>Authorization</name>
            <value>token {access_token}</value>
          </property>
        </httpHeaders>
      </configuration>
    </server>
  </servers>
</settings>

然后将以下部分添加到您的项目 pom.xml 文件中。

<repositories>
  <repository>
    <id>gitea</id>
    <url>https://gitea.example.com/api/packages/{owner}/maven</url>
  </repository>
</repositories>
<distributionManagement>
  <repository>
    <id>gitea</id>
    <url>https://gitea.example.com/api/packages/{owner}/maven</url>
  </repository>
  <snapshotRepository>
    <id>gitea</id>
    <url>https://gitea.example.com/api/packages/{owner}/maven</url>
  </snapshotRepository>
</distributionManagement>

参数	描述
access_token	您的 个人访问令牌。
owner	包的所有者。

Gradle 变体

当您计划在您的项目中添加来自 Gitea 实例的包时，您应该将它们添加到 repositories 部分。

repositories {
    // other repositories
    maven { url "https://gitea.example.com/api/packages/{owner}/maven" }
}

在 Groovy gradle 中，您可以在您的发布部分包含以下脚本。

publishing {
    // other settings of publication
    repositories {
        maven {
            name = "Gitea"
            url = uri("https://gitea.example.com/api/packages/{owner}/maven")

            credentials(HttpHeaderCredentials) {
                name = "Authorization"
                value = "token {access_token}"
            }

            authentication {
                header(HttpHeaderAuthentication)
            }
        }
    }
}

发布包

要发布包，只需运行

mvn deploy

或者在您使用 gradle 的情况下，使用任务 publishAllPublicationsToGiteaRepository 调用 gradle。

./gradlew publishAllPublicationsToGiteaRepository

如果您想将预构建的包发布到仓库，您可以使用 mvn deploy:deploy-file

mvn deploy:deploy-file -Durl=https://gitea.example.com/api/packages/{owner}/maven -DrepositoryId=gitea -Dfile=/path/to/package.jar

参数	描述
owner	包的所有者。

如果您无法发布包，可能是因为同名同版本的包已经存在。您必须先删除现有的包。

安装包

要从包仓库安装 Maven 包，请将新的依赖项添加到您的项目 pom.xml 文件中。

<dependency>
  <groupId>com.test.package</groupId>
  <artifactId>test_project</artifactId>
  <version>1.0.0</version>
</dependency>

在 gradle groovy 中也是类似的。

implementation "com.test.package:test_project:1.0.0"

然后运行

mvn install

支持的命令

mvn install
mvn deploy
mvn dependency:get: