엑스플랫폼 V9.2.1 업데이트 가이드

엑스플랫폼 V9.2.1 버전으로 업데이트되면서 변경되는 항목은 아래와 같습니다.

버전 정보


XPLATFORM 9.2.1

XPLATFORM 9.2.0

SetupEngine.exe

{AA890DB4-7357-4237-82BB-D0B931AAB420}

{0239FCE5-88CF-48e9-912D-90DAFC25E38B}

SetupEngine.cab

7E0D6AB0-6E1E-441C-969A-CD85DCA58DFB

43C5FE00-DD32-4792-83DB-19AE4F88F2A6

XPLauncher.cab

9.2.0 버전과 같음

A30D5481-7381-4dd9-B0F4-0D1D37449E97

버전 정보와 관련된 상세한 내용은 제품 배포 시 포함된 파일을 참고해주세요.

XPLATFORM9.2.x_VersionInfo_YYYYMMDD_1.txt

모듈

런처는 새로 설치한 상위 버전이 하위 버전을 대체하며 하위 호환성을 유지합니다.

엑스플랫폼 엔진은 CLSID와 레지스트리가 변경됩니다.

XPLauncher

XPlatformAX

CLSID와 레지스트리가 변경되었습니다.XPlatformAX에서 사용하는 CLSID와 레지스트리는 업데이트 버전 변경 시 변경됩니다.

npXLauncherPlugin

CLSID는 엑스플랫폼 V9.2.0 버전과 같습니다.

npXPlatformPlugin

CLSID와 레지스트리가 변경되었습니다.npXPlatformPlugin에서 사용하는 CLSID와 레지스트리는 업데이트 버전 변경 시 변경됩니다.

설치 경로

업데이트 버전이 변경되면 하위 버전이 독립적으로 실행할 수 있도록 설치 경로가 변경됩니다.

엔진 설치 경로

V9.2.1 버전에서 엔진 설치 경로는 아래와 같습니다.

C:\Program Files\TOBESOFT\XPLATFORM\9.2.1\
C:\Program Files (x86)\TOBESOFT\XPLATFORM\9.2.1\

V9.2.0 버전에서는 업데이트 버전을 표시하는 0을 제외한 경로를 사용합니다.

C:\Program Files\TOBESOFT\XPLATFORM\9.2\

UX 스튜디오 설치 경로

V9.2.1 버전에서 UX 스튜디오 설치 경로는 아래와 같습니다.

C:\Program Files\TOBESOFT\XPLATFORM\9.2.1\UXStudio92.exe
C:\Program Files (x86)\TOBESOFT\XPLATFORM\9.2.1\UXStudio92.exe

컴포넌트 설치 경로

사용자가 설치 경로를 지정하지 않았을 때 기본 설치되는 경로는 아래와 같습니다.

C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2\Component
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.1\Component

배포 페이지 작성 시 고객사별로 컴포넌트 경로를 설정할 수 있습니다. 이때 이전 버전(9.2.0.x) 버전과 충돌하지 않도록 버전정보를 추가해주어야 합니다.

XLauncher.xadl = Server_Path + "/Sample_PRJ/Sample_MDI.xadl"; //프로젝트의 xadl 위치
XLauncher.onlyone = true; //실행할 프로그램 한개 or 한개이상 실행여부 설정
XLauncher.splashimage = Server_Path+"/Install/img/loading_img.gif"; //loading 이미지 지정부분
XLauncher.componentpath="%USERAPPLOCAL%/tobeComponent/9.2.1/componet/";

바탕화면 단축 아이콘

XPLauncher에서 makeshortcut 메소드를 실행한 경우 단축 아이콘의 대상 경로가 아래와 같이 수정됩니다.

"C:\Program Files\TOBESOFT\XPLATFORM\9.2.1\XPlatform.exe"
    -K 'XFShowCase'
    -X 'http://localhost:8080/Next_JSP/XFShowcase/UI/ShowCase.xadl'

기존에 만들어진 바탕화면 단축 아이콘이 있는 경우 아래 조건에 따라 처리합니다.

xplatform.xml

엑스플랫폼 초기 설정 파일인 xplatform.xml 파일은 아래 위치에 설치됩니다.

C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPLATFORM\9.2\xplatform.xml
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPLATFORM\9.2.1\xplatform.xml

로그 파일

로그 파일은 아래 위치에 저장합니다.

C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2\*.log
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.1\*.log

XADL

XADL 속성이 추가되었습니다.

updateshortcut

엔진에서 바탕화면 단축 아이콘 처리를 어떻게 할지 지정합니다.

xadl.updateshortcut = "none/auto/updateurl"

항목

설명

none

기본값입니다.

바탕화면 단축 아이콘 처리를 하지 않습니다.

auto

엔진에서 자동으로 바탕화면 단축 아이콘을 생성하거나 수정합니다.

엔진 경로, -K 옵션, -X 옵션이 같다면 수정 대상으로 판단하고 모두 수정합니다.

updateurl

updateurl에 지정된 경로에서 XLauncher를 통해 처리합니다.

updateurl

updateshortcut 속성값이 updateurl인 경우 연결될 XLauncher가 있는 URL을 지정합니다.

xadl.updateurl = url
xadl.updateurl = "http://www.xplatform.com/xplatform_update.html"

XLauncher가 있는 경로를 지정합니다. 웹브라우저(IE)를 실행해 XLauncher를 통해 바탕화면 단축 아이콘을 수정합니다. updateurl에 지정된 url을 파라미터로 엔진이 IE 브라우저를 실행합니다.

런처 (XPLauncher, npXLauncherPlugin)

변경된 메소드와 속성에 대한 상세한 내용은 제품 도움말에서 참고할 수 있습니다.

Runtime > Plugins > XPLauncher > Method > launch

Runtime > Plugins > npXLauncherPlugin > Method > launch

Runtime > Plugins > XPLauncher > Method > getengineversion

Runtime > Plugins > npXLauncherPlugin > Method > getengineversion

Runtime > Plugins > XPLauncher > Method > makeshortcut

Runtime > Plugins > npXLauncherPlugin > Method > makeshortcut

Runtime > Plugins > XPLauncher > Property > enginesetupkey

Runtime > Plugins > npXLauncherPlugin > Property > enginesetupkey

Runtime > Plugins > XPLauncher > Property > version

Runtime > Plugins > npXLauncherPlugin > Property > version

launch 메소드

엑스플랫폼 애플리케이션을 실행하는 메소드입니다.

getengineversion 메소드

엑스플랫폼 ProductKey 값에 해당하는 엔진 버전을 가져오는 메소드입니다.

makeshortcut 메소드

바로 가기 아이콘을 생성하는 메소드입니다.

enginesetupkey 속성

특정 버전의 엑스플랫폼 ProductKey 값을 지정하는 속성입니다.

launcher.enginesetupkey = "{0239FCE5-88CF-48e9-912D-90DAFC25E38B}"; //9.2
launcher.enginesetupkey = "{AA890DB4-7357-4237-82BB-D0B931AAB420}"; //9.2.1

version 속성

엑스플랫폼의 동작 버전을 지정하는 속성입니다.

launcher.version = "9.2";
launcher.version = "9.2.1";

version 속성값을 지정하지 않았을 경우에는 엑스플랫폼의 동작에 문제가 생길 수 있으므로 반드시 지정할 것을 권장합니다.

확장 모듈

엑스플랫폼 기본 모듈 외에 확장 모듈을 사용하고 있다면 해당 모듈에 대한 재빌드 필요합니다.

ExtCommonApi

ExtCommonApi는 투비소프트에서 팁 형태로 제공하는 확장 모듈입니다. 기술 지원 대상은 아니지만, 업데이트 버전에 따라 수정된 모듈을 제공합니다.

해당 모듈은 아래 게시판에서 별도로 내려받을 수 있으며 버전별 모듈을 따로 제공합니다.

고객지원센터 TIP 팁 게시판 > [ XPLATFORM ExtCommonApi UPDATE ... ]

자체 확장 모듈

프로젝트의 필요에 따라 직접 매핑한 모듈을 사용한 경우에도 SDK를 이용한 재빌드가 필요합니다.

소스 코드 호환

현재 업데이트 버전(9.2.1.x)에서 추가된 속성은 아래와 같으며 이후 패치 버전이나 업데이트 버전이 나오면서 추가되거나 변경될 수 있습니다.