使用國內 maven 鏡像 代替國外 mirror


使用maven的都知道國外的maven下載一個是比較慢,一個是因為被牆,一些jar包無法下載,非常老火。

比如出現類似下面的錯誤:

 Unknown host repo.maven.apache.org -> [Help 1] [ERROR

oschina.net搭建了國內 鏡像,經測試,速度很快。下面是oschina.net的介紹。

查找依賴包地址: OSChina Maven http://maven.oschina.net/home.html

http://maven.oschina.net/help.html

介紹

親愛的小伙伴們,開源中國的 Maven 庫上線咯!為了方便廣大開發同學,開源中國特別推出國內的 Maven 中央庫,提供高速穩定的網絡和服務,為國內 Maven 使用者提供便捷服務。本 Maven 庫是從 ibiblio 同步過來的,因為網絡等原因,保持每天一次更新。本 Maven 庫使用開源軟件 Nexus 搭建,對外鏡像鏈接地址為:  http://maven.oschina.net/content/groups/public/  

使用

接下來將簡單介紹如何在您的項目中使用 Maven,以及使用 OSChina 提供的 Maven 服務。

1.安裝 Maven 

如果需要使用到 Maven ,必須首先安裝 Maven , Maven 的下載地址在 Apache Maven 中有,您也可以點擊這里下載 zip ,tar.gz

下載好 Maven 后,需要簡單安裝下。將下載的  zip  或者  tar.gz  包解壓到需要安裝到的目錄。 接下簡單配置下環境變量:

1、新建環境變量  M2_HOME  ,輸入值為 Maven 的安裝目錄。

2、新建環境變量  M2  ,輸入值為:  %M2_HOME%\bin  。

3、將 M2 環境變量加入  Path  的最后,如:  ;%M2%  ;。

環境變量就這么簡單配置下就可以了。打開命令行窗口輸入  mvn -version  。可以看到如下輸出:


 

看到以上輸出,您的 Maven 環境就已經搭建好了。

2.修改 settings.xml

在 Maven 中使用 OSChina 的 Maven 服務還需要簡單配置一下 Maven,在 Maven 的安裝目錄下的 conf 文件下有個  settings.xml  文件,接下來我們需要對這個文件做簡單的修改,修改前您可以簡單備份下該文件。 打開  settings.xml  文件,按下面內容修改。或者點擊 settings.xml 下載


01 <mirrors>
02     <!-- mirror | Specifies a repository mirror site to use instead of a given
03         repository. The repository that | this mirror serves has an ID that matches
04         the mirrorOf element of this mirror. IDs are used | for inheritance and direct
05         lookup purposes, and must be unique across the set of mirrors. | -->
06     <mirror>
07         <id>nexus-osc</id>
08         <mirrorOf>*</mirrorOf>
09         <name>Nexus osc</name>
10         <url>http://maven.oschina.net/content/groups/public/</url>
11     </mirror>
12 </mirrors>

補充:  如果還需要osc的thirdparty倉庫或多個倉庫,需要如下修改:詳情 
01 <mirrors>
02     <!-- mirror | Specifies a repository mirror site to use instead of a given
03         repository. The repository that | this mirror serves has an ID that matches
04         the mirrorOf element of this mirror. IDs are used | for inheritance and direct
05         lookup purposes, and must be unique across the set of mirrors. | -->
06     <mirror>
07         <id>nexus-osc</id>
08         <mirrorOf>central</mirrorOf>
09         <name>Nexus osc</name>
10         <url>http://maven.oschina.net/content/groups/public/</url>
11     </mirror>
12     <mirror>
13         <id>nexus-osc-thirdparty</id>
14         <mirrorOf>thirdparty</mirrorOf>
15         <name>Nexus osc thirdparty</name>
16         <url>http://maven.oschina.net/content/repositories/thirdparty/</url>
17     </mirror>
18 </mirrors>

這里是配置 Maven 的 mirror 地址指向OSChina 的 Maven 鏡像地址。 在執行 Maven 命令的時候, Maven 還需要安裝一些插件包,這些插件包的下載地址也讓其指向 OSChina 的 Maven 地址。修改如下內容。


01 <profile>
02     <id>jdk-1.4</id>
03  
04     <activation>
05         <jdk>1.4</jdk>
06     </activation>
07  
08     <repositories>
09         <repository>
10             <id>nexus</id>
11             <name>local private nexus</name>
12             <url>http://maven.oschina.net/content/groups/public/</url>
13             <releases>
14                 <enabled>true</enabled>
15             </releases>
16             <snapshots>
17                 <enabled>false</enabled>
18             </snapshots>
19         </repository>
20     </repositories>
21     <pluginRepositories>
22         <pluginRepository>
23             <id>nexus</id>
24             <name>local private nexus</name>
25             <url>http://maven.oschina.net/content/groups/public/</url>
26             <releases>
27                 <enabled>true</enabled>
28             </releases>
29             <snapshots>
30                 <enabled>false</enabled>
31             </snapshots>
32         </pluginRepository>
33     </pluginRepositories>
34 </profile>

如果您需要修改 Maven 的默認文件保存路徑,需要在 settings.xml 文件中修改如下地方。


1 <localRepository>F:/Maven/repo/m2/</localRepository>

按照如上修改  settings.xml  之后,您就可以在自己的 Maven 中使用 OSChina 為您提供的 Maven 服務了。

 

3.使用 Maven 創建項目

您可以創建一個屬於自己的 Maven 項目來簡單測試一下 OSChina 的 Maven 庫。創建 Maven 項目很簡單,只需要簡單一行命令就可以搞定。 
下面是創建 Maven 項目的命令:

1 mvn archetype:create -DgroupId=oschina -DartifactId=simple -DpackageName=net.oschina.simple  -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
 。

 

其中   -DarchetypeArtifactId=maven-archetype-webapp   代表創建一個簡單的 webapp 項目。至於其他參數的意思,您可以查看下 Maven 的相關文檔。 在您需要創建 Maven 項目的文件夾下用命令行執行以上命令。可以看到如下輸出: 

如果順利創建成功的話,你會看到如下輸出:



如果創建失敗,就可能需要您去 Google 一下了。創建項目的時候,Maven 會下載一些需要用到的 Maven 插件。

4.添加包依賴

因為只是簡單介紹下使用 OSChina 的 Maven 庫,關於 Maven 的項目編譯,打包,測試,發布等具體細節就不多介紹了,您可以去查看 Maven 的相關文檔。
跟ant一樣,Maven 也需要通過 xml 來配置。在項目的根目錄下有一個  pom.xml  文件。

01 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
02     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
03     <modelVersion>4.0.0</modelVersion>
04     <groupId>oschina</groupId>
05     <artifactId>oschina.simple</artifactId>
06     <packaging>war</packaging>
07     <version>1.0</version>
08     <name>oschina.simple Maven Webapp</name>
09     <url>http://maven.apache.org</url>
10     <dependencies>
11         <dependency>
12             <groupId>junit</groupId>
13             <artifactId>junit</artifactId>
14             <version>3.8.1</version>
15             <scope>test</scope>
16         </dependency>
17     </dependencies>
18     <build>
19         <finalName>oschina.simple</finalName>
20     </build>
21 </project>

在 pom.xml 中加入您需要添加的包,如果您需要查找依賴包有哪些版本,可以在 OSChina Maven 搜索。比如輸入 jedis 的結果會如下:

在右下角的 Maven 標簽下可以看到當前選中的版本的依賴 xml,copy 該依賴 xml 到  pom.xml  的  dependencies  結點下。如果需要其他依賴包,您也繼續搜索。當然,有些偏門的 jar 可能沒有,這主要可能是它沒有提交到 Maven 的中央庫中。

5.將項目安裝到本地 repository

添加好包的依賴之后,您就可以開始在您的 Maven 項目下開始工作了。如果一切准備就緒,您可能需要將項目安裝到本地  repository  。
執行命令: mvn clean & mvn install 就可以把項目安裝到您配置的本地鏡像地址  .m2/repository  下了。 執行命令可以看到如下輸出: 

執行完之后,如果安裝成功會出現如下結果: 

如果失敗了,就根據失敗結果 Google 一下吧! 接下來打開您配置的本地  repository  地址,可以看到您配置的各種依賴包都下載到您本地文件夾了,下次您再使用這些包的時候就不需要再次下載了,項目構建速度也會提高很多。

項目上傳說明

開源中國 Maven 庫的第三方庫中上傳的構件信息僅僅存在於本庫中,我們不向 Maven 中央庫推送任何有關您上傳的構件。如果有需要將您的構件上傳到 Maven 中央庫,請前往 Maven中央庫,如果您的構件在中央庫中申請通過,並且在本庫中存在版本,請通知 @卜祥龍 處理。鑒於上傳到本 Maven 庫中的構件信息直接放在對外開放的 public group 中會誤導用戶,此第三方庫未配置到 public group ,如果您的項目中有需要用到其中的構件,請在項目中單獨配置此地址:http://maven.oschina.net/content/repositories/thirdparty/ 。

感謝

以上就是關於 OSChina Maven 的簡單使用說明,多謝您的使用,您的支持就是我們最大的動力,同時也感謝天翼雲的服務支持。

===================================

注:

如果修改之后,eclipse 每次打開時 maven 不斷的去下載 pom.xml 文件,導致eclipse上的任何操作被阻塞時,可以將上面添加的 profile 元素整個注釋掉就行了。具體原因不明,請知道原因的同學指點一下。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM