애플리케이션의 Java 버전 업그레이드하기

Java™ 코드를 업그레이드하려면 먼저 애플리케이션을 빌드하고 분석한 다음 확인된 문제를 수정합니다. 문제에 따라 문제를 해결하는 기능은 자동화되거나 직접 수행할 수 있습니다.

1.1 버전부터는 Maven 없이도 애플리케이션을 빌드할 수 있지만 제한이 있습니다. 자세한 내용은 Maven 이외의 빌드 도구로 빌드된 애플리케이션을 참조하세요.

시작하기 전에

  1. 엔터프라이즈 Java 환경을 설정하십시오.
  2. ,, 또는 를 설치하십시오 Visual Studio Code 확장Eclipse IDE 플러그인IntelliJ IDE 플러그인.

    Visual Studio Code 확장 프로그램, Eclipse IDE 플러그인 또는 IntelliJ IDE 플러그인을 설치하는 경우 라이선스 키를 적용해야 합니다. 라이선스 키가 적용되지 않은 경우 업그레이드 페이지에 오류가 표시되고 빌드 및 분석 버튼이 비활성화됩니다.

중요: Eclipse IDE 에서 멀티모듈 Java 애플리케이션으로 최상의 결과를 얻으려면 애그리게이터 모듈과 각 하위 모듈을 작업 공간 내에서 별도의 프로젝트로 가져와야 합니다. 최상위 디렉터리를 단일 프로젝트로 가져오면 IBM Application Modernization Accelerator Developer Tools 프로젝트가 성공적으로 인트로스펙트되지 않을 수 있습니다.

사용 Application Modernization Accelerator Developer Tools중 문제가 발생하면 문제 해결 페이지를 참조하십시오.

코드 분석에 필요한 시간

애플리케이션을 분석하는 데 걸리는 시간은 다양합니다. 다음은 일반적인 시간입니다.

표 1. 분석에 필요한 시간

표 1. 코드 분석에 소요되는 시간

첫 번째 열에는 코드 분석 시간이 나열됩니다. 두 번째 열에는 해당 시간 동안의 코드 크기가 표시됩니다.

시간 애플리케이션 세부사항
몇 초에서 몇 분 100개 미만의 클래스
2~10분 20,000~50,000줄의 코드
10분 이상 300,000줄의 코드
중요: IBM Application Modernization Accelerator Developer Tools 에서 애플리케이션을 분석할 때 기본적으로 일부 타사 패키지는 코드 분석에서 제외됩니다. 자세한 내용은 애플리케이션 분석에서 제외되는 타사 패키지를 참조하십시오.

애플리케이션을 분석하여 Java 버전 업그레이드하기

분석을 통해 해결해야 할 문제 목록을 확인할 수 있습니다. 문제를 해결하면 애플리케이션의 Java 버전이 업그레이드됩니다.

코드의 변경 사항을 되돌리려면 분석으로 돌아가기를 클릭하고 Java 업그레이드를 다시 수행하려면 전체 분석을 수행해야 합니다.

  1. IDE에서 업그레이드하려는 애플리케이션 디렉터리의 계층 구조에서 아무 항목이나 마우스 오른쪽 버튼으로 클릭하고 Java 애플리케이션 현대화를 클릭한 다음 Java 버전 업그레이드를 클릭합니다.
  2. <애플리케이션 이름> 업그레이드 페이지에서 애플리케이션을 분석할 규칙을 정의하는 분석 매개변수를 선택합니다.

    1. 권장 값으로 자동 표시되는 Java 소스를 변경합니다.

      Java 소스 버전은 업그레이드하려는 Java 버전입니다. 빌드 구성에서 감지된 Java 버전을 기반으로 IBM Application Modernization Accelerator Developer Tools 에서 소스로 사용할 Java 버전을 권장합니다. 애플리케이션에 적합한 경우 지원되는 Java 버전 목록에서 다른 Java 버전을 선택할 수 있습니다. 빌드 구성은 Maven pom.xml 파일에 있습니다.

      권장되는 Java 버전은 빌드 구성에서 감지되는 버전입니다. 또는 Java 버전이 감지되었으므로 사용 가능한 Java 버전이 가장 좋습니다. 예를 들어, 지원되지 않는 Java 9가 빌드 구성에 지정되어 있는 경우 Java 8이 권장되는 Java 버전입니다. Java 8은 분석에 가장 근접하게 지원되는 Java 버전이며, 탐지된 Java 버전보다 이전 버전이므로 권장됩니다.

      중요: 최소 지원되는 Java 버전은 Java 6입니다.
    2. Java 대상을 선택합니다.

      Java 대상 버전은 Java 애플리케이션을 업그레이드하는 Java 버전입니다. 선택할 수 있는 대상 버전은 장기(LTS) 릴리스( Java )입니다.

    3. 애플리케이션을 빌드한 다음 분석합니다.

      애플리케이션 분석은 애플리케이션 바이너리에서 수행됩니다. 분석을 시작하기 전에 애플리케이션을 빌드해야 합니다.

      • Maven 빌드의 경우 애플리케이션을 수동 또는 자동으로 빌드할 수 있습니다.

        애플리케이션을 수동으로 빌드한 후 분석을 클릭하거나 애플리케이션을 자동으로 빌드하고 분석하려면 빌드 및 분석을 클릭합니다.

        애플리케이션이 빌드되고 분석되면 수정하거나 검토해야 할 문제가 표시됩니다. 해결해야 할 문제에 따라 자동화 또는 셀프 디렉팅으로 문제를 해결할 수 있습니다. 검토해야 할 이슈는 코드 마이그레이션을 위해 코드를 변경할 필요가 없습니다. 그러나 확인 또는 테스트가 필요할 수 있습니다.

        빌드 및 분석을 클릭하면 애플리케이션이 현재 Java 소스 버전으로 빌드되므로 Java 업그레이드 문제를 분석할 수 있습니다. Java 소스 버전의 Java 개발자 키트로 IDE를 구성해야 IDE에서 애플리케이션을 성공적으로 빌드할 수 있습니다.

        팁: 빌드 및 분석할 때 liberty-assembly 패키징이 포함된 하위 모듈이 포함된 멀티모듈 프로젝트에 문제가 있는 경우 프로젝트의 루트 수준에서 mvn install 을 실행하고 다시 시도하세요.
      • Maven이 아닌 빌드의 경우 애플리케이션을 수동으로 빌드한 다음 분석을 클릭합니다.

        애플리케이션이 빌드되고 분석되면 수정하거나 검토해야 할 문제가 표시됩니다. 해결해야 할 문제는 스스로 해결해야 합니다. 검토해야 할 이슈는 코드 마이그레이션을 위해 코드를 변경할 필요가 없습니다. 그러나 확인 또는 테스트가 필요할 수 있습니다.

문제 해결 및 애플리케이션에 대한 추가 정보 검토

<애플리케이션 이름> 업그레이드 페이지에 다음 정보가 나열됩니다:

  • Java 버전 소스 및 Java 버전 대상
  • 기술 보고서, 인벤토리 보고서 및 분석 보고서로 연결되는 링크
  • 자동 또는 직접 수정할 수 있는 수정할 문제와 추가 정보를 확인할 수 있는 탭입니다

자동화된 수정을 실행할 때와 Java 버전 타깃이 변경된 후 애플리케이션을 빌드할 때 Java 개발자 키트가 필요합니다. 대상 Java 개발자 키트가 IDE에 맞게 구성되어 있는지 확인합니다.

  • Eclipse IDEIntelliJ IDE용 플러그인은 Java 버전 대상과 일치하는 올바른 Java 개발자 키트를 자동으로 찾으려고 시도합니다. Java 버전 대상은 IDE에 구성된 모든 Java 개발자 키트 집합에서 가져옵니다.
  • Visual Studio Code IDE에서 Java 개발자 키트 구성을 수동으로 변경해야 합니다.
Maven 빌드에 대한 자동화된 수정 완료하기

하나 이상의 수정 사항이 있는 자동화된 수정 사항 탭이 있는 경우 해당 탭을 선택합니다.

IBM Application Modernization Accelerator Developer Tools 에서 수정이 완료되므로 코드를 변경할 필요가 없습니다.

  1. 지침을 펼쳐서 읽어보세요.
  2. 선택 사항으로 이슈를 열어 이슈에 대한 설명을 검토합니다.
  3. 자동 수정 실행을 클릭합니다.
    • 자동 수정이 수정되었습니다.
    • 외부 이슈는 관련 종속성을 업데이트할 때까지 목록에 남아 있습니다.
  4. 자동 수정 실행이 완료되면 다시 빌드 및 새로 고침을 클릭하여 문제 목록을 업데이트합니다.
중요:
  • 자동 수정이 실행되지 않고 콘솔 출력에 컴파일 오류가 발생하면 maven-compiler 플러그인 버전을 3.13.0 이상으로 업데이트하세요.
  • 자동화를 실행할 때 liberty-assembly 패키징이 있는 하위 모듈이 포함된 멀티모듈 프로젝트에 문제가 있는 경우 프로젝트의 루트 수준에서 mvn install 을 실행한 후 다시 시도하세요.
자기 주도적 수정 완료

하나 이상의 수정 사항이 있는 자기 주도적 수정 탭이 있는 경우 해당 탭을 선택합니다.

코드를 변경하고 코드를 수정하는 방법을 결정합니다.

  1. 지침을 펼치고 지침을 따릅니다.
  2. 각 이슈를 펼칩니다.
  3. 자세히 보기를 클릭하여 문제를 확장합니다.
  4. 이슈에 나열된 파일을 클릭합니다. 파일이 편집기에서 열립니다.
  5. 문제를 해결하면서 모든 자체 수정 사항이 수정될 때까지 다시 빌드하고 새로 고침을 클릭합니다.
팁: 특정 자가 해결 방법의 경우, 생성형 AI 기능을 watsonx Code Assistant™ for Enterprise Java Applications 활용할 수 있습니다.
추가 정보 주소 지정

추가 정보 탭에 숫자가 하나 이상 있는 경우 해당 탭을 선택합니다.

탭에 나열되는 이슈는 다른 탭의 이슈가 결정되는 것과 같은 방식으로 결정됩니다. 추가 정보 문제로 인해 코드를 변경할 필요는 없지만 문제를 검토하여 코드를 마이그레이션할 때 애플리케이션이 작동하는지 확인할 수 있습니다.

추가 정보는 API의 사소한 동작 변경과 같은 문제와 이에 대한 조치 방법을 나타낼 수 있습니다.

  • 지침을 펼쳐서 따르세요.

  • 각 문제를 클릭합니다.

    • 자세히 보기를 클릭하여 문제를 확장합니다.
    • 이슈에 나열된 파일에 있는 링크를 클릭하여 코드를 검토합니다.
현재 애플리케이션 외부에서 외부 문제 해결

수정 작업을 하는 동안 일부는 현재 애플리케이션 외부에서 발생한 외부 문제로 분류될 수 있습니다. 이러한 문제에 대한 소스 코드는 현재 소스 애플리케이션의 일부가 아닌 지정된 아카이브에 있습니다.

아카이브가 조직에서 소유하고 있는 라이브러리인 경우.

  1. 관련 소스 코드를 별도의 애플리케이션으로 열고 IBM Application Modernization Accelerator Developer Tools 을 사용하여 문제를 해결할 수 있습니다.

  2. 그런 다음 현재 애플리케이션을 업데이트하여 수정된 새 버전을 사용할 수 있습니다.

아카이브가 조직에서 소유하지 않은 라이브러리인 경우.

  • 이 문제가 포함되지 않은 버전으로 업데이트해야 합니다. 해당 버전이 없는 경우 다른 기술을 사용해야 할 수도 있습니다.