mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-12-13 06:13:18 +01:00
bd4c7ce578
This PR cleans up the docs in a way to make them simpler to ingest by our [docs repo](https://gitea.com/gitea/gitea-docusaurus). 1. It includes all of the sed invocations our ingestion did, removing the need to do it at build time. 2. It replaces the shortcode variable replacement method with `@variable@` style, simply for easier sed invocations when required. 3. It removes unused files and moves the docs up a level as cleanup. --------- Signed-off-by: jolheiser <john.olheiser@gmail.com>
4 KiB
4 KiB
date | title | slug | sidebar_position | draft | toc | menu | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2021-07-20T00:00:00+00:00 | Maven 软件包注册表 | maven | 60 | false | false |
|
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 variant
如果您计划在项目中添加来自 Gitea 实例的一些软件包,请将其添加到 repositories 部分中:
repositories {
// other repositories
maven { url "https://gitea.example.com/api/packages/{owner}/maven" }
}
在 Groovy gradle 中,您可以在发布部分中包含以下脚本:
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)
}
}
}
}
发布软件包
要发布软件包,只需运行以下命令:
mvn deploy
或者,如果您使用的是 Gradle,请使用 gradle
命令和 publishAllPublicationsToGiteaRepository
任务:
./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: