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

엑스플랫폼 최신 버전은 기존 버전의 업데이트를 포함합니다. 본 장에서는 최신 버전에 새로 추가, 변경된 내용과 기존 버전의 업데이트 내용에 대해 설명합니다.

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

버전 정보

엑스플랫폼 엔진의 CLSID가 변경되었습니다.


XPLATFORM 9.2.2

XPLATFORM 9.2.1

XPLATFORM 9.2.0

SetupEngine.exe

{E05CD7D8-28AF-4577-89AC-E4F1F8ABF046}

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

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

SetupEngine.cab

FF4E5C35-06C0-4912-9046-B7A6A8B92BEB

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

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

XPLauncher.cab

9.2.0 버전과 같음

9.2.0 버전과 같음

A30D5481-7381-4dd9-B0F4-0D1D37449E97

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

XPLATFORM9.2.x_VersionInfo_YYYYMMDD_1.txt

모듈

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

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

각 버전별 모듈간의 종속성 및 공유 DLL 참조를 위해 모듈명이 변경되었습니다.

XPLATFORM 9.2.2

XPLATFORM 9.2 및 9.2.1

경로

XBasicLib922.dll

XBasicLib92.dll

엔진 설치 경로

XClassLib922.dll

XClassLib92.dll

엔진 설치 경로

XDebugLib922.dll

XDebugLib92.dll

엔진 설치 경로

XHttpLib922.dll

XHttpLib92.dll

엔진 설치 경로

XMemPoolLib922.dll

XMemPoolLib92.dll

엔진 설치 경로

XPlatformLib922.dll

XPlatformLib92.dll

엔진 설치 경로

XPlatformAX922.dll

XPlatformAX92.dll

엔진 설치 경로

XPLauncher922.dll

XPLauncher92.dll

엔진 설치 경로

npXPlatformPlugin922.dll

npXPlatformPlugin92.dll

엔진 설치 경로

npXPLauncherPlugin922.dll

npXPLauncherPlugin92.dll

엔진 설치 경로

XComCmp922.dll

XComCmp.dll

컴포넌트 설치 경로

XAxCmp922.dll

XAxCmp.dll

컴포넌트 설치 경로

XGridCmp922.dll

XGridCmp.dll

컴포넌트 설치 경로

XPLauncher

XPlatformAX

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

npXLauncherPlugin

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

npXPlatformPlugin

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

설치 경로

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

엔진 설치 경로

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

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

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

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

UX 스튜디오 설치 경로

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

C:\Program Files\TOBESOFT\XPLATFORM\9.2.2\UXStudio92.exe
C:\Program Files (x86)\TOBESOFT\XPLATFORM\9.2.2\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
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.2\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.2/componet/";

바탕화면 단축 아이콘

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

"C:\Program Files\TOBESOFT\XPLATFORM\9.2.2\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.2\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
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.2\*.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)

9.2.1 버전부터 런처관련 일부 기능이 변경 및 추가되었습니다.

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

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
launcher.enginesetupkey = "{E05CD7D8-28AF-4577-89AC-E4F1F8ABF046}"; //9.2.2

version 속성

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

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

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

확장 모듈

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

ExtCommonApi

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

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

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

자체 확장 모듈

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

소스 코드 호환

이전 버전(9.2.0) 소스 코드는 업데이트 버전(9.2.2)에서 수정 없이 사용할 수 있습니다.

업데이트 버전에서 생성하거나 저장한 프로젝트는 이전 버전에서 사용 시 오류가 발생할 수 있습니다. 업데이트 버전에 추가된 속성이나 메소드를 사용한 경우 이전 버전에서 이를 인식하지 못해 오류가 발생하며 필요한 경우 개발자가 직접 수정해줘야 합니다.

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