[Spring] STS 4 설치 및 설정하기(Spring Tool Suite 4)

Spring 개발을 위한 개발도구인 STS4(Spring Tool Suite 4)를 설치해보도록 하겠습니다.

STS는 Spring 기반 엔터프라이즈 애플리케이션 개발을 위한 도구입니다. STS 말고도 일반 Eclipse나 IntelliJ IDEA도 사용 가능하니 참고하시기 바랍니다.

STS 설치에 앞서 기본적으로 Java 설치가 필요합니다. 아직 Java 설치가 안 되었다면 아래 게시물을 참고하여 Java를 설치해주시기 바랍니다. STS에 내장 JRE가 포함되어 있기는 하지만 원하는 버전의 Java를 사용하기 위해 여기서는 OpenJDK 11 버전을 설치하도록 하겠습니다.

 

Java 설치

[Java] OpenJDK 설치하기(JDK Builds from Oracle)

 

STS 4 다운로드

본격적인 설치를 위해 STS를 다운로드 받도록 하겠습니다. 아래 사이트에 접속하여 자신의 운영체제에 맞는 STS를 다운로드 받도록 합니다. 저는 Windows 운영체제를 사용중이라 Windows 버전으로 다운로드 받도록 하겠습니다.

 

Spring Tools 4 is the next generation of Spring tooling

 

 

 

STS 4 설치

다운로드를 받으면 아래와 같이 jar 파일이 다운로드 됩니다. 이게 뭔가 싶지만 당황하지 않고 jar 파일 압축을 풀어줍니다. 저는 반디집을 이용해 압축을 풀어주었습니다.

 

 

압축 해제 한 폴더로 들어가면 아래와 같이 contents.zip 이라는 이름의 압축 파일이 또 있는 것을 확인 할 수 있습니다. 이 파일도 동일하게 다시 압축을 풀어줍니다. (보기 안 좋은 것들이 함께 캡쳐 되었군요.. 😭)

 

 

다시 압축 해제 한 폴더로 들어가면 아래와 같이 STS 폴더가 있는 것을 확인 할 수 있습니다. 이 폴더가 우리가 앞으로 사용하게 될 STS 폴더 입니다.

 

 

폴더 안으로 들어가서 바로 사용해도 되겠지만 폴더를 사용하기 좋은 자신만의 디렉토리로 옮겨줍니다. 저는 보통 Dev 폴더에 tools 폴더를 만들어 개발 관련 도구들을 담아두곤 합니다. 그래서 저는 Dev/tools 경로에 STS 폴더를 이동시키도록 하겠습니다. 아래 사진을 보시면 아시겠지만 STS 말고도 다른 것들이 있는 것을 보실 수 있습니다. 저는 이런식으로 관리하는 편입니다.

 

 

 

STS 4 실행

STS 폴더를 원하는 위치로 다 옮겼으면 이제 폴더 안으로 들어갑니다. 보면 SpringToolSuite4.exe 라는 파일이 보일겁니다. 이 파일이 STS를 실행하는 파일입니다. 파일을 더블 클릭 하여 STS를 실행시켜 줍니다.

 

 

파일을 실행하면 아래와 같은 화면이 나오고 workspace 경로를 선택하라는 창이 나옵니다. workspace는 작업 공간을 뜻하는데 선택한 경로에 앞으로 내가 작업하는 파일들이 위치하게 됩니다. 저는 개인적으로 Dev 폴더에 projects 폴더를 만들어 소스 파일을 관리하는 편입니다. 그래서 아래와 같이 projects 폴더 밑에 sts-workspace 폴더를 만들어 해당 폴더를 workspace로 선택해주었습니다.

 

 

짜쟌! workspace 설정까지 마치면 아래와 같이 STS가 정상 실행되게 됩니다.

 

 

 

STS 4 기본 설정

STS 설치를 마쳤으면 원활한 STS 사용을 위한 기본적인 설정을 해주도록 하겠습니다. STS 화면에서 [Window - Preferences] 메뉴를 클릭합니다.

 

JRE 설정

Preferences 창 화면 왼쪽 상단에 "installed" 라고 입력해서 나오는 Java 하위의 Installed JREs를 클릭합니다. 우리는 위에서 OpenJDK 11 버전을 설치하였습니다. 하지만 STS의 JRE 설정에 들어가보니 기본 JRE로 STS에 내장된 JRE가 설정되어 있는 것을 볼 수 있습니다. [Add...] 버튼을 눌러 위에서 설치한 JDK 11을 기본 JRE로 설정해주도록 하겠습니다. [Add...] 버튼을 클릭합니다.

 

 

Standard VM을 선택하고 [Next >] 버튼을 클릭합니다.

 

 

[Directory...] 버튼을 눌러 JDK가 설치된 경로를 선택해주고 하단에 관련 jar가 추가된 것을 확인 후 [Finish] 버튼을 클릭합니다.

 

 

그럼 아래와 같이 방금 추가한 jdk-11이 추가된 것을 확인 할 수 있습니다. 새로 추가된 jdk-11에 V 체크를 하고 [Apply] 버튼을 눌러 기본 JRE로 설정해줍니다.

 

 

 

Compiler 설정

Preferences 창 화면 왼쪽 상단에 "compiler" 라고 입력해서 나오는 Java 하위의 Compiler를 클릭합니다. 화면 우측 상단의 버전이 위의 JRE에서 설정한 버전과 맞는지 확인하고 다르면 동일하게 11로 변경해줍니다. 그리고 [Apply] 버튼을 눌러 적용합니다.

 

 

Encoding 설정

Preferences 창 화면 왼쪽 상단에 "encoding" 이라고 입력해서 나오는 General 하위의 Content Types를 클릭합니다. 화면의 Content types 항목에서 "> Text"를 클릭합니다. 클릭 후 화면 하단의 Default encoding 값이 "UTF-8"인지 확인하고 값이 없거나 다른 값이라면 "UTF-8"을 입력하고 우측의 [Update] 버튼을 클릭해 적용합니다.

 

 

일괄로 적용했더라도 하나씩 살펴보면 적용이 안 된 항목들이 있습니다. "> Text"의 ">"를 클릭해 하위 항목들을 펼쳐 하나씩 보다보면 아래와 같이 Java Properties File 이라던지 Spring Properties File 항목의 값이 "UTF-8"이 아닌 다른 값이 셋팅되어 있는걸 확인 할 수 있습니다. 그런 경우 값을 "UTF-8"로 변경하고 [Update] 버튼을 눌러 적용 시킵니다.

 

 

General 하위의 Workspace를 클릭합니다. 창 하단의 Text file encoding에 설정된 값이 "UTF-8"인지 확인하고 아니라면 아래와 같이 "UTF-8"로 설정 후 [Apply] 버튼을 눌러 적용 시킵니다.

 

 

 

Gradle 설정

마지막으로 Gradle 설정을 하도록 하겠습니다. Preferences 창 화면 왼쪽 상단에 "gradle" 이라고 입력해서 나오는 Gradle을 클릭합니다. Gradle과 Java의 충돌을 방지하기 위해 Java home 항목에 JRE에 설정해둔 Java 버전의 경로를 입력합니다. 그리고 창 하단의 Automatic Project Synchronization 값에 V 체크가 되어있지 않다면 체크를 해줍니다. 그리고 [Apply] 버튼을 눌러 적용 시킵니다. 모든 설정을 마쳤으므로 창 제일 하단에 [Apply and Close] 버튼을 눌러 설정을 완료합니다.

 

 

 

마무리

지금까지 STS 4 설치 및 설정 방법에 대해 알아보았습니다. [File - New] 메뉴로 가셔서 원하는 프로젝트를 생성해서 사용하시면 되겠습니다.