为 SOFABoot 配置 JDK 和 Maven 环境

简介: 本文主要为大家介绍 SOFABoot 的环境搭建要求。其中主要涉及 JDK 和 Maven 的安装及配置。

80.jpeg
镜像下载、域名解析、时间同步请点击 阿里巴巴开源镜像站

一、安装 JDK

1. 版本要求

SOFABoot 基于 Spring Boot 框架开发,要求 JDK 版本 ≥ 8。

2. 安装步骤

(1)前往 Oracle 官网下载与您的操作系统相符的 Java SE 安装包
(2)安装 JDK。详情参考 Oracle 官方文档 > 如何安装 JDKInstallation 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 ‘ 加入镜像站官方用户交流群。”

相关文章
|
19天前
|
Java Maven
Maven配置以及IDEA设置(Cannot resolve plugin org.apache.maven.plugins:报错)
Maven配置以及IDEA设置(Cannot resolve plugin org.apache.maven.plugins:报错)
59 1
|
16天前
|
JavaScript 安全 前端开发
Maven实战 Item2 -- Maven项目构建(手动)_term2 配置maven(2)
Maven实战 Item2 -- Maven项目构建(手动)_term2 配置maven(2)
|
16天前
|
前端开发 Java Maven
Maven实战 Item2 -- Maven项目构建(手动)_term2 配置maven(1)
Maven实战 Item2 -- Maven项目构建(手动)_term2 配置maven(1)
|
19天前
|
IDE Java Shell
02|手把手教你安装JDK与配置主流IDE
02|手把手教你安装JDK与配置主流IDE
35 0
|
19天前
|
Java
JDK环境下利用记事本对java文件进行运行编译
JDK环境下利用记事本对java文件进行运行编译
17 0
|
19天前
|
IDE Java 应用服务中间件
JDK1.6.0+Tomcat6.0的安装配置(配置JAVA环境)
JDK1.6.0+Tomcat6.0的安装配置(配置JAVA环境)
24 1
|
19天前
|
Java Maven
修改配置maven镜像仓库位置,将maven镜像更换成阿里镜像
修改配置maven镜像仓库位置,将maven镜像更换成阿里镜像
256 0
|
19天前
|
XML Java 测试技术
【你的Maven配置出错?看这个】
【你的Maven配置出错?看这个】
24 1
|
19天前
|
缓存 Java 关系型数据库
【超全详解】Maven工程配置与常见问题解决指南
检查Maven配置包括验证路径、设置pom.xml与Project Structure的Java版本。基本操作有`clean-compile`、`install`和`package`,其中`install`会将jar包放入本地仓库。获取他人工程后需修改配置、清除缓存、更新依赖等。配置文件应从Maven Repository找寻,选择稳定高版本。创建Maven工程可选archetype如`quickstart`或直接创建Java工程。基本目录结构遵循分层设计原则,常见问题包括假性导包、端口占用、时区问题等,对应解决方案包括删除本地仓库文件、调整系统设置或重新加载项目。
67 6
【超全详解】Maven工程配置与常见问题解决指南
|
16天前
|
Java Apache Maven
Maven 项目文档
在C:/MVN下,使用命令`mvn archetype:generate -DgroupId=com.companyname.bank -DartifactId=consumerBanking -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false`创建Maven Java项目。确保`pom.xml`包含`maven-site-plugin`和`maven-project-info-reports-plugin`配置,版本分别至少为3.3和2.7,以避免`NoClassDefFoundError`。