在 Maven 的術語中,倉庫是一個位置(place)。
Maven 倉庫是項目中依賴的第三方庫,這個庫所在的位置叫做倉庫。
在 Maven 中,任何一個依賴、插件或者項目建構的輸出,都可以稱之為構件。
Maven 倉庫能幫助我們管理構件(主要是JAR),它就是放置所有JAR檔案(WAR,ZIP,POM等等)的地方。
Maven 倉庫有三種類型:
- 本地(local)
- 中央(central)
- 遠端(remote)
本地倉庫
Maven 的本地倉庫,在安裝 Maven 後并不會建立,它是在第一次執行 maven 指令的時候才被建立。
運作 Maven 的時候,Maven 所需要的任何構件都是直接從本地倉庫擷取的。如果本地倉庫沒有,它會首先嘗試從遠端倉庫下載下傳構件至本地倉庫,然後再使用本地倉庫的構件。
預設情況下,不管Linux還是 Windows,每個使用者在自己的使用者目錄下都有一個路徑名為 .m2/repository/ 的倉庫目錄。
Maven 本地倉庫預設被建立在 %USER_HOME% 目錄下。要修改預設位置,在 %M2_HOME%\conf 目錄中的 Maven 的 settings.xml 檔案中定義另一個路徑。
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<localRepository>C:/MyLocalRepository</localRepository>
</settings>
當你運作 Maven 指令,Maven 将下載下傳依賴的檔案到你指定的路徑中。
中央倉庫
Maven 中央倉庫是由 Maven 社群提供的倉庫,其中包含了大量常用的庫。
中央倉庫包含了絕大多數流行的開源Java構件,以及源碼、作者資訊、SCM、資訊、許可證資訊等。一般來說,簡單的Java項目依賴的構件都可以在這裡下載下傳到。
中央倉庫的關鍵概念:
- 這個倉庫由 Maven 社群管理。
- 不需要配置。
- 需要通過網絡才能通路。
要浏覽中央倉庫的内容,maven 社群提供了一個 URL:http://search.maven.org/#browse。使用這個倉庫,開發人員可以搜尋所有可以擷取的代碼庫。
遠端倉庫
如果 Maven 在中央倉庫中也找不到依賴的檔案,它會停止建構過程并輸出錯誤資訊到控制台。為避免這種情況,Maven 提供了遠端倉庫的概念,它是開發人員自己定制倉庫,包含了所需要的代碼庫或者其他工程中用到的 jar 檔案。
舉例說明,使用下面的 pom.xml,Maven 将從遠端倉庫中下載下傳該 pom.xml 中聲明的所依賴的(在中央倉庫中擷取不到的)檔案。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.companyname.projectgroup</groupId>
<artifactId>project</artifactId>
<version>1.0</version>
<dependencies>
<dependency>
<groupId>com.companyname.common-lib</groupId>
<artifactId>common-lib</artifactId>
<version>1.0.0</version>
</dependency>
<repositories>
<repository>
<id>companyname.lib1</id>
<url>http://download.companyname.org/maven2/lib1</url>
</repository>
<id>companyname.lib2</id>
<url>http://download.companyname.org/maven2/lib2</url>
</repositories>
</project>
Maven 依賴搜尋順序
當我們執行 Maven 建構指令時,Maven 開始按照以下順序查找依賴的庫:
- 步驟 1 - 在本地倉庫中搜尋,如果找不到,執行步驟 2,如果找到了則執行其他操作。
- 步驟 2 - 在中央倉庫中搜尋,如果找不到,并且有一個或多個遠端倉庫已經設定,則執行步驟 4,如果找到了則下載下傳到本地倉庫中以備将來引用。
- 步驟 3 - 如果遠端倉庫沒有被設定,Maven 将簡單的停滞處理并抛出錯誤(無法找到依賴的檔案)。
- 步驟 4 - 在一個或多個遠端倉庫中搜尋依賴的檔案,如果找到則下載下傳到本地倉庫以備将來引用,否則 Maven 将停止處理并抛出錯誤(無法找到依賴的檔案)。
Maven 阿裡雲(Aliyun)倉庫
Maven 倉庫預設在國外, 國内使用難免很慢,我們可以更換為阿裡雲的倉庫。
修改 maven 根目錄下的 conf 檔案夾中的 settings.xml 檔案,在 mirrors 節點上,添加内容如下:
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿裡雲公共倉庫</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
如果想使用其它代理倉庫,可在 <repositories></repositories> 節點中加入對應的倉庫使用位址。以使用 spring 代理倉為例:
<repository>
<id>spring</id>
<url>https://maven.aliyun.com/repository/spring</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
</snapshots>
</repository>
在你的 pom.xml 檔案 <denpendencies></denpendencies> 節點中加入你要引用的檔案資訊:
<dependency>
<groupId>[GROUP_ID]</groupId>
<artifactId>[ARTIFACT_ID]</artifactId>
<version>[VERSION]</version>
</dependency>
執行拉取指令:
mvn install
gradle 配置指南
在 build.gradle 檔案中加入以下代碼:
allprojects {
repositories {
maven {
url 'https://maven.aliyun.com/repository/public/'
}
mavenLocal()
mavenCentral()
}
}
如果想使用其它代理倉,以使用spring倉為例,代碼如下:
allProjects {
url 'https://maven.aliyun.com/repository/spring/'
加入你要引用的檔案資訊:
dependencies {
compile '[GROUP_ID]:[ARTIFACT_ID]:[VERSION]'
執行以下指令安裝依賴:
gradle dependencies
或
./gradlew dependencies