docs/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/maven.md

date, slug, sidebar_position

date	slug	sidebar_position
2021-07-20T00:00:00+00:00	maven	60

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 {
    // 其他倉庫
    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 的情況下，調用帶有任務 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: