為 SOFABoot 配置 JDK 和 Maven 環境

鏡像下載下傳、域名解析、時間同步請點選

阿裡巴巴開源鏡像站

一、安裝 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

SOFABoot 要求 Apache Maven 版本 ≥ 3.2.5。

（1）前往 Apache Maven 官網

下載下傳安裝包

（2）解壓安裝封包件至安裝目錄:

$ unzip apache-maven-3.6.1-bin.zip           

或：

$ tar xzvf apache-maven-3.6.1-bin.tar.gz           

（3）配置環境變量：

• • 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 ‘ 加入鏡像站官方使用者交流群。”