본 페이지에서는 Anyframe Tools 및 관련 어플리케이션의 설치방법에 대한 설명을 제공한다.
여기에서 설명하고 있지 않는 Anyframe Gen 설치 및 Anyframe Monitoring 설치 등에 대한 설명은 각각의 페이지를 참고한다.

설치환경

일반적으로 널리 쓰이는 최근의 운영체제가 원활하게 구동되는 시스템이라면 Eclipse 및 Anyframe Tools를 설치하고 사용하는 데 큰 지장이 없다.
Anyframe Tools팀은 특히 다음의 운영체제들에 대하여 출시전 테스트를 실시하고 있다.

• Apple® Mac OS X®
• Microsft® Windows®

다음의 소프트웨어들은 Anyframe Tools 및 관련 어플리케이션을 설치, 사용하는 데 반드시 필요하다.

• Java Development Kit (JDK)
  Anyframe Tools 및 관련 어플리케이션은 Java 기술에 기반한 Anyframe을 지원하는 도구들이므로, Java Development Kit (JDK) 5.0 또는 그 이상 버전이 필요하다.
• Java Runtime Environment (JRE)
  Eclipse를 실행시키기 위해 JRE가 반드시 필요하며, JDK를 설치하면 일반적으로 JRE도 함께 설치된다.
• Eclipse Europa 또는 그 이후 배포판
  Eclipse를 아직 설치하지 않은 사용자는 아래 "Eclipse 설치" 부분을 참고하여 Eclipse를 설치하도록 한다. 설치 배포판은 "Eclipse IDE for Java EE Developers"을 권장하며, 해당 배포판에 필요한 플러그인을 추가한 패키지를 본 사이트의 Eclipse & 3rd-party Plugins 다운로드 페이지에서 다운로드할 수 있다.
• Anyframe Core 및 Web
  Anyframe을 활용한 개발을 위해서는 Anyframe Core 및 Web을 설치해야 한다.

다음의 소프트웨어들은 Anyframe Tools 및 관련 어플리케이션을 설치, 사용하는 데 반드시 필요하지는 않지만 매우 유용하게 사용할 수 있다.

• Apache Tomcat 또는 상용 서블릿컨테이너/어플리케이션서버
  개발한 어플리케이션을 테스트하고 운영하기 위해서는 서블릿컨테이너 혹은 어플리케이션서버가 필요하다.
• MySQL, HSQLDB 또는 상용 DBMS
  개발한 어플리케이션을 테스트하고 운영하기 위해서는 DBMS가 필요할 수 있다.
• 기타 3rd-party 라이브러리
  그 외에 사용자의 목적에 따라 추가적인 라이브러리가 필요할 수 있다.

Eclipse 설치하기

본 사이트를 통해 제공하는 Eclipse는 Anyframe을 이용한 어플리케이션 개발 시 Eclipse 통합개발환경을 제공 할 수 있도록 패키징되어 있는 Eclipse 버전이다. 만약 Eclipse IDE for Java EE Developers 등의 패키지가 이미 설치되어 있다면 별도로 다운 받아서 설치할 필요는 없다.

• Eclipse 설치방법: Eclipse IDE를 설치할 폴더를 선택 후, 다운로드 받은 eclipse3.x.x_ide.zip파일의 압축을 푼다.
• Eclipse 제거방법: 탐색기에서 Eclipse IDE가 설치된 폴더를 선택한 후 제거한다.

3rd-party Plugins 설치하기

Step 1. 3rd-party Plugins 다운로드

설치한 Eclipse 버전에 맞는 3rd-party Plugins (plugin-pack-eclipse3.x.zip)를 본 사이트의 Eclipse & 3rd-party Plugins 다운로드 페이지에서 다운로드한다.

Step 2. 3rd-party Plugin 추가

다운로드 받은 파일을 Eclipse가 설치된 폴더의 "dropins" 폴더에 압축을 푼다.

• dropins 폴더: 설치하고자 하는 플러그인을 본 폴더 안에 복사하여 설치한다.
• p2 폴더: dropins 폴더에 설치된 플러그인의 정보를 저장하고 있으며, 플러그인 설치가 정상적이지 않을 경우, 본 폴더의 내용을 초기화시키면 대부분 해결된다.
• 보다 자세한 사항은 Eclipse documentation: The dropins folder and supported file layouts을 참고한다.

[중요] 본 사이트의 Eclipse & 3rd-party Plugins 다운로드 페이지의 Eclipse IDE 3.4.x (eclipse3.4.1_ide.zip)와 3rd-party Plugins for Eclipse IDE 3.4.x (plugin-pack-eclipse3.4.zip) 이전 버전을 다운로드한 사용자는 "dropins" 폴더 대신 "addins" 폴더를 이용한 설치를 하여야 하며, 해당 내용은 Anyframe Tools 설치 (addins, links 폴더 활용) 문서를 참고한다.

Step 3. 3rd-party Plugin 제거

사용하지 않는 플러그인이 있을 때 dropins 폴더에서 해당 플러그인을 삭제한다.

Anyframe IDE (Plugins) 설치하기

Step 1. Anyframe IDE (Plugins) 다운로드

설치하고자 하는 Anyframe IDE (Plugins)를 본 사이트의 Anyframe Tools 다운로드 페이지에서 다운로드한다.

Step 2. Anyframe IDE (Plugins) 설치 폴더 생성

Eclipse가 설치된 폴더의 "dropins" 폴더에 "anyframe/eclipse/plugins" 폴더를 만든다.

Step 3. Anyframe IDE (Plugins) 추가

다운로드 받은 파일의 압축을 풀어 나온 파일들을 위에서 만든 폴더에 추가한다. 다음은 각각의 Plugins를 설치하는 방법이다.

Anyframe Common은 Anyframe Tools 중 Anyframe 이름이 붙은 Plugins를 설치, 활용하기 위하여 반드시 필요한 플러그인이다. 이를 설치 하기 위해서는 Anyframe Common 다운로드 페이지에서 anyframe.plugins.common-x.x.x-bin.zip 파일을 다운로드하여 위에서 생성한 폴더에 압축해제 한다.

Anyframe Codegen 다운로드 페이지에서 다운로드한 anyframe.plugins.codegen-x.x.x-bin.zip 파일을 위에서 생성한 폴더에 압축해제 한다.

• anyframe.plugins.codegen.db_x.x.x.jar
• anyframe.plugins.codegen_x.x.x.jar
• anyframe.plugins.codegen.template: wiazrd와 vm파일

Anyframe Query Manager 다운로드 페이지에서 다운로드한 anyframe.plugins.querymanager-x.x.x-bin.zip 파일을 위에서 생성한 폴더에 압축해제 한다.

• Anyframe Query Manager 요구사항
  Anyframe Query Manager 1.3.1 이상 버전의 경우, Anyframe Tools 설치환경에 추가하여 다음과 같은 요구사항을 충족해야 한다.
  • Eclipse IDE for Java EE Developers (Europa/Ganymede/Galileo)
  • Anyframe Common 2.0.1 이상
  • Eclipse SQL Explorer 3.5 RC5
    Anyframe Query Manager 1.3.x 버전에서는 3.5 RC5/RC6 이외의 버전에서 일부 문제점이 보고되었음.
• Ecipse IDE for Java EE Developers 이외의 Package를 사용할 경우
  Eclipse IDE for Java EE Devlopers 패키지는 다른 패키지에 비하여 개발자에게 유용한 다양한 플러그인을 포함하고 있으며, Anyframe을 활용한 개발을 위하여 권장하는 패키지이다. 다만, 필요에 의하여 이외의 Eclipse IDE 패키지에 Anyframe Query Manager를 설치, 사용하고자 한다면 다음의 플러그인 의존관계(Plug-ins Dependencies)를 확인하여, 해당 플러그인을 설치한 후 Anyframe Query Manager를 설치, 사용한다.
  • org.eclipse.ui
  • org.eclipse.core.runtime
  • org.eclipse.core.resources
  • org.eclipse.ui.views
  • org.eclipse.ui.ide
  • org.eclipse.ui.editors
  • org.eclipse.ui.workbench.texteditor
  • org.eclipse.jface.text
  • org.eclipse.jdt.ui
  • org.eclipse.jdt.core
  • org.eclipse.wst.xml.ui
  • org.eclipse.wst.xml.core
  • org.eclipse.wst.sse.core
  • org.eclipse.wst.sse.ui
  • org.eclipse.search
  • net.sourceforge.sqlexplorer
  • org.eclipse.core.filesystem
  • anyframe.plugins.common

Anyframe Help는 기존의 개별 플러그인들에 포함되어 있던 Eclipse Help Contents를 하나의 통합 플러그인으로 구성한 것이다. 이는 일반적인 Eclipse Plugins 패키지 구성 스타일을 따르는 것으로 다음과 같은 장점이 있다.

• 개별 플러그인들이 필수 기능만을 포함하고 있어서 경량화됨
• 사용자가 원하는 플러그인만 선택적으로 설치할 경우, Anyframe Common에 대한 의존성으로 인해 모든 도움말이 사용불가한 점이 개선됨

본 플러그인을 설치하기 위해서는 Anyframe Help 다운로드 페이지에서 다운로드한 anyframe.plugins.help-x.x.x-bin.zip 파일을 위에서 생성한 폴더에 압축해제 한다.

Anyframe Config Editor, Anyframe DBIO 등 향후 추가 개발 계획이 없는 플러그인들의 설치관련 내용은 Anyframe Tools 설치 (addins, links 폴더 활용) 문서의 Anyframe Plugins 설치부분을 참고한다.

Step 4. Anyframe IDE (Plugins) 설치 확인

Anyframe Plugins가 모두 설치 되었으면 Eclipse를 실행 해 설치가 정상적으로 되었는지 확인한다.

• Windows 용 Eclipse: (Eclipse 실행 후 메뉴바에서) Help > About Eclipse SDK > Plug-in Details
• Mac OS X 용 Eclipse: (Eclipse 실행 후 메뉴바에서) Eclipse > About Eclipse Platform > Plug-in Details

Anyframe Plugins가 모두 정상적으로 설치 되었다면 위와 같이 Plug-in 목록에 나타날 것이다.