mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-12-05 17:59:51 +00:00
168 lines
4.1 KiB
Markdown
168 lines
4.1 KiB
Markdown
|
---
|
|||
|
date: "2021-07-20T00:00:00+00:00"
|
|||
|
title: "Maven 软件包注册表"
|
|||
|
slug: "maven"
|
|||
|
weight: 60
|
|||
|
draft: false
|
|||
|
toc: false
|
|||
|
menu:
|
|||
|
sidebar:
|
|||
|
parent: "packages"
|
|||
|
name: "Maven"
|
|||
|
weight: 60
|
|||
|
identifier: "maven"
|
|||
|
---
|
|||
|
|
|||
|
# Maven 软件包注册表
|
|||
|
|
|||
|
为您的用户或组织发布 [Maven](https://maven.apache.org) 软件包。
|
|||
|
|
|||
|
**目录**
|
|||
|
|
|||
|
{{< toc >}}
|
|||
|
|
|||
|
## 要求
|
|||
|
|
|||
|
要使用 Maven 软件包注册表,您可以使用 [Maven](https://maven.apache.org/install.html) 或 [Gradle](https://gradle.org/install/)。
|
|||
|
以下示例使用 `Maven` 和 `Gradle Groovy`。
|
|||
|
|
|||
|
## 配置软件包注册表
|
|||
|
|
|||
|
要注册软件包注册表,首先需要将访问令牌添加到 [`settings.xml`](https://maven.apache.org/settings.html) 文件中:
|
|||
|
|
|||
|
```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` 文件中添加以下部分:
|
|||
|
|
|||
|
```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` | 您的[个人访问令牌]({{< relref "doc/development/api-usage.zh-cn.md#通过-api-认证" >}}) |
|
|||
|
| `owner` | 软件包的所有者 |
|
|||
|
|
|||
|
### Gradle variant
|
|||
|
|
|||
|
如果您计划在项目中添加来自 Gitea 实例的一些软件包,请将其添加到 repositories 部分中:
|
|||
|
|
|||
|
```groovy
|
|||
|
repositories {
|
|||
|
// other repositories
|
|||
|
maven { url "https://gitea.example.com/api/packages/{owner}/maven" }
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
在 Groovy gradle 中,您可以在发布部分中包含以下脚本:
|
|||
|
|
|||
|
```groovy
|
|||
|
publishing {
|
|||
|
// 其他发布设置
|
|||
|
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)
|
|||
|
}
|
|||
|
}
|
|||
|
}
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
## 发布软件包
|
|||
|
|
|||
|
要发布软件包,只需运行以下命令:
|
|||
|
|
|||
|
```shell
|
|||
|
mvn deploy
|
|||
|
```
|
|||
|
|
|||
|
或者,如果您使用的是 Gradle,请使用 `gradle` 命令和 `publishAllPublicationsToGiteaRepository` 任务:
|
|||
|
|
|||
|
```groovy
|
|||
|
./gradlew publishAllPublicationsToGiteaRepository
|
|||
|
```
|
|||
|
|
|||
|
如果您想要将预构建的软件包发布到注册表中,可以使用 [`mvn deploy:deploy-file`](https://maven.apache.org/plugins/maven-deploy-plugin/deploy-file-mojo.html) 命令:
|
|||
|
|
|||
|
```shell
|
|||
|
mvn deploy:deploy-file -Durl=https://gitea.example.com/api/packages/{owner}/maven -DrepositoryId=gitea -Dfile=/path/to/package.jar
|
|||
|
```
|
|||
|
|
|||
|
| 参数 | 描述 |
|
|||
|
| ------- | -------------- |
|
|||
|
| `owner` | 软件包的所有者 |
|
|||
|
|
|||
|
如果存在相同名称和版本的软件包,您无法发布该软件包。您必须先删除现有的软件包。
|
|||
|
|
|||
|
## 安装软件包
|
|||
|
|
|||
|
要从软件包注册表中安装 Maven 软件包,请在项目的 `pom.xml` 文件中添加新的依赖项:
|
|||
|
|
|||
|
```xml
|
|||
|
<dependency>
|
|||
|
<groupId>com.test.package</groupId>
|
|||
|
<artifactId>test_project</artifactId>
|
|||
|
<version>1.0.0</version>
|
|||
|
</dependency>
|
|||
|
```
|
|||
|
|
|||
|
在 `Gradle Groovy` 中类似的操作如下:
|
|||
|
|
|||
|
```groovy
|
|||
|
implementation "com.test.package:test_project:1.0.0"
|
|||
|
```
|
|||
|
|
|||
|
然后运行:
|
|||
|
|
|||
|
```shell
|
|||
|
mvn install
|
|||
|
```
|
|||
|
|
|||
|
## 支持的命令
|
|||
|
|
|||
|
```
|
|||
|
mvn install
|
|||
|
mvn deploy
|
|||
|
mvn dependency:get:
|
|||
|
```
|