2. 开发前准备¶

2.1 环境¶

2.1.1 git 安装¶

$ apt install git

$ add-apt-repository ppa:git-core/ppa && apt update && apt install git

2.1.2 SDKMAN（推荐）¶

SDKMAN 是一个JVM 平台环境集成管理工具，可以使用它很方便对各版本 sdk的进行管理。例如 jdk， gradle， maven等众多jvm工具版本的切换 安装，卸载等。

SDKMAN! 是一个在 unix 系统环境下，为一些 软件工具包 管理多版本问题的工具。提供了一个方便的命令行接口(CLI)， 方便执行 “安装”, “切换”， “移除”，“列出” 相关版本工具包的命令。它以前被称为 GVM，即 Groovy 环境管理器，其灵感来自于 Ruby 社区普遍使用的非常有用的 RVM 和 rbenv 工具.

• Making life easier. 节省了去官网下载安装的步骤， 省略了环境变量的配置。
• 支持 N 多的 JVM 工具包。例如 Java、 Groovy、 Scala、 Kotlin 和 Ceylon。Ant、 Gradle、 Grails、 Maven、 SBT、 Spark、 Spring Boot、 Vert.x 等。
• 轻量级.用 bash 编写，只需要 curl 和 zip/unzip 就可以出现在系统中，甚至可以与 ZSH 一起工作。

2.1.2.1 SDKMAN安装¶

2.1.2.2 SDK 安装¶

sdkman 如果官方仓库源太慢，建议使用 “本地版本” 安装的方式安装sdk，然后交过sdkman 做版本管理。参阅 SDK 本地版本安装 章节 .

sdk ls java

```bash
sdk install java 8.0.292.j9-adpt
```

2.1.2.3 SDK 本地版本安装¶

因为sdkman仓库网络龟速以及众所周知的原因，当出现网络问题时，建议使用 “本地版本” 安装对应的 sdk 版本，然后将版本管理交给sdkman 来管理.

以下以 本地安装 open jdk8 作为例子来阐述安装步骤：

1. 将 jdk 安装包解压到指定目录，例如 ~/.jdks/ ,解压的完整路径为 ~/.jdks/adopt-openjdk-1.8.0_275,

2. 将本地安装包纳入 sdkman 版本管理 命令格式： sdk install java {自定义版本号} {jdk目录};

   sdk install java 8.0.275 ~/.jdks/adopt-openjdk-1.8.0_275
   

3. 激活版本；

   sdk use java 8.0.275
   

4. 验证当前的 sdkman 管理的当前 java 版本,插卡输出结果。

   sdk current java
   java -version
   

2.1.2.4 常用命令¶

commands:
    install   or i    <candidate> [version] [local-path]                安装sdk
    uninstall or rm   <candidate> <version>                             卸载sdk
    list      or ls   [candidate]                                       列出支持安装的sdk信息
    use       or u    <candidate> <version>                             当前使用 sdk 的版本
    config                                                              编辑 sdk 配置
    default   or d    <candidate> [version]                             默认使用 sdk 版本
    home      or h    <candidate> <version>                             显示 sdk 的home目录
    env       or e    [init|install|clear]                              为当前项目初始化，安装，清理sdk的环境      
    current   or c    [candidate]                                       显示当前 sdk 使用的版本
    flush             [archives|tmp|broadcast|metadata|version]         清理  archives|tmp|broadcast|metadata|version 等缓存空间 

2.1.3 单独手动安装¶

单独安装 sdk 请参阅 官方文档。本节不做描述。

以下为官方 sdk下载网址：

• JDK8
• GRADLE
• MAVEN

2.1.4 环境变量配置¶

windows 环境变量配置窗口： 右键 This PC(此电脑) -> Properties（属性） -> Advanced system settings（高级系统设置） -> Environment Variables（环境变量）...

2.1.4.1 JDK¶

• JAVA_HOME: 一个 JDK 比较重要的环境，很多基于 java环境的工具默认使用该环境变量。

echo "           
JAVA_HOME=/home/luwei/.sdkman/candidates/java/current
export JAVA_HOME
export CLASSPATH=.:${JAVA_HOME}/lib/tools.jar:${JAVA_HOME}/lib/dt.jar
export PATH=$JAVA_HOME/bin:\$PATH" >> ~/.zshrc

2.1.4.2 GRADLE¶

• GRADLE_HOME: GRADLE 的安装路径。
• GRADLE_USER_HOME: 存放 gradle 缓存包的路径。以替换 ~/.gradle 路径。

echo "           
GRADLE_HOME=/data/home/luwei/.sdkman/candidates/gradle/4.10.3
export GRADLE_HOME
export GRADLE_USER_HOME=/data/home/luwei/localGradle
export PATH=$GRADLE_HOME/bin:\$PATH" >> ~/.zshrc

2.1.4.3 MAVEN¶

• MAVEN_HOME: maven 的安装路径。

echo "           
MAVEN_HOME=/data/home/luwei/.sdkman/candidates/maven/3.8.3
export MAVEN_HOME
export PATH=$MAVEN_HOME/bin:\$PATH" >> ~/.zshrc

2.2 项目实践¶

2.2.1 初始化项目¶

由于我们使用 gradle 作为应用管理工具，因此使用 gradle init 初始化一个项目骨架貌似是一个不错的选择。 当然也可以选择 mvn init, idea工具, spring initializr 等等方式来初始化项目

1. 启动终端,初始化；

   gradle init
   

2. 文件确认；

   可以看到一共创建了2个目录和6个文件，其中2个目录和4个文件都跟wrapper有关：

   .
   ├── build.gradle
   ├── gradle
   │   └── wrapper
   │       ├── gradle-wrapper.jar
   │       └── gradle-wrapper.properties
   ├── gradlew
   ├── gradlew.bat
   └── settings.gradle
   

   • gradlew：linux或者Unix下用于执行wrapper命令的Shell脚本
   • gradlew.bat：Windows下用于执行wrapper命令的批处理脚本
   • gradle-wrapper.jar：用于下载Gradle的相关代码实现
   • gradle-wrapper.properties：wrapper所使用的配置信息，比如gradle的版本等信息
   • build.gradle: 用于存放构建相关的Task

3. 增加源码包

   在项目根目录创建以下目录

   • src/main/java: java 源码目录；
   • src/main/resources: 项目静态资源文件目录；
   • src/test: 单元测试目录；

2.2.2 项目管理¶

根目录 build.gradle 包含有整个项目的构建脚本。它的工作包含整个项目的源码构成，插件管理，依赖管理等

最简单的项目 脚本如下：

plugins {                                                             // (1)
    id 'org.springframework.boot' version '2.4.12'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    id 'java'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '1.8'

repositories {                                                      // (2) 
    mavenCentral()
}

dependencies {                                                     // (3) 
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

test {
    useJUnitPlatform()
}

1. 项目插件管理.

2. 依赖包仓库源；

3. 依赖。

2.2.3 构建项目¶

gradle clean build

2.2.4 运行项目¶

java -jar demo.jar