使用Gitee或GitHub托管Maven倉庫JAR包的便捷方法

来源:https://www.cnblogs.com/obullxl/archive/2023/07/01/NTopic2023062201.html
-Advertisement-
Play Games

我們開源了組件的源代碼，希望更多人能更便捷的使用開源組件，最好的辦法當然是把組件的JAR包上傳到Maven中央倉庫，這樣可直接通過Maven/Gradle等方式快速引用和使用。但是要把JAR包上傳到Maven中央倉庫的門檻比較高，本文介紹一種非常簡單的使用GitHub/Gitee作為Maven倉庫的... ...


原文地址：https://ntopic.cn/p/2023062201/

我開源的JAR包的Gitee和GitHub托管的Maven倉庫：

背景說明

在上一篇博客中，我們介紹了開源通用高性能分散式id序列組件（https://ntopic.cn/p/2023062101/）的設計思路，並把源代碼托管在了Gitee（https://gitee.com/obullxl/sequence-jdbc）和GitHub（https://github.com/obullxl/sequence-jdbc）。

我們希望能讓更多人便捷的使用本組件，那麼把JAR包放到到Maven官方的中心倉庫（https://mvnrepository.com）當然是最好的選擇。

然而要把JAR包上傳到Maven官方中心倉庫，步驟比較繁瑣，包括註冊、申請、發佈配置等一系列操作。其實我們的本意只是想把自己的開源項目打包讓大家方便使用，能否有更快捷的方式呢？當然是有的，我們可以使用Gitee或者GitHub作為Maven托管倉庫，把我們的組件JAR包存儲到托管倉庫中。

Gitee/GitHub倉庫設置

由於Gitee和GitHub原理完全一致，下麵截圖說明以Gitee為主（GitHub是我們的主倉庫，Gitee只是同步GitHub倉庫，但這不妨礙我們的配置）。

建議在Gitee中單獨申請一個倉庫，專門用於存放JAR包，比如我的倉庫叫maven-repository：https://gitee.com/obullxl/maven-repository

同時，便於後續多個組件的JAR包能共用一個托管倉庫，JAR包統一放到倉庫的repository目錄中：

image

特別註意：倉庫請請設置為開源，否則其他人使用Maven托管倉庫可能無法訪問，從而無法下載組件JAR包：

image

打包發佈JAR包到倉庫

Gitee托管倉庫設置好之後，開始設置我們打包併發布JAR包了。為便於後面設置打包命令，我們把托管Maven倉庫的目錄maven-repository和id序列組件倉庫的目錄sequence-jdbc放在同一個父目錄中：

OXL-MacBook:CodeSpace obullxl$ ll
drwxr-xr-x   7 obullxl  staff    224  6 24 10:30 maven-repository
drwxr-xr-x  13 obullxl  staff    416  6 24 17:42 sequence-jdbc

組件pom.xml打包配置

完整的配置可直接參考分散式id序列的設置：https://gitee.com/obullxl/sequence-jdbc/blob/master/pom.xml

  • pom.xml文件，一定需要定義groupId/artifactId/version這Maven依賴坐標三要素：
<groupId>cn.ntopic</groupId>
<artifactId>sequence-jdbc</artifactId>
<version>1.0.2</version>
<packaging>jar</packaging>
  • pom.xml文件，配置build節點，指定JAR打包、Deploy發佈的配置（發佈到Maven倉庫的目錄：../maven-repository/repository），即以下配置的altDeploymentRepository內容：
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>2.3.2</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>2.5</version>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-source-plugin</artifactId>
            <version>2.1.2</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>build-helper-maven-plugin</artifactId>
            <version>1.9.1</version>
            <executions>
                <execution>
                    <id>timestamp-property</id>
                    <goals>
                        <goal>timestamp-property</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <name>BuildTime</name>
                <pattern>yyyy-MM-dd HH:mm:ss.SSS</pattern>
                <timeZone>GMT+8</timeZone>
                <regex/>
                <source/>
                <value/>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-antrun-plugin</artifactId>
            <version>1.3</version>
            <executions>
                <execution>
                    <id>generate-release</id>
                    <phase>compile</phase>
                    <goals>
                        <goal>run</goal>
                    </goals>
                    <configuration>
                        <tasks>
                            <!--suppress UnresolvedMavenProperty -->
                            <echo file="${project.basedir}/target/classes/NTopic.Release" message="Version=${project.version}${line.separator}BuildTime=${BuildTime}" />
                        </tasks>
                    </configuration>
                </execution>
            </executions>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-deploy-plugin</artifactId>
            <version>2.7</version>
            <configuration>
                <!-- 特別註意的地方：指定打包的目錄 -->
                <altDeploymentRepository>internal.repo::default::file://${project.basedir}/../maven-repository/repository</altDeploymentRepository>
            </configuration>
        </plugin>
    </plugins>
</build>

打包並上傳到倉庫

  • 打包併發布到本地目錄命令：
mvn clean
mvn deploy -Dmaven.test.skip=true
  • 上傳到遠程倉庫命令：
cd ./../maven-repository
git add --all
git commit -m 'Deploy sequence-jdbc JAR: https://github.com/obullxl/sequence-jdbc'
git push origin master

完整的打包命令，請參考分散式id序列源倉庫代碼：https://gitee.com/obullxl/sequence-jdbc/blob/master/deploy.sh：

#!/bin/bash

# 本地打包
mvn clean && mvn deploy -Dmaven.test.skip=true

# 上傳倉庫
cd ./../maven-repository
git add --all
git commit -m 'Deploy sequence-jdbc JAR: https://github.com/obullxl/sequence-jdbc'
git push origin master

# 返回項目
cd ../sequence-jdbc

# Gitee刷新：人工刷新倉庫，從GitHub同步過來
open -a '/Applications/Microsoft Edge.app' https://gitee.com/obullxl/maven-repository

多個版本完整的Maven托管倉庫內容：

image

其他項目使用JAR包方法

和Maven官方的中心倉庫相比，Gitee托管倉庫沒有本質區別，只需要在pom.xml中配置Gitee的托管倉庫即可，讓Maven知道從哪兒去下載JAR包。

pom.xml中增加倉庫

pom.xml中增加Gitee托管倉庫地址：

<repositories>
  <repository>
    <id>Gitee-obullxl</id>
    <url>https://gitee.com/obullxl/maven-repository/raw/master/repository</url>
  </repository>
</repositories>

或者增加GitHub托管倉庫地址：

<repositories>
   <repository>
      <id>GitHub-obullxl</id>
      <url>https://raw.githubusercontent.com/obullxl/maven-repository/master/repository</url>
   </repository>
</repositories>

Maven配置依賴

和其他JAR包一樣，pom.xml中增加依賴坐標：

<dependency>
    <groupId>cn.ntopic</groupId>
    <artifactId>sequence-jdbc</artifactId>
    <version>1.0.2</version>
</dependency>

本文作者：奔跑的蝸牛，轉載請註明原文鏈接：https://ntopic.cn


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 數據遷移工具，用這8種!
    ETL(是Extract-Transform-Load的縮寫，即數據抽取、轉換、裝載的過程)，對於企業應用來說，我們經常會遇到各種數據的處理、轉換、遷移的場景。 今天特地給大家彙總了一些目前市面上比較常用的ETL數據遷移工具，希望對你會有所幫助。 ...
  • css學習(一)
    本文以 `React`、`Vue` 為例，介紹下主流的渲染模式以及在主流框架中如何實現上述的渲染模式。 ## 前置知識介紹 看渲染模式之前我們先看下幾個主流框架所提供的相關能力，瞭解的可跳到下個章節。 ### 掛載組件到 DOM 節點 這是主流框架最基本的能力，就是將組件渲染到指定的 `DOM` 節 ...
  • vue中封裝伺服器地址/介面與設置請求頭
    1. 設置請求頭 首先創建一個放置伺服器地址的js,如http.js,然後在http.js中引入axios `import axios from "axios";` 如果沒有axios,需要先安裝,npm i axios或者yarn add axois,然後重啟伺服器 ...直接上代碼 點擊查看代碼 ...
  • webman
    不知不覺，《C++面試八股文》已經更新30篇了，這是我第一次寫技術博客，由於個人能力有限，出現了不少紕漏，在此向各位讀者小伙伴們致歉。 為了不誤導更多的小伙伴，以後會不定期的出勘誤文章，請各位小伙伴留意。 在《[C++面試八股文：C++中，設計一個類要註意哪些東西？](https://zhuanla ...
  • go src - sync.Map
    前言 在併發編程中，我們經常會遇到多個goroutine同時操作一個map的情況。如果在這種情況下直接使用普通的map，那麼就可能會引發競態條件，造成數據不一致或者更嚴重的問題。 sync.Map是Go語言中內置的一種併發安全的map，但是他的實現和用法與普通的map完全不同，這篇文章將詳細介紹這些 ...
  • Python潮流周刊#9：如何在本地部署開源大語言模型？
    ## Thinkphp6 連接達夢資料庫 這裡使用 IDEA phpEnv PHP7.3 Thinkphp6 桌面操作系統:Windows11 虛擬機:VMware 伺服器操作系統:銀河麒麟 在虛擬機操作與windows無異 [參考資料](https://blog.csdn.net/chenxuan ...
  • ThinkPHP6.0 鏈式SQL語句
    ## ThinkPHP6.0 鏈式SQL語句 #### 查詢單個數據 ```php $user = Db::query('select * from `user`'); $user=Db::table('user')->where('UserID',1001)->find();//查詢結果為空 返回 ...
  • python的sort函數與sorted函數排序
    1. sort函數 sort函數為python內置的列表排序高階函數,所謂高階函數，也就是參數為函數或返回值為函數。 先看個簡單的例子： # 數字列表的排序示例nums = [5, 2, 9, 1, 7] nums.sort()print(nums) # 輸出：[1, 2, 5, 7, 9] 可以發 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類