VS Code에서 Java 프로젝트 관리

Java용 프로젝트 관리자 확장은 Java 프로젝트 및 해당 종속성을 관리하는 데 도움이 됩니다. 또한 새 Java 프로젝트, 패키지 및 클래스를 만드는 데도 도움이 됩니다. Visual Studio Code에서 완벽한 Java 언어 지원을 받으려면 Java용 프로젝트 관리자 확장을 포함하는 Java용 확장 팩을 설치할 수 있습니다.

Extension Pack for Java 설치

확장 팩 시작 방법에 대한 자세한 내용은 Java 시작하기 튜토리얼을 참조하십시오.

프로젝트 보기

Java 프로젝트 보기는 Java 프로젝트와 해당 종속성을 보고 프로젝트 관리 작업에 대한 진입점을 제공합니다.

기본적으로 Java 프로젝트 보기는 탐색기 보기 아래에 표시됩니다. 보이지 않으면 **탐색기** 제목 표시줄의 ... 버튼을 클릭하고 Java 프로젝트를 선택하십시오.

탐색 모음의 오버플로 버튼에는 더 많은 사용 가능한 옵션이 있습니다. 예를 들어 계층적 보기와 플랫 보기 간에 전환할 수 있습니다.

탐색기에서 노드 옆에 있는 버튼에서 일부 작업에 대한 유용한 바로 가기를 찾을 수 있습니다.

각 노드의 컨텍스트 메뉴에도 유용한 기능이 많이 있습니다. 노드를 마우스 오른쪽 버튼으로 클릭하여 토글할 수 있습니다.

새 Java 프로젝트 만들기

탐색 모음의 + 버튼을 클릭하거나 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 **Java: 새 Java 프로젝트 만들기...** 명령을 통해 새 Java 프로젝트를 만들 수 있습니다. 만드는 동안 VS Code는 프로젝트 유형에 필요한 확장이 아직 설치되지 않은 경우 설치를 지원합니다.

Java 프로젝트 가져오기

파일 > 폴더 열기...를 통해 기존 Java 프로젝트 및 모듈을 작업 영역으로 직접 가져올 수 있습니다(열린 폴더에 빌드 도구 스크립트, 예를 들어 pom.xml 또는 build.gradle이 포함되어 있는지 확인). Java용 VS Code는 프로젝트를 감지하고 자동으로 가져옵니다.

프로젝트에 새 모듈을 추가할 때 **Java: 작업 영역에 Java 프로젝트 가져오기** 명령을 실행하여 작업 영역으로 가져올 수 있습니다. 이 명령은 VS Code 창을 다시 로드할 필요 없이 새 프로젝트를 작업 영역으로 가져오는 데 도움이 됩니다.

JAR로 내보내기

프로젝트 보기에서 또는 **Java: JAR 내보내기...** 명령을 실행하여 빌드를 JAR로 내보낼 수 있습니다.

프로젝트 런타임 구성

Java가 발전함에 따라 개발자가 여러 버전의 JDK를 사용하는 것은 일반적입니다. 설정: java.configuration.runtimes를 통해 로컬 설치 경로에 매핑할 수 있습니다. 설정은 다음 형식을 따릅니다.

"java.configuration.runtimes": [
  {
    "name": "JavaSE-1.8",
    "path": "/usr/local/jdk1.8.0_201"
  },
  {
    "name": "JavaSE-11",
    "path": "/usr/local/jdk-11.0.3",
    "sources" : "/usr/local/jdk-11.0.3/lib/src.zip",
    "javadoc" : "https://docs.oracle.com/en/java/javase/11/docs/api",
    "default":  true
   },
   {
    "name": "JavaSE-12",
    "path": "/usr/local/jdk-12.0.2"
   },
   {
    "name": "JavaSE-13",
    "path": "/usr/local/jdk-13"
   }
]

참고: 항목에 "default": true를 추가하여 기본값으로 설정할 수 있습니다. 기본 JDK는 관리되지 않는 폴더(빌드 도구 없음)에 사용됩니다.

프로젝트에 사용되는 JDK를 보려면 **명령 팔레트**(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 **Java: Java 런타임 구성** 명령을 트리거할 수 있습니다. 이 명령은 프로젝트의 런타임 정보를 표시하는 보기를 엽니다.

Maven 및 Gradle 프로젝트의 JDK 변경

Maven 또는 Gradle 프로젝트의 JDK 버전을 변경하려면 빌드 스크립트(pom.xml 또는 build.gradle)에서 업데이트해야 합니다. 를 클릭하여 변경 방법을 확인하고, 를 클릭하면 프로젝트의 빌드 스크립트 파일로 이동합니다.

관리되지 않는 폴더의 JDK 변경

관리되지 않는 폴더(빌드 도구 없음)의 JDK를 변경하려면 버튼을 클릭하십시오. 그러면 모든 JDK가 나열되고 관리되지 않는 폴더에 사용할 JDK를 선택할 수 있습니다.

JDK 다운로드

새 JDK를 다운로드하려면 download 링크를 클릭하거나 **명령 팔레트**(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 **Java: 새 JDK 설치** 명령을 트리거하십시오. 그러면 JDK를 다운로드하는 새로운 보기가 열립니다.

참고: Java 미리 보기 기능을 사용하려면 새 Java 버전으로 VS Code를 사용하는 방법을 참조하십시오.

관리되지 않는 폴더의 클래스패스 구성

Java용 프로젝트 관리 확장은 관리되지 않는 폴더에 대한 클래스패스를 구성하기 위한 사용자 인터페이스를 제공합니다. 클래스패스는 클래스패스 구성 페이지에서 수동으로 설정할 수 있습니다. 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 **Java: 클래스패스 구성** 명령을 실행하여 열 수 있습니다.

드문 경우에 언어 서버가 종속성을 다시 빌드하도록 하려면 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 **Java: Java 언어 서버 작업 영역 정리** 명령을 실행하여 Java 작업 영역을 정리해야 할 수 있습니다.

종속성 관리

Maven 종속성 추가

Maven 프로젝트의 경우 프로젝트 보기의 **Maven 종속성** 노드 옆에 있는 + 아이콘을 클릭하여 종속성을 추가할 수 있습니다.

관리되지 않는 폴더의 종속성 관리

프로젝트가 빌드 도구가 없는 관리되지 않는 폴더인 경우 **참조된 라이브러리** 노드 또는 그 아래 항목 옆에 있는 + 아이콘 또는 - 아이콘을 클릭하여 종속성을 관리하거나 JAR 라이브러리를 참조된 라이브러리 노드로 직접 끌어다 놓을 수 있습니다.

클래스패스 구성 페이지에서도 종속성을 관리할 수 있습니다. 관리되지 않는 폴더의 클래스패스 구성 참조

백그라운드에서는 settings.json에 java.project.referencedLibraries 설정이 있습니다. 이 설정을 사용자 지정하는 방법에 대한 자세한 내용은 다음과 같습니다.

라이브러리 포함

참조할 라이브러리는 glob 패턴 집합을 사용하여 설명됩니다.

예를 들어,

"java.project.referencedLibraries": [
    "library/**/*.jar",
    "/home/username/lib/foo.jar"
]

위 설정은 작업 영역의 라이브러리 폴더에 있는 모든 .jar 파일을 지정된 절대 경로의 foo.jar와 함께 프로젝트의 외부 종속성에 추가합니다.

참조된 라이브러리는 VS Code에서 모니터링되며, 이러한 종속 파일에 변경 사항이 있으면 프로젝트가 새로 고쳐집니다.

기본적으로 VS Code는 glob 패턴 lib/**/*.jar을 사용하여 작업 영역의 lib 디렉터리에 있는 모든 JAR 파일을 참조합니다.

일부 라이브러리 제외

프로젝트에서 일부 라이브러리를 제외하려면 java.project.referencedLibraries를 확장하여 include/exclude 필드를 사용하고 exclude glob 패턴을 추가할 수 있습니다.

"java.project.referencedLibraries": {
    "include": [
        "library/**/*.jar",
        "/home/username/lib/foo.jar"
    ],
    "exclude": [
        "library/sources/**"
    ]
}

위 예에서는 library/sources 폴더에 있는 모든 바이너리 JAR 파일이 프로젝트의 외부 종속성으로 무시됩니다.

소스 JAR 첨부

기본적으로 참조된 {binary}.jar은 동일한 디렉터리에서 {binary}-sources.jar을 검색하고 일치하는 항목이 발견되면 소스로 첨부하려고 시도합니다.

수동으로 JAR 파일을 소스 첨부로 지정하려면 sources 필드에서 키-값 맵을 제공할 수 있습니다.

"java.project.referencedLibraries": {
    "include": [
        "library/**/*.jar",
        "/home/username/lib/foo.jar"
    ],
    "exclude": [
        "library/sources/**"
    ],
    "sources": {
        "library/bar.jar": "library/sources/bar-src.jar"
    }
}

이 방법을 사용하면 bar-src.jar이 bar.jar에 소스로 첨부됩니다.

경량 모드

Java용 VS Code는 경량 모드와 표준 모드의 두 가지 모드를 지원합니다. 경량 모드에서는 소스 파일과 JDK만 언어 서버에서 확인합니다. 표준 모드에서는 가져온 종속성이 확인되고 프로젝트가 언어 서버에서 빌드됩니다. 경량 모드는 소스 코드 읽기, 소스 코드 및 JDK 간 탐색, 개요 및 Javadoc 보기, 구문 오류 감지 및 수정과 같이 소스 파일로 빠르게 시작하고 가벼운 환경이 필요한 경우 가장 적합합니다. 또한 코드 완성은 소스 파일 및 JDK 범위 내에서 지원됩니다.

경량 모드는 가져온 종속성을 확인하거나 프로젝트를 빌드하지 않으므로 실행, 디버깅, 리팩터링, 린팅 또는 의미 오류 감지를 지원하지 않습니다. 이러한 기능을 사용하려면 작업 영역을 경량 모드에서 표준 모드로 전환해야 합니다.

java.server.launchMode 설정을 다음 옵션으로 구성하여 어떤 모드로 시작할지 제어할 수 있습니다.

• Hybrid(기본값) - 먼저 경량 모드로 작업 영역을 엽니다. 작업 영역에 확인되지 않은 Java 프로젝트가 포함된 경우 표준 모드로 전환할지 묻는 메시지가 표시됩니다. **나중에**를 선택하면 경량 모드로 유지됩니다. 상태 표시줄의 언어 상태 항목을 클릭하여 수동으로 표준 모드로 전환할 수 있습니다.
• Standard - 표준 모드로 작업 영역을 엽니다.
• LightWeight - 경량 모드로 작업 영역을 엽니다. 상태 표시줄의 언어 상태 항목을 클릭하여 수동으로 표준 모드로 전환할 수 있습니다.

언어 상태 항목은 다른 아이콘을 사용하여 현재 작업 영역이 어떤 모드인지 나타냅니다.

언어 상태 항목을 클릭하면 표준 모드로 전환됩니다.

빌드 상태

Visual Studio Code에서 Java 소스 코드를 편집할 때 Java 언어 서버가 작업 영역을 빌드하여 필요한 언어 기능을 제공합니다. 상태 표시줄의 언어 상태 항목을 클릭하면 자세한 빌드 작업 상태를 확인하고 백그라운드에서 진행되는 작업을 볼 수 있습니다. 언어 서버가 Java 프로젝트를 열고 있다는 알림이 표시될 때 세부 정보 확인 링크를 선택하여 빌드 작업 상태를 확인할 수도 있습니다.

추가 자료

Java에 대한 다양한 빌드 시스템을 지원하는 몇 가지 Visual Studio Code 확장이 있습니다. 인기 있는 몇 가지 빌드 시스템에 대한 확장은 다음과 같습니다.

• Java용 Maven
• Java용 Gradle
• Java용 Bazel (Bazel은 Java 통합 없이 BUILD 파일용입니다.)

위 기능을 사용하는 데 문제가 발생하면 이슈를 제출하여 문의하십시오.

다음 단계

자세한 내용은 계속 읽어보세요.

• Java 편집 - VS Code에서 Java 편집 기능을 살펴보세요.
• Java 디버깅 - VS Code에서 Java 프로젝트를 디버깅하는 방법을 알아보세요.
• Java 테스트 - JUnit 및 TestNG 사례에 VS Code를 사용하세요.
• Java 확장 프로그램 - VS Code에 유용한 추가 Java 확장 프로그램에 대해 알아봅니다.