를 사용하여 언어 버전 업그레이드 Amazon Q Developer Agent for code transformation - Amazon Q 개발자

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용하여 언어 버전 업그레이드 Amazon Q Developer Agent for code transformation

파일의 코드 언어 버전을 바로 업그레이드할 Amazon Q Developer Agent for code transformation 수 있습니다. 모듈을 에서 JetBrains 변환하고 프로젝트 또는 전체 작업 공간을 에서 변환할 수 Visual Studio Code 있습니다.

Amazon Q는 먼저 소스 언어 버전으로 코드를 빌드하고 코드를 변환하는 데 필요한 정보가 들어 있는지 확인합니다. Amazon Q에서 코드를 성공적으로 변환한 후에는 통합 개발 환경 (IDE) 에서 변경 사항을 확인하고 수락합니다. 자세한 정보는 Amazon Q Developer Agent for code transformation 작동 방식을 참조하세요.

현재 Amazon Q는 Java 8 및 Java 11 코드를 Java 17 코드로 업그레이드할 수 있습니다.

1단계: 사전 조건

계속하기 전에 IDE에서 Amazon Q 설정의 단계를 완료했는지 확인하십시오.

코드 변환 작업을 시작하기 전에 다음 사전 요구 사항을 충족하는지 확인하십시오.

  • 프로젝트는 Java 8 또는 Java 11 프로젝트를 기반으로 합니다. Maven

  • MavenIDE에서 를 사용하여 프로젝트를 성공적으로 빌드할 수 있습니다. Amazon Q Developer Agent for code transformationMaven2.8을 지원하지만 Maven 3.9.5 이상을 사용하는 것이 좋습니다.

  • 프로젝트 소스 JDK는 로컬에서 사용할 수 있으며 소스 코드의 버전입니다. 예를 들어 자바 8 코드를 변환하는 경우 로컬 JDK 설치는 JDK 8이어야 합니다.

  • 프로젝트는 55분 이내에 빌드됩니다.

  • 프로젝트가 올바르게 구성되었으며 올바른 JDK 버전이 지정되었습니다. 자세한 정보는 2단계: 프로젝트 구성을 참조하세요.

  • 프로젝트에는 가상 사설 클라우드 (VPC) 또는 온프레미스 네트워크를 비롯한 사설 네트워크의 리소스에 액세스할 필요가 없습니다. 예를 들어 프로젝트에 네트워크의 데이터베이스에 연결하는 단위 테스트가 포함된 경우 변환이 실패합니다.

  • 프로젝트는 Java 프로젝트에서 Java 이외의 언어를 패키징하는 플러그인을 사용하지 않습니다. 예를 들어 프로젝트에서 Java 소스 코드 외에 프론트엔드 JavaScript 코드 실행에 를 사용하는 경우 변환이 실패합니다. frontend-maven-plugin

  • 프로젝트는 pom.xml 파일 종속성 버전 범위를 사용하지 않습니다. 예를 들어 pom.xml 파일에 이 포함되어 <version>[1.0.0,)</version> 있는 경우 변환이 실패합니다. 자세한 내용은 Apache Maven 프로젝트 설명서의 버전 범위 사양을 참조하십시오.

  • 로컬 네트워크에서는 Amazon Q가 코드를 변환하는 데 사용하는 Amazon S3 버킷에 업로드할 수 있습니다. 자세한 내용은 데이터 경계에서 Amazon S3 버킷에 대한 액세스 허용을 참조하십시오.

2단계: 프로젝트 구성

프로젝트를 구성하려면 사용 중인 IDE에 대한 다음 정보를 사용하세요.

에서 프로젝트를 구성하십시오. JetBrains

에서 JetBrains 프로젝트를 구성하려면 프로젝트 구조 설정에서 프로젝트의 JDK 버전을 지정하십시오. 자세한 내용은 IntelliJ IDEA 설명서에서 프로젝트의 JDK 버전 변경을 참조하고 Maven 프로젝트 구조의 JDK 버전 변경 지침을 따르십시오.

에서 프로젝트를 구성하십시오. VS Code

에서 프로젝트를 VS Code 구성하려면 프로젝트에 다음이 포함되어야 합니다.

  • 프로젝트 루트 폴더에 있는 pom.xml 파일

  • 프로젝트 디렉터리에 있는 .java 파일

프로젝트에 Maven 래퍼 실행 파일 (mvnwfor macOS 또는 mvnw.cmd forWindows) 이 포함되어 있다면 해당 파일이 프로젝트의 루트에 있는지 확인하세요. Amazon Q는 래퍼를 사용하므로 다른 Maven 구성은 필요하지 않습니다.

Maven래퍼를 사용하지 않는 경우 설치하십시오. Maven 자세한 내용은 Apache Maven Apache Maven 설명서의 설치를 참조하십시오.

설치 Maven 후 PATH 변수에 추가합니다. 자세한 내용은 Java runtime 변수도 JRE가 아닌 JDK를 가리켜야 함을 참조하십시오내 PATH 제품에 Maven을 추가하려면 어떻게 해야 합니까?. 구성이 올바른지 확인하려면 를 실행하십시오. mvn -v 출력에는 사용 Maven 중인 버전과 JDK 경로를 가리키는 runtime 변수가 표시되어야 합니다.

3단계: 코드 변환

코드를 변환하기 전에 샘플 프로젝트를 변환하여 IDE가 제대로 설정되었는지 테스트해 보는 것이 좋습니다. 다음은 코드 변환에 적합한 샘플 GitHub 프로젝트입니다. https://github.com/aws-samples/ qct-sample-java -8-app.

IDE 설정을 테스트하려면 샘플 프로젝트를 다운로드하여 압축을 풀고 해당 IDE에 맞는 다음 단계를 완료하십시오. 제안된 변경 내용 및 변환 요약을 볼 수 있으면 코드 프로젝트를 직접 변환할 준비가 된 것입니다. 변환이 실패하면 IDE가 제대로 구성되지 않은 것입니다. 구성 문제를 해결하려면 2단계: 프로젝트 구성 및 을 문제 해결 검토하십시오.

참고

변환이 시작되기 전에 IDE에서 다른 곳으로 이동하면 변환이 실패하고 다시 시작해야 합니다.

코드 프로젝트 또는 모듈의 언어 버전을 업그레이드하려면 해당 IDE에 맞는 다음 단계를 완료하세요.

JetBrains
  1. 업그레이드하려는 모듈을 엽니다JetBrains. IDE에서 프로젝트를 성공적으로 빌드했는지 확인하세요.

  2. Amazon Q 로고를 선택한 다음 열리는 Amazon Q 채팅 /transform 패널에 입력합니다.

  3. 애플리케이션 변환 팝업이 나타납니다. 드롭다운 메뉴에서 업그레이드하려는 프로젝트를 선택한 다음 Transform을 선택합니다.

  4. Amazon Q가 혁신을 시작합니다. 변환 세부 정보 탭에서 진행 상황을 볼 수 있습니다.

  5. 변환이 완료되면 프로젝트를 업데이트하기 전에 업그레이드된 코드를 확인할 수 있습니다. 새 코드를 보려면 변환 세부 정보 탭으로 이동한 다음 View diff 를 선택합니다. 나타나는 패치 적용 창에서 파일을 선택하여 소스 코드와 업그레이드된 코드가 포함된 diff 보기를 엽니다.

  6. Amazon Q에서 변경한 내용을 적용하려면 View diff 를 선택하여 패치 적용 창을 엽니다. 업데이트된 파일을 모두 선택하고 [확인] 을 선택하여 프로젝트를 제자리에서 업데이트합니다.

  7. 코드 업그레이드 방법에 대한 세부 정보와 제안된 다음 단계를 보려면 변환 세부 정보 탭에서 변환 요약 보기를 선택합니다.

Visual Studio Code
  1. 업그레이드하려는 프로젝트 또는 작업 영역을 엽니다VS Code. IDE에서 프로젝트를 성공적으로 빌드했는지 확인하세요.

  2. Amazon Q 로고를 선택한 다음 열리는 Amazon Q 채팅 /transform 패널에 입력합니다.

  3. IDE 상단의 검색 창에서 업그레이드하려는 프로젝트를 선택합니다.

  4. Amazon Q에서 소스 코드의 버전을 찾을 수 없는 경우 코드 버전을 선택하라는 메시지가 표시됩니다. 소스 코드가 작성된 버전을 선택한 다음 팝업에서 Transform을 선택하여 계속 진행하십시오.

  5. 메시지가 표시되면 JDK의 JAVA_HOME 경로를 입력합니다. 자세한 내용은 프로젝트 구성을 VS Code 참조하십시오.

  6. Amazon Q가 혁신을 시작합니다. 변환 허브 탭에서 진행 상황을 볼 수 있습니다.

  7. 변환이 완료되면 제안된 변경 사항 탭이 열립니다. 프로젝트를 업데이트하기 전에 업그레이드된 코드를 확인하려면 제안된 변경 사항 다운로드를 선택합니다. 파일을 선택하면 소스 코드와 업그레이드된 코드가 포함된 diff 뷰가 열립니다.

  8. Amazon Q에서 변경한 내용을 수락하려면 제안된 변경 사항 탭으로 이동하여 수락을 선택합니다.

  9. 코드가 어떻게 업그레이드되었는지 자세히 알아보고 다음 단계를 제안하려면 Transformation Hub에서 보기 및 기타 작업 줄임표 버튼을 선택한 다음 [변환 요약 표시] 를 선택합니다.