VertexNEXT VPSDK Developer Manual
0. 시작하기 전에 알아두기
VPSDK 란 무엇인가요?
VPSDK 는 VertexNEXT 의 플러그인을 개발할 수 있도록 구성된 Visual Studio 프로젝트 파일 입니다.
본 SDK 를 사용하면 쉽고 빠르게 VertexNEXT 에서 동작하는 플러그인을 개발하고 배포할 수 있습니다.
개발에 사용 가능한 언어는 어떻게 되나요?
VPSDK 는 공식적으로 VB.NET 및 C# 을 지원하며
WinForm 또는 WPF 등과 같은 해당 언어의 모든 기능을 이용할 수 있습니다.
개발한 플러그인은 어떻게 스토어에 등록하나요?
StyleRoot 의 추가기능 갤러리 -> VertexNEXT (http://www.styleroot.com/addonvertexnext)
에서 배포하면 자동으로 스토어에도 해당 컨텐츠가 표시되고 다른 사람들이 손쉽게 설치할 수 있습니다.
플러그인 개발시 플레이어를 제어하기 위한 명령어들은 어디에서 확인할 수 있나요?
VertexNEXT VPSDK 레퍼런스 메뉴얼 (http://www.styleroot.com/vpsdk_reference) 에서 확인하실 수 있습니다.
1. 플러그인 개발 방법
1-1. VPSDK 다운로드 및 실행
http://www.styleroot.com/vpsdk_download
에서 플러그인 개발을 위한 SDK 의 다운로드가 가능합니다.
원하는 언어의 VPSDK 를 다운로드 해주시기 바랍니다.
다운로드가 완료되면 압축을 해제하고 Visual Studio 로 VPSDK.sin 파일을 열어주세요.
1-2. 플러그인 이름 정하기
VPSDK 의 로드가 완료되면 우측의 " 솔루션 탐색기 " 에서 My Project (또는 Properties) 를 더블 클릭하면 속성을 편집할 수 있습니다.
" 어셈블리 이름 " 및 " 루트 네임스페이스 " 부분을 자신이 원하는 플러그인 이름으로 변경 해주시기 바랍니다.
1-3. 플러그인 코딩 시작하기
기본적인 속성 변경이 완료되었으니 본격적인 코딩을 시작합니다.
우측 " 솔루션 탐색기 " 에서 Run.vb (또는 Run.cs) 를 더블 클릭합니다.
해당 클레스가 플러그인의 진입점을 포함하고 있는 부분으로 여기서 코딩을 시작하시면 됩니다.
단순한 작업을 위한 코드 작성부터 시작하여
프로젝트에 Form 이나 WPF Window 를 추가하여 개발할 수 있습니다.
만약 Form 이나 WPF Window 를 추가한 경우
[ VB.NET ]
Dim WindowName As New WindowName WindowName.Show()
[ C# ]
WindowName WindowName = new WindowName(); WindowName.Show();
와 같은 방법으로 추가한 Form 또는 Window 를 실행할 수 있습니다.
1-4. 플러그인 패키지 만들기
코딩이 완료된 경우 " 빌드 -> VPSDK 빌드 " 를 클릭하여 프로젝트를 빌드합니다.
빌드하여 ~VPSDK\bin\Debug 경로에 생성된 플러그인 이름.DLL 파일을 적당한 폴더에 복사합니다.
복사한 폴더에 PluginConfig.vpc 라는 이름의 빈 텍스트 파일을 하나 만들어준 뒤 다음과 같은 내용을 적고 저장합니다.
!VertexNEXT Plugin Configuration File V 1.0 <Info PTitle="플러그인 제목" DllName="파일 이름.dll" EntryPoint="파일 이름.Run" MethodName="MainMethod" /> !End
만약 개발시 Run 클래스의 진입점 이름등을 변경한 경우
그에 맞게 EntryPoint 와 MethodName 부분도 수정하여야 합니다.
일반적으로는 그냥 플러그인 제목, 플러그인 이름 부분만 변경하여 주시면됩니다.
위와 같이 구성이 완료되면 " 두개의 파일을 모두 선택 " 후 사용하는 압축 프로그램으로 .ZIP 파일로 압축해주세요.
압축이 완료되면 단순히 생성된 압축 파일의 확장자를 .ZIP -> .VPP 로 변경하여 주시면 완성입니다.
완성된 파일은 VertexNEXT 추가기능 갤러리 (http://www.styleroot.com/addonvertexnext) 에서 배포하실 수 있습니다.