====== 구현도구 플러그인(m2eclipse) ====== ===== 개요 ===== 전자정부 개발 프레임워크의 개발환경 IDE에서는 메이븐 통합 플러그인으로 m2eclipse을 사용하고 있으며 \\ m2eclipse를 통한 보다 효율적인 Maven 프로젝트 개발 편의성을 제공하고 있다. ===== 설명 ===== ==== m2eclipse의 특징 ==== - 이클립스에서의 maven build 실행 - pom.xml에 기반한 이클립스 빌드 패스의 의존성(dependency) 관리 - 리모트 리포지토리로부터 pom.xml에서 선언한 dependency의 자동 다운로드 - Maven 프로젝트 생성 위자드(wizards) 제공 - Maven 리포트 리포지토리 연동을 통한 dependency quick search 기능 제공 ===== 환경 설정 ===== 전자정부 개발 프레임워크의 개발환경 IDE에 메이븐 통합 플러그인인 m2eclipse가 설치되어 있다. \\ 구현 도구의 IDE 참조: [[egovframework:dev2:imp:editor:ide|IDE]] **Maven 설정 파일 세팅** 1. settings.xml에서 별다른 설정이 없다면, 아래 이미지와 같이 기본 설정이 적용될 것이다. \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_settings_xml_default.png?width:600}} \\ \\ 2. Maven 설정 파일인 settings.xml 파일을 생성한 것이 있다면, User Settings에 settings.xml 파일 위치를 지정한다. \\ settings.xml에서 Local Repository를 지정했다면 아래 이미지와 같이 나올 것이다. \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_settings_xml.png?width:600}} \\ ===== 사용법 ===== ==== 메이븐 프로젝트 생성 ==== 전자정부 표준 프레임워크 개발환경에서는 Maven 프로젝트를 생성하기 위한 방법으로 eGovFramework perspective을 활용하고 있으며, 구체적인 생성 방법은 개발 환경 구현도구 매뉴얼에서 확인할 수 있다. * Maven 프로젝트 생성 마법사: [[egovframework:dev2:imp:editor:ide|구현도구 - IDE]] \\ \\ ==== M2Eclipse 메이븐 명령 ==== 생성한 메이븐 프로젝트에서 오른쪽 마우스 클릭 후 maven 메뉴를 선택하면 m2eclipse에서 제공하는 기본적인 메이븐 명령어들을 수행할 수 있습니다. {{:egovframework:dev4.3:dep:build_tool:m2eclipse_maven_menu.png?width:600}} \\ === m2eclipse 메뉴에서 제공하는 기능 === - dependency 및 메이븐 플러그인 추가 \\ - pom.xml 에디터 제공 - dependency, snapshots, 소스 폴더 업데이트 \\ - 메이븐 모듈 생성 \\ - module 프로젝트 생성 마법사 기능 제공 - 소스 코드 다운로드 \\ - 리모트 리포지토리에서 artifact 소스 코드를 다운로드 할 수 있다. 디버깅 시에 효과적으로 이용할 수 있다. - 이클립스 workspace resolution 기능 제어 \\ - workspace에 등록된 메이븐 프로젝트 들간의 연동에 대해 제어할 수 있다. \\ - disable 시킬 경우 로컬 리포지토리에 연동하고자 하는 프로젝트를 install하고 dependency 선언을 통해 참조하여야 한다. * **사용팁** \\ 메이븐 프로젝트를 check out, 생성 또는 불러온 후 Maven -> 'Update Project...' 를 클릭하면, 해당 메이븐 프로젝트의 환경 및 dependencies를 업데이트 시켜준다. ==== 메이븐 빌드 실행 ==== 메이븐의 빌드 명령어를 Run As 또는 debug as 메뉴에서 실행할 수 있으며 'Maven build...' 명령어 선택을 통해 직접 빌드의 Goal을 정의할 수 있다. {{:egovframework:dev4.3:dep:build_tool:m2eclipse_build.png?width:600}} \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_build_configuration.png?width:600}} ==== 메이븐 프로젝트 실행 ==== Run AS -> clean install 명령으로 메이븐 웹 프로젝트를 빌드한 후에 Run On Server 명령으로 웹 프로젝트를 실행한다.\\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_runas_runonserver.png?width:600}} \\ ==== 예제 프로젝트 실행 가이드 ==== 개발 환경에서는 가이드 프로그램으로 web project 를 제공하고 있다. === 1. 예제 프로젝트 생성 === {{:egovframework:dev4.3:dep:build_tool:m2eclipse_egovframe_menu.png?width:600}} \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_new_web1.png?width:600}} \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_new_web2.png?width:600}} \\ === 2. 의존성 업데이트 === 프로젝트 우클릭 -> maven -> Update Project를 실행한다. \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_maven_update_project.png?width:750}} === 3. build & install === Run As -> install 명령을 실행시켜 예제 프로젝트 빌드 작업 및 패키징 작업을 수행한다. \\ target 디렉토리 밑에서 Maven 빌드 산출물들을 확인할 수 있다. \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_runas_install.png?width:750}} === 4. 실행 === Run As -> Run On Server 명령으로 예제 프로젝트를 실행한다. \\ {{:egovframework:dev4.3:dep:build_tool:m2eclipse_server.png?width:750}} ===== 참고 자료 =====