본 페이지는 Anyframe Tools 최신 버전(1.0.0)의 설치 방법에 대해 설명되어 있다. Eclipse IDE, 3rd-party Pluins, Anyframe Plugins의 설치, 제거 방법을 설명한다.

설치환경

Anyframe Tools의 설치 환경과 같으며 내용은 아래와 같다.

• JDK 1.4.2 이상(JDK 1.5.2이상 권장)

3rd-party Plugins, Anyframe Plugins만 설치할 경우 Eclipse 3.2.2또는 Eclipse 3.1.1이 설치 되어 있어야 한다. 설치 방법은 Eclipse IDE 3.2.2와 3.3.1 모두 동일하다.

본 페이지를 통해 제공되는 Anyframe Plugins는 Anyframe Core 3.0.0, Anyframe Web 3.0.0 기반의 개발을 지원한다.

Eclipse IDE 설치

Eclipse IDE는 Anyframe이용해 웹 어플리케이션 개발 시 Eclipse 통합개발환경을 제공 할 수 있도록 패키징되어 있는 Eclipse 버전이다. 만약 Eclipse WTP버전이 이미 설치되어 있다면 Eclipse IDE를 별도로 다운 받아서 설치할 필요는 없다.

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

3rd-party Plugins 설치

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

Eclipse IDE버전에 맞은 3rd-party Plugins(plugin-pack-eclipse3.x.zip)를 다운로드 받은 뒤, Eclipse IDE가 설치된 폴더에 압축을 푼다. plugin-pack-eclipse3.x.zip 파일은 아래와 같이 구성되어있다.

[eclipse3.x_ide] << 이 곳에 plugin-pack-eclipse3.x.zip의 압축을 푼다.
    |
    |---addins : 3rd-party Plugin들을 포함
     |---links :  Elipse에서 Plugin을 인식하기 위한 link파일 포함

• addins폴더 : addins에는 Spring IDE, SQLExplorer등의 3rd-party Plugins들이 포함되어있다. 각 Plugin들을 추가하거나 삭제하기 쉽게 폴더별로 나눠서 구성되어 있다.
  
• links폴더 : links폴더에는 Eclipse에서 플러그인을 인식하기 위해서 필요한 link파일이 포함 되어있다.
• link파일 : Eclipse가 시작 할 때 links폴더에 있는 *.link파일을 읽어서 plug-in을 동작한다.

Step 2. 3rd-party Plugin 추가

adins폴더아래 sqlexplorer이란 plug-in을 실행하고 싶으면 links폴더에 sqlexplorer.link이란 파일을 만들고 "path=addins/sqlexplorer" 처럼 plug-in이 설치된 폴더명을 입력한다. plugin-pack-eclipse3.x.zip에는 설치된 plug-in의 link 파일이 포함되어 있으므로 별로도 작업이 불필요하다.

Step 3. 3rd-party Plugin 제거

사용하지 않는 플러그인이 있을 때 addins에게 플러그인 폴더를 삭제를 해도 되지만 해당플러그인의 link파일을 삭제하면 Eclipse 시작 시 플러그인을 동작하지 않는다.

Step 4. 설치 확인

다음은 Eclipse IDE에 3-party Plugins을 설치하였을 때의 폴더 구조이다.

[Eclipse IDE 설치 폴더]
       |
       |---addins
       |---configuration
       |---features
       |---links
       |---plugins
       |---readme

Anyframe Plugins 설치

Step 1. Anyframe Plugins 설치 준비

Anyframe Plugins을 다운로드 페이지에서 Plugins를 다운로드 받을 수 있다. Anyframe Common, Anyframe Codegen, Anyframe ConfigEditor, Anyframe DBIO 네 개의 Anyframe Plugins중 설치할 plug-in을 다운로드 받는다.

Anyframe Plugin을 설치를 위해서는 Eclipse IDE설치폴더/addins폴더 아래 anyframe/eclipse/plugins 폴더를 생성한다.

[Eclipse IDE 설치 폴더]
       |
       |---addins
             |---anyframe
                      |---eclipse
                             |---plugins :
                                   Anyframe Plugins이 배포될 폴더
        |---configuration
       |---features
       |---links
       |---plugins
       |---readme

이클립스에서 Anyframe Plugin을 인식 하기 위해서 links폴더 아래 anyframe.link라는 파일을 만든다. 파일 내용은 다음과 같다.

path=addins/anyframe

Step 2. Anyframe Plugins 설치

Anyframe Plugins는 총 네개의 파일로 구성되어 있다. 다음은 각 각의 Plugin들을 설치하는 방법이다.

Anyframe Common을 설치 하기 위해서는 다운로드 페이지의 Anyframe Tools - Common을 통해 anyframe.plugins.common_x.x.x.zip파일을 다운로드 받는다. 다운로드 받은 zip파일을 [eclipse폴더]/addins/anyframe/eclipse/ 에 압축해제 한다.

Anyfrale Plugins 다운로드 페이지의 Anyframe Tools - Codegen을 통해 anyframe.plugins.codegen_x.x.x.zip파일을 다운로드 받는다. 다운로드 받은 zip파일을 [eclipse폴더]/addins/anyframe/eclipse/ 에 압축해제 한다.

[plugins]
    |
    |---anyframe.plugins.codegen.db_x.x.x.jar
    |---anyframe.plugins.codegen_x.x.x.jar
    |---anyframe.plugins.codegen.template : wiazrd와 vm파일이 포함

Anyframe Plugins 다운로드 페이지의 Anyframe Tools - ConfigEditor를 통해 anyframe.plugins.configeditor_x.x.x.zip파일을 다운로드 받는다. 다운로드 받은 zip파일을 [eclipse폴더]/addins/anyframe/eclipse/ 에 압축해제 한다.

Anyframe Plugins 다운로드 페이지의 Anyframe Tools - DBIO를 통해 anyframe.plugins.dbio_x.x.x.zip파일을 다운로드 받는다. 다운로드 받은 zip파일을 [eclipse폴더]/addins/anyframe/eclipse/ 에 압축해제 한다.

• Anyframe DBIO 요구사항
  Anyframe DBIO 1.2.0 이상 버전의 경우, Anyframe Tools 설치환경에 추가하여 다음과 같은 요구사항을 충족해야 한다.
  • Eclipse IDE for Java EE Developers (Europa/Ganymede, Europa 버전은 Eclipse 및 3rd-party Plug-ins 다운로드 페이지에서 다운로드)
  • Anyframe Common 1.2.0 이상 (Development Tools 다운로드 페이지에서 다운로드)
  • Eclipse SQL Explorer 3.5 RC5 (Eclipse 및 3rd-party Plug-ins 다운로드 페이지에서 다운로드)
    Anyframe DBIO 1.2.0 및 1.2.1 버전에서는 3.5 RC5 이외의 버전에서 일부 문제점이 보고되었으며, 해당 사항은 Anyframe DBIO의 다음 릴리이즈에서 개선될 예정임.
• Ecipse IDE for Java EE Developers 이외의 Package를 사용할 경우
  Eclipse IDE for Java EE Devlopers 패키지는 다른 패키지에 비하여 개발자에게 유용한 다양한 플러그인을 포함하고 있으며, Anyframe을 활용한 개발을 위하여 권장하는 패키지이다. 다만, 필요에 의하여 이외의 Eclipse IDE 패키지에 Anyframe DBIO를 설치, 사용하고자 한다면 다음의 플러그인 의존관계(Plug-ins Dependencies)를 확인하여, 해당 플러그인을 설치한 후 Anyframe DBIO를 설치, 사용한다.
  • 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 DBIO에서 업그레이드
  Anyframe DBIO 1.2.0 이전 버전에서 1.2.0 이상 버전으로 업그레이드를 할 경우에는 다음과 같은 순서를 따른다.
  1. Eclipse SQL Explorer 3.x.x 버전 제거: "[eclipse 폴더]/addins/[Eclipse SQL Explorer 설치 폴더]"를 삭제한 후, 3.5 RC5 버전을 설치한다.
  2. Anyframe Common 1.2.0 이상 버전 설치: "[eclipse 폴더]/addins/anyframe/eclipse/plugins/"의 "anyframe.plugins.common_1.1.0.jar" 또는 1.1.x 버전의 jar 파일을 삭제한 후, 1.2.0 이상 버전을 설치한다.
  3. Anyframe DBIO 1.2.x 버전 설치: "[eclipse 폴더]/addins/anyframe/eclipse/plugins/"의 "anyframe.plugins.dbio_1.x.x.jar" 파일을 삭제한 후, 1.2.x 버전을 설치한다.

Step 3. Anyframe Plugins 설치 확인

Anyframe Plugins가 모두 설치 되었으면 Eclipse를 실행 해 Anyframe Plugin이 설치가 모두 정상적으로 되었는지 확인한다.
Eclipse실행 후 상위메뉴 -> Help -> About Eclipse SDK -> Plug-in Details

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