この記事では、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リポジトリにプッシュします。
- ローカルディレクトリをGitリポジトリとして初期化します:
git init - すべてのファイルをステージングします:
git add . - コミットします:
git commit -m "Initial commit of maven artifacts" - リモートリポジトリを設定します(
my-gitee-account/maven-repoを自分のリポジトリ名に置き換えてください):git remote add origin https://gitee.com/my-gitee-account/maven-repo.git - リモートリポジトリにプッシュします:
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>