기본 콘텐츠로 건너뛰기

[VSIX] Visual Studio 확장에 대해서... #4 Wizard 추가

Add a wizard on template

이전 게시글에서 메뉴와 명령 처리를 설정해서 검증하였다. 이번에는 INI 파일을 단순히 추가하던 기능에 추가하는 과정에서 Culture 정보를 선택할 수 있는 화면을 제공하고 이 화면에서 선택된 Culture를 추가된 파일에 적용하는 구성을 알아보도록 한다.

즉, 쉽게 이야기를 하면 기존 템플릿 처리는 Visual Studio의 내장 마법사를 통해서 처리를 했지만, 이번에는 사용자 정의 마법사 (Custom Wizard)를 구동시켜서 템플릿에 추가적인 정보를 제공할 수 있도록 한다는 것이다.

Add a library project

Wizard 는 Visual Studio 에서 호출이 되기 때문에 관련된 정보가 vstemplate 파일에 지정되어야 한다. 따라서 별도의 클래스 라이브러리 프로젝트를 추가하여 작업을 하도록 한다.
프로젝트 생성은 따로 설명을 하지 않고 순차적인 처리를 정리해 놓도록 한다.

  • FDTWorksTool.Library 라는 이름의 클래스 라이브러리 프로젝트 (나중에 WPF UI 를 추가할 것이다) 를 생성한다.
  • 자동으로 생성된 클래스 파일은 지운다.
  • 프로젝트를 선택하고 "기존 항목 추가"를 선택하여 서명할 키 파일을 앞에서 생성했던 FDTWorksTool 패키지 프로젝트 경로를 이동하여 "*.snk" 파일을 링크로 추가한다.
  • 프로젝트 속성 창을 열고 "서명" 섹션에서 방금 등록한 snk 파일을 지정하도록 한다.
  • 참조에 "Microsoft.VisualStudio.TemplateWizardInterface" 어셈블리를 추가한다.
아래의 그림은 생성된 클래스 라이브러리 프로젝트를 보여주고 있다.


Modify package project

패키지 프로젝트에서는 Wizard를 사용할 수 있도록 위에서 만든 Library 를 추가해 주어야 한다.
  • 참조에 Library Project를 추가한다.
  • 전체 빌드를 수행한다.
프로젝트 추가에 따른 기본적인 작업은 위의 단계를 수행하면 된다. 이제 부터는 실제 사용을 위한 설정들을 하여야 하는데, vsixmanifest 파일에 위의 Library 프로젝트를 포함시키기 위해서는 서명된 어셈블리의 전체 이름을 적어 주어야 한다. 그러나 서명된 PublicKeyToken을 모르기 때문에 빌드된 경로에서 다음의 명령을 수행해서 확인해야 한다.

sn -T FDTWorksTool.Library.dll

또는 이전에 게시했던 글에서 설명한 것과 같이 Visual Studio에 외부 툴을 등록해 놓았다면 쉽게 알아낼 수도 있다. 위의 명령을 통해서 알아낸 정보를 기준으로 vsixmanifest 파일에 아래와 같이 추가해 주도록 한다.


*** 단, Visual Studio 에서 제공하는 vsixmanifest 관리자를 사용해서 처리하는 경우는 꼭 위와 같이 할 필요는 없다. (위의 예제는 수동으로 설정하는 것을 기준으로 하고 있다)

Creating the wizard dialog

지금까지 작업으로 패키지와 마법사가 위치할 라이브러리 프로젝트도 생성하고 설정하였으므로 이제는 실제 사용할 마법사 화면을 구성해 보도록 한다.

요즘은 WPF 를 사용하는 빈도가 높으니 WPF 로 화면을 아래와 같이 구성해 보도록 한다. "새 항목 추가" 를 통해서 "WPF Windows" 를 추가하고 파일의 이름은 "IniWizardDialog.xaml" 이라고 지정한다. 그리고 생성된 기본 XAML 파일을 아래의 그림과 같이 구성하도록 한다. (예제에서는 "Wizards" 라는 폴더를 추가하고 그 밑에 생성한 것이다, 그리고 관련된 XAML 어셈블리도 참조에 추가해 주어야 한다)


위의 코드에서 명시한 것과 같이 실제 동작 처리는 Code Behind (FDTWorksTool.Library.Wizards.IniWizardDialog.xaml.cs)에서 처리를 한다.

만들어진 XAML 태그를 보면 알 수 있는 것처럼 ComboBox를 사용하고 있다. 단순하게 Value/Text 쌍의 데이터를 바인딩하고 싶은데 XAML 에서 제공하는 것은 UI 관련해서 설정이 복잡하므로 단순한 클래스를 하나 만들어서 처리하도록 한다.

새로운 클래스를 추가하고 이름을 "ComboItemPair.cs"로 지정하고 아래의 그림과 같이 코드를 구성하도록 한다.


Key 는 실제 선택되었을 때 사용할 값이고, Description은 ComboBox 에 보여줄 정보라고 생각하면 된다.

이제 XAML 파일의 Code Behind 코드를 아래의 그림과 같이 마무리를 해 주도록 한다.


Creating the wizard

마법사로 사용할 화면도 완성이 되었으므로 Visual Studio가 패키지에서 추가한 마법사를 인식하고 사용할 수 있도록 Wizard 를 만들고 설정해 주어야 한다.

위에서 만들었던 라이브러리 프로젝트를 선택하고 참조에 아래와 같은 최소한 2개의 참조가 있는지 확인한다. 없다면 추가하도록 한다.

  • Microsoft.VisualStudio.TemplateWizardInterface - IWizard 인터페이스
  • EnvDTE - Visual Studio IDE

참조 설정이 끝났으면 "새 항목 추가" 를 통해서 클래스 파일을 "IniWizard.cs" 라는 이름으로 추가하고 아래의 그림과 같이 코드를 작성하면 된다.


아주 단순한 마법사이기 때문에 IWizard의 모든 메서드를 다 구현하지 않아도 된다. 필수적인 몇 가지만 구현해도 기본적인 처리는 가능하다. 위의 코드 중에서 잘 보아야 하는 부분은 다음과 같다.

  • replacementsDictionary - 템플릿 내에서 Visual Studio 가 제공하는 변수들과 치환하기 위한 정보이므로 여기에 추가적인 값들을 포함시켜서 템플릿 파일로 전달할 수 있다.
  • "$iniSelectedCulture$" 라는 이름으로 마법사 다이얼로그에서 사용자가 선택한 값이 전달될 수 있도록 replacementDictionary 에 추가했다.
이제 추가된 사용자 선택 값을 사용하기 위해서는 INIParserTemplate 프로젝트에 존재하는 iniTemplate.tini 파일을 열어서 다음과 같이 설정하면 값이 치환된다.


이제 배포되고 사용될 때 Visual Studio 가 마법사를 인식할 수 있도록 설정만 하면 된다. INIParserTemplate 프로젝트에서 .vstemplate 파일을 열고 아래의 그림과 같이 마법사에 대한 정보를 설정해 주도록 한다.



모든 작업이 완료되었으므로 실행을 해서 "새 항목 추가"를 해 보면 아래의 그림과 같이 마법사 다이얼로그가 나타나는 것을 확인할 수 있다.


그리고 OK 버튼을 누르면 아래의 그림과 같이 환경 설정에 사용할 INI 파일이 생성된 것을 확인할 수 있다.


라벨:

댓글

댓글 쓰기

이 블로그의 인기 게시물

OData 에 대해서 알아보자.

얼마 전에 어떤 회사에 인터뷰를 하러 간 적이 있었다. 당시 그 회사는 자체 솔루션을 개발할 기술인력을 찾고 있었고 내부적으로 OData를 사용한다고 했다. 좀 창피한 이야기일 수도 있지만 나름 기술적인 부분에서는 많은 정보를 가지고 있다고 했던 것이 무색하게 OData란 단어를 그 회사 사장님에게서 처음 들었다. 작고, 단순한 사이트들만을 계속해서 작업을 하다 보니 어느덧 큰 줄기들을 잃어버린 것을 느끼기 시작했다. 명색이 개발이 좋고, 기술적인 기반을 만들려고 하는 인간이 단어조차도 모른다는 것은 있을 수 없는 것이라서 다시 새로운 단어들과 개념들을 알아보는 시간을 가지려고 한다. OData (Open Data Protocol) 란? 간단히 정리하면 웹 상에서 손쉽게 데이터를 조회하거나 수정할 수 있도록 주고 받는 웹(프로토콜)을 말한다. 서비스 제공자 입장에서는 웹으로 데이터를 제공하는 방식으로 각 포탈 사이트들이 제공하는 OPEN API 포맷을 독자적인 형식이 아니라 오픈된 공통규약으로 제공 가능하며, 개발자는 이 정보를 다양한 언어의 클라이언트 라이브러리로 어플리케이션에서 소비할 수 있도록 사용하면 된다. 공식 사이트는 www.odata.org 이며 많은 언어들을 지원하고 있다. 좀더 상세하게 정의를 해 보면 OData는 Atom Publishing Protocol  (RFC4287) 의 확장 형식이고 REST (REpresentational State Transfer) Protocol 이다. 따라서 웹 브라우저에서 OData 서비스로 노출된 데이터를 볼 수 있다. 그리고 AtomPub 의 확장이라고 했듯이 데이터의 조회만으로 한정되는 것이 아니라 CRUD 작업이 모두 가능하다. Example 웹 브라우저에서 http://services.odata.org/website/odata.svc 를 열어 보도록 하자. This XML file does not appear to have any style in...
댓글 6개
자세한 내용 보기

C# 에서 Timer 사용할 때 주의할 점.

예전에 알고 지내시던 분의 질문을 받았다. Windows Forms 개발을 하는데, 주기적 (대략 1분)으로 데이터 요청을 하는 프로그램을 작성하기 위해서 Timer 를 사용하는데, 어떤 기능을 처리해야 하기 때문에 Sleep 을 같이 사용했다고 한다. 여기서 발생하는 문제는 Sleep 5초를 주었더니, Timer 까지 5초 동안 멈춘다는 것이다. Timer 라는 것은 기본적으로 시간의 흐름을 측정하는 기능이기 때문에 Sleep 을 했다고 해서 Timer 가 멈추는 일은 생겨서는 안된다. 그러나 실제 샘플을 만들어 보면 ... Timer 가 Sleep 만큼 동작이 멈추는 것을 확인할 수 있다. Windows Forms 는 UI Thread 를 사용하는 것으로 최적화 되어 있으며 여기서 Timer 를 쓰면 UI Thread 에 최적화된 System.Windows.Forms.Timer 가 사용된다. 여기서 문제의 발생이 시작되는 것이다. Sleep 을 사용하게 되면 UI Thread 가 Sleep 이 걸리기 때문에 여기에 속한 Timer 까지도 멈추는 것이다. 이런 문제를 해결하기 위해서는 System.Threading.Timer 를 사용해야 한다. 이 Timer 는 별도의 Thread 에서 동작하기 때문에 Sleep 의 영향을 받지 않는다. 언뜻 보면 쉬운 해결 방법인 것 같지만 Thread 가 분리되었기 때문에 Timer 가 돌아가는 Thread 에서 UI Thread 의 메서드나 컨트롤에 접근하기 위해서는 별도의 명령을 사용해야 하는 문제가 존재한다. 자~ 그럼 여기서 Timer 에 대해서 다시 한번 정리해 보도록 하자. .NET 에서 제공하는 Timer 들 .NET 에서는 기본적으로 3가지 Timer를 제공하고 있다. (MSDN) System.Windows.Forms.Timer - 사용자가 지정한 간격마다 이벤트를 발생시키며 Windows Forms 응용 프로그램에서 사용할 수 있도록 최적화 되어 있다. System...
댓글 7개
자세한 내용 보기

[Logging] NLog 사용법 정리...

SCSF 에는 기본적으로 Enterprise Library가 사용된다. 예전에도 그랬지만 기능은 훌륭하고 많은 부분에서 최적화(?)된 것일지도 모르지만, 역시나 사용하기에는 뭔가 모르게 무겁고, 사용하지 않는 기능이 더 많다라는 느낌을 지울수가 없다. 이번 프로젝트도 SCSF를 기반으로 하고 있지만, Enterprise Library를 걷어내고 각 부분에 전문화된 오픈 소스를 사용하기로 하였다. 예전에는 Log4Net을 사용했지만, 대량 사용자 환경에서는 메모리 누수와 기타 문제점이 존재한다는 MS 컨설턴트(?)의 전해진 말을 들은 후로는 사용하지 않는다. 대안으로 사용하는 것이 NLog 이다. 조금 후에는 3.0 버전도 나온다고 홈 페이지에 기재되어 있지만, 그 때가 되면 프로젝트는 끝나기 때문에 현재 2.1.0 버전을 사용하기로 했다. [원본 출처] http://cloverink.net/most-useful-nlog-configurations-closed/ 위의 참조 자료에는 다양한 정보들이 존재하므로 꼭 링크를 통해서 관련된 정보를 확인하고 이해하는 것이 좋을 듯 하다. 여기서는 당장 필요한 부분만을 정리하도록 한다. [ Logger 찾기 ] 기본적으로 Logger가 존재하는 클래스를 기반으로 Logger 정보를 구성한다. Logger logger = LogManager.GetCurrentClassLogger(); 주로 Namespace 기반으로 Logger를 설정하는 경우에 유연하게 사용할 수 있다. 또 다른 방법으로는 지정한 문자열로 특정 Logger를 직접 선택하는 방법도 제공된다. 이를 혼용해서 Namespace와 직접 지정 방식을 같이 사용할 수도 있다. 물론 Logger 환경 설정에서 Wildcard (*)를 지정할 수도 있다. Logger logger = LogManager.GetLogger("Database.Connect"); Logger logger = LogManager.Get...
댓글 1개
자세한 내용 보기