Maven 软件包注册表

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

要求

要使用 Maven 软件包注册表，您可以使用 Maven 或 Gradle。 以下示例使用 Maven 和 Gradle Groovy。

配置软件包注册表

要注册软件包注册表，首先需要将访问令牌添加到 settings.xml 文件中：

  1. <settings>
  2.   <servers>
  3.     <server>
  4.       <id>gitea</id>
  5.       <configuration>
  6.         <httpHeaders>
  7.           <property>
  8.             <name>Authorization</name>
  9.             <value>token {access_token}</value>
  10.           </property>
  11.         </httpHeaders>
  12.       </configuration>
  13.     </server>
  14.   </servers>
  15. </settings>

然后在项目的 pom.xml 文件中添加以下部分：

  1. <repositories>
  2.   <repository>
  3.     <id>gitea</id>
  4.     <url>https://gitea.example.com/api/packages/{owner}/maven</url>
  5.   </repository>
  6. </repositories>
  7. <distributionManagement>
  8.   <repository>
  9.     <id>gitea</id>
  10.     <url>https://gitea.example.com/api/packages/{owner}/maven</url>
  11.   </repository>
  12.   <snapshotRepository>
  13.     <id>gitea</id>
  14.     <url>https://gitea.example.com/api/packages/{owner}/maven</url>
  15.   </snapshotRepository>
  16. </distributionManagement>
参数描述
access_token您的个人访问令牌
owner软件包的所有者

Gradle variant

如果您计划在项目中添加来自 Gitea 实例的一些软件包，请将其添加到 repositories 部分中：

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

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

  1. publishing {
  2.     // 其他发布设置
  3.     repositories {
  4.         maven {
  5.             name = "Gitea"
  6.             url = uri("https://gitea.example.com/api/packages/{owner}/maven")
  8.             credentials(HttpHeaderCredentials) {
  9.                 name = "Authorization"
  10.                 value = "token {access_token}"
  11.             }
  13.             authentication {
  14.                 header(HttpHeaderAuthentication)
  15.             }
  16.         }
  17.     }
  18. }

发布软件包

要发布软件包，只需运行以下命令：

  1. mvn deploy

或者，如果您使用的是 Gradle，请使用 gradle 命令和 publishAllPublicationsToGiteaRepository 任务：

  1. ./gradlew publishAllPublicationsToGiteaRepository

如果您想要将预构建的软件包发布到注册表中，可以使用 mvn deploy:deploy-file 命令：

  1. mvn deploy:deploy-file -Durl=https://gitea.example.com/api/packages/{owner}/maven -DrepositoryId=gitea -Dfile=/path/to/package.jar
参数描述
owner软件包的所有者

如果存在相同名称和版本的软件包，您无法发布该软件包。您必须先删除现有的软件包。

安装软件包

要从软件包注册表中安装 Maven 软件包，请在项目的 pom.xml 文件中添加新的依赖项：

  1. <dependency>
  2.   <groupId>com.test.package</groupId>
  3.   <artifactId>test_project</artifactId>
  4.   <version>1.0.0</version>
  5. </dependency>

在 Gradle Groovy 中类似的操作如下：

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

然后运行：

  1. mvn install

支持的命令

  1. mvn install
  2. mvn deploy
  3. mvn dependency:get: