GiteeをMavenリポジトリとして利用し、自作のJARパッケージを公開する方法

この記事では、Gitee(中国版GitHub)を無料のMavenリポジトリとして利用し、自作のJavaライブラリ(JARファイル)を公開する手順を解説します。これにより、プロジェクト間で簡単に再利用可能なライブラリを管理できます。

まず、Giteeアカウントを作成し、公開リポジトリを作成します。リポジトリ名は任意ですが、公開設定である必要があります。例えば、my-gitee-account/maven-repo のようなリポジトリを作成します。

ステップ1: プロジェクトのpom.xmlを設定する

公開したいJARパッケージのプロジェクトの pom.xml に、デプロイ先を指定する distributionManagement セクションを追加します。この設定は、Mavenがアーティファクトを一時的に保存するローカルディレクトリを指します。

<distributionManagement>
    <repository>
        <!-- 任意のIDを設定します -->
        <id>my-maven-repo</id>
        <!-- ローカルのディレクトリパスを指定します -->
        <url>file:C:/my-maven-repo/</url>
    </repository>
</distributionManagement>

ステップ2: Mavenデプロイを実行する

ターミナルまたはコマンドプロンプトで、プロジェクトのルートディレクトリに移動し、以下のコマンドを実行してアーティファクトをローカルディレクトリにデプロイします。

mvn deploy -DaltDeploymentRepository=my-maven-repo::default::file:C:/my-maven-repo/

IDE(如 IntelliJ IDEA)のMavenツールウィンドウからも、deploy ゴールを直接実行できます。

ステップ3: Giteeリポジトリにプッシュする

デプロイが完了すると、ローカルディレクトリ(C:/my-maven-repo/)にMavenリポジトリのファイル構造が生成されます。これをGiteeリポジトリにプッシュします。

  1. ローカルディレクトリをGitリポジトリとして初期化します: git init
  2. すべてのファイルをステージングします: git add .
  3. コミットします: git commit -m "Initial commit of maven artifacts"
  4. リモートリポジトリを設定します(my-gitee-account/maven-repoを自分のリポジトリ名に置き換えてください):
    git remote add origin https://gitee.com/my-gitee-account/maven-repo.git
  5. リモートリポジトリにプッシュします:
    git push -u origin main

以降、新しいバージョンのJARを公開する際は、再度デプロイしてから、このローカルリポジトリの変更をコミット・プッシュしてください。

ステップ4: 公開したJARを利用する

次に、公開したJARを別のMavenプロジェクトで利用する方法を説明します。新しいMavenプロジェクトの pom.xml に、先ほど作成したGiteeリポジトリを repositories として追加します。

<repositories>
    <repository>
        <id>my-maven-repo</id>
        <url>https://gitee.com/my-gitee-account/maven-repo/raw/main</url>
    </repository>
</repositories>

リポジトリが設定できたら、依存関係としてJARを追加します。グループID、アーティファクトID、バージョンは、デプロイしたパッケージに応じて指定します。

<dependency>
    <groupId>com.example</groupId>
    <artifactId>my-awesome-library</artifactId>
    <version>1.0.0</version>
</dependency>

タグ: Gitee Maven Java Git JAR

7月13日 00:43 投稿