鏡像下載、域名解析、時間同步請點擊 阿里巴巴開源鏡像站
一、安裝 JDK
1. 版本要求
SOFABoot 基於 Spring Boot 框架開發,要求 JDK 版本 ≥ 8。
2. 安裝步驟
(1)前往 Oracle 官網下載與您的操作系統相符的 Java SE 安裝包 。
(2)安裝 JDK。詳情參考 Oracle 官方文檔 > 如何安裝 JDK 或 Installation Guide(英文)。
(3)配置系統環境變量。 詳情參考 Oracle 官方文檔變量 PATH 和 CLASSPATH 介紹與配置(英文)。
-
Windows 系統:
-
JAVA_HOME
:配置為 JDK 的安裝路徑,如C:\Program Files\Java\jdk1.8.0_181
。 -
PATH
:增加%JAVA_HOME%\bin
文件夾路徑。多個路徑間使用英文分號(;)分隔。
-
- MacOS 及 Linux 系統:示例如下。如果使用 binary 安裝包 (dmg 或 RPM),您可能無需手動配置環境變量。可直接跳至下一步檢查 Java 是否可用。
export JAVA_HOME=/${path_to_jdk_dir}/jdk1.8.0_181
export PATH=/${path_to_jdk_dir}/jdk1.8.0_181/bin:$PATH
(4)檢查 Java 是否安裝成功:
$ java -version
二、安裝 Apache Maven
1. 版本要求
SOFABoot 要求 Apache Maven 版本 ≥ 3.2.5。
2. 安裝步驟
(1)前往 Apache Maven 官網 下載安裝包。
(2)解壓安裝包文件至安裝目錄:
$ unzip apache-maven-3.6.1-bin.zip
或:
$ tar xzvf apache-maven-3.6.1-bin.tar.gz
(3)配置環境變量:
-
Windows 系統:
-
M2_HOME
:配置為 Maven 的安裝路徑。 -
PATH
:增加%M2_HOME%\bin
路徑。多個路徑間使用英文分號(;)分隔。
-MacOS 及 Linux 系統: 示例如下。
-
export M2_HOME=/${path_to_maven_dir}/apache-maven-3.6.1
export PATH=/${path_to_maven_dir}/apache-maven-3.6.1/bin:$PATH
(4)在新的 shell 終端中檢查 Maven 是否安裝成功:
$ mvn -v
更多信息,請參考 Apache Maven 官方文檔 。
3. 修改 Maven 本地配置文件
修改步驟
SOFABoot 的 JAR 包並未上傳到 Maven 的中央倉庫。為便於在構建工程時能夠正常下載所依賴的 JAR 包,您需要:
(1)找到本地 Maven 路徑下的settings.xml
文件。在不同操作系統中,您可參考下述路徑,進行查找。
默認安裝路徑:
- Windows 系統:${User directory}.m2settings.xml。示例如下:
C:\Users\userName_XXX\.m2\settings.xml
- Linux or Mac OS: ${User directory}/.m2/settings.xml。示例如下:
/Users/userName_XXX/.m2/settings.xml
注意:Linux or Mac OS 系統上,.m2 目錄可能被隱藏。Mac OS 可以通過
Command + Shift + .
進行查看;Linux 可以通過Ctrl + H
進行查看。
自定義安裝路徑:
- Windows 系統:${Maven 在本機的安裝路徑}confsettings.xml
- Linux or Mac OS: ${Maven 在本機的安裝路徑}/conf/settings.xml
(2)點擊 settings,下載 Maven 的 settings.xml
文件,拷貝到步驟 1 路徑下,或覆蓋掉步驟 1 路徑下的settings.xml
文件。
注意:
- 通過 Maven 命令創建工程時,默認使用的是 Maven 默認安裝路徑下的
settings.xml
文件,推薦將下載好的settings.xml
文件複製到 .m2 目錄下,如果 .m2 目錄下已有對應同名文件,建議將其覆蓋掉。- 如果想使用自定義路徑下的 Maven
settings.xml
,建議在 Maven 命令中,通過mvn -s "file_path"
進行指定,示例如下:mvn -s "C:\apache-maven-3.3.3\conf\settingsXXX.xml"
。
配置說明
完成上述步驟 2 的覆蓋操作後,settings.xml
中已經配置好的信息主要包括 profile 標籤。
- profile 標籤:用來配置一些全局信息及其激活條件,主要包括一些倉庫標籤,內容如下:
<profile>
<id>cloud-open-archetype</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<repositories>
<repository>
<id>archetype</id> <!-- Don't change this! -->
<url>http://mvn.cloud.alipay.com/nexus/content/groups/open</url>
<releases>
<enabled>true</enabled>
<checksumPolicy>fail</checksumPolicy>
</releases>
<snapshots>
<enabled>true</enabled>
<checksumPolicy>warn</checksumPolicy>
</snapshots>
</repository>
</repositories>
</profile>
- mirror 標籤:用來從鏡像倉庫中,快速下載所需要的 JAR 包。如果由於依賴導致工程不能啟動,可以考慮自行添加鏡像標籤。
“ 阿里巴巴開源鏡像站 提供全面,高效和穩定的鏡像下載服務。釘釘搜索 ' 21746399 ‘ 加入鏡像站官方用戶交流群。”