本文主要向您講述 SOFABoot 的環境搭建要求。主要涉及 JDK 和 Maven 的安裝及配置。
安裝 JDK
版本要求
SOFABoot 基于 Spring Boot 框架開發,要求 JDK 版本 ≥ 8。
安裝步驟
前往 Oracle 官網下載并安裝與您的操作系統相符的 Java SE 安裝包 。詳情參考 安裝 JDK 或 Installation Guide(英文)。
配置系統環境變量。 詳情參考 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
檢查 Java 是否安裝成功:
$ java -version
說明符號 $ 在 Windows 系統上不需要輸入。
安裝 Apache Maven
版本要求
SOFABoot 要求 Apache Maven 版本 ≥ 3.2.5。
安裝步驟
前往 Apache Maven 官網 下載安裝包。
解壓安裝包文件至安裝目錄:
$ unzip apache-maven-3.6.1-bin.zip
或
$ tar xzvf apache-maven-3.6.1-bin.tar.gz
配置環境變量:
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
在新的 Shell 終端中檢查 Maven 是否安裝成功:
$ mvn -v
更多信息,請參考 Apache Maven 官方文檔 。
修改 Maven 本地配置文件
修改步驟
SOFABoot 的 JAR 包并未上傳到 Maven 的中央倉庫。為便于在構建工程時能夠正常下載所依賴的 JAR 包,您需要:
找到本地 Maven 路徑下的
settings.xml
文件。在不同操作系統中,您可參考下述路徑,進行查找。系統全局配置文件路徑:
Windows 系統:$M2_HOME/conf/settings.xml
Linux or macOS: $M2_HOME/conf/settings.xml
說明當用戶配置文件和系統配置文件都存在時,它們的內容將被合并,用戶settings.xml文件占主導地位。
用戶配置文件路徑:
Windows 系統:${user.home}/.m2/settings.xml。示例如下:
C:/Users/userName_XXX/.m2/settings.xml
說明.m2 文件夾需要注釋掉系統全局配置文件settings.xml里的
<localRepository>D:/maven/repository</localRepository>
,然后執行mvn help:system
命令才會生成。settings.xml 非系統默認生成文件,需要手動拷貝過來。
Linux or macOS: ${user.home}/.m2/settings.xml。示例如下:
/Users/userName_XXX/.m2/settings.xml
重要Linux or macOS 系統上,.m2 目錄可能被隱藏。macOS 可以通過
Command + Shift + .
進行查看;Linux 可以通過Ctrl + H
進行查看。
單擊 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>