eGovFrame Template Scaffolder
eGovFrame(전자정부 표준프레임워크) 개발환경의 템플릿을 활용하여 새로운 프로젝트를 쉽게 생성할 수 있는 VS Code 확장 프로그램입니다.
기능
- 🚀 템플릿 기반 프로젝트 생성: eGovFrame GitHub 저장소의 템플릿을 활용하여 새 프로젝트를 자동으로 생성합니다.
- 📦 다양한 템플릿 지원: Batch, IDE, Configuration, Test, Spring Boot 등 다양한 카테고리의 템플릿을 제공합니다.
- 🔧 자동 설정: 프로젝트명, 패키지명, Java 버전 등을 자동으로 설정합니다.
- 📋 템플릿 목록 조회: 사용 가능한 모든 템플릿을 카테고리별로 정리하여 보여줍니다.
- 🔄 자동 새로고침: GitHub 저장소의 최신 템플릿을 자동으로 동기화합니다.
사용법
1. 새 프로젝트 생성
- Command Palette:
Ctrl/Cmd + Shift + P → eGovFrame: 새 프로젝트 생성
- Explorer 우클릭: 폴더에서 우클릭 →
eGovFrame: 새 프로젝트 생성
- Activity Bar: eGovFrame 아이콘 클릭 → 템플릿 선택 후 생성
2. 템플릿 목록 보기
- Command Palette:
Ctrl/Cmd + Shift + P → eGovFrame: 사용 가능한 템플릿 보기
3. 템플릿 새로고침
- Command Palette:
Ctrl/Cmd + Shift + P → eGovFrame: 템플릿 새로고침
설정
Extension Settings
egovTemplate.githubRepository: eGovFrame 개발환경 GitHub 저장소 URL (기본값: https://github.com/eGovFramework/egovframe-development)egovTemplate.defaultBranch: 기본 브랜치명 (기본값: main)egovTemplate.cacheTemplates: 템플릿 캐시 사용 여부 (기본값: true)
설정 변경 방법
- VS Code 설정 열기:
Ctrl/Cmd + ,
- "egov"로 검색
- 원하는 설정 변경
지원되는 템플릿
Batch 처리
egovframework.bdev.imp.batch: Batch 처리 구현 템플릿egovframework.bdev.imp.batchnature: Batch Nature 템플릿
IDE 통합
egovframework.bdev.imp.ide: IDE 통합 도구 템플릿
설정 관리
egovframework.bdev.imp.confmngt: 설정 관리 템플릿
테스트
egovframework.bdev.tst: 테스트 도구 템플릿
Spring Boot
egovframework.boot.dev.imp.ide: Spring Boot 기반 IDE 템플릿
개발 환경 요구사항
- VS Code: 1.74.0 이상
- Node.js: 16.x 이상
- Java: 8 이상 (생성된 프로젝트 실행 시)
개발 및 빌드
개발 환경 설정
# 의존성 설치
npm install
# 개발 모드 실행
npm run watch
# 확장 프로그램 테스트 (F5 키)
빌드 및 패키징
# 컴파일
npm run compile
# 린트 체크
npm run lint
# 테스트 실행
npm run test
# VSIX 패키지 생성
npm run package
문제 해결
템플릿을 불러올 수 없는 경우
- 인터넷 연결 상태를 확인하세요.
- GitHub 저장소 URL이 올바른지 확인하세요.
- 템플릿 새로고침을 시도해보세요.
프로젝트 생성이 실패하는 경우
- 대상 폴더에 쓰기 권한이 있는지 확인하세요.
- 프로젝트명이 올바른 형식인지 확인하세요.
- 디스크 공간이 충분한지 확인하세요.
라이센스
이 프로젝트는 Apache 2.0 라이센스 하에 배포됩니다.
기여
버그 리포트, 기능 요청, 코드 기여를 환영합니다!
관련 링크
| |
