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

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

• 엔진 CLSID가 변경되었습니다.

• 모듈 파일명이 변경되었습니다.

• 엔진 설치 경로가 변경되었습니다.

버전 정보

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

모듈

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

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

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

XPLauncher

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

• 하위 호환성을 유지합니다.

• 일부 메소드 기능이 변경되었습니다.

  • launch()

  • getengineversion()

  • makeshortcut()

• 일부 속성이 추가되었습니다.

  • enginesetupkey

  • version

XPlatformAX

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

npXLauncherPlugin

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

• 하위 호환성을 유지합니다.

• 일부 메소드 기능이 변경되었습니다.

  • launch()

  • getengineversion()

  • makeshortcut()

• 일부 속성이 추가되었습니다.

  • enginesetupkey

  • version

npXPlatformPlugin

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

설치 경로

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

엔진 설치 경로

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

C:\Program Files\TOBESOFT\XPLATFORM\9.2.2\
C:\Program Files (x86)\TOBESOFT\XPLATFORM\9.2.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

컴포넌트 설치 경로

• 컴포넌트 설치 경로는 기존처럼 사용자가 지정한 위치에 설치할 수 있습니다.

• 설치 경로를 지정하지 않은 경우에는 기본 설정된 위치에 설치합니다.

• 이전 버전(V9.2.0 혹은 V9.2.1)과 상위 버전(V9.2.2) 버전이 충돌하지 않게 하려면 다른 위치를 설정해야 합니다.

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

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

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'

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

• XPLauncher.enginesetupkey 속성값과 XPLauncher.version 속성값을 참조합니다.

• 두 항목이 모두 지정된 경우에는 enginesetupkey 속성값을 우선 참조합니다.

• 두 항목이 모두 지정되지 않은 경우에는 9.2.0 버전으로 동작합니다.

• 지정한 XPLauncher.enginesetupkey 속성값이 각 버전에 맞는 CLSID가 아니면 9.2.0 버전으로 동작합니다.

• 지정한 XPLauncher.version 속성값이 9.2.0, 9.2.1, 9.2.2 이외의 값이면 9.2.0 버전으로 동작합니다.

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"

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 버전부터 런처관련 일부 기능이 변경 및 추가되었습니다.

• 일부 메소드 기능이 변경되었습니다.

  • launch()

  • getengineversion()

  • makeshortcut()

• 일부 속성이 추가되었습니다.

  • enginesetupkey

  • version

launch 메소드

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

• key, xadl 항목이 없다면 애플리케이션을 실행할 수 없으며 오류로 처리합니다.

• xplatform.xml 파일을 읽거나 쓰는 과정에 문제가 발생하면 오류로 처리합니다.

• 오류는 error() 이벤트 메소드에서 확인할 수 있습니다.

• launch 메소드로 실행할 엑스플랫폼 엔진의 버전을 지정하고 싶은 경우 enginesetupkey 속성 또는 version 속성을 사용합니다.

  • 두 항목이 모두 지정되지 않은 경우에는 9.2.0 버전의 엑스플랫폼이 실행됩니다.

  • 지정한 enginesetupkey 속성값이 각 버전에 맞는 CLSID가 아니면 9.2.0 버전의 엑스플랫폼을 실행합니다.

  • 지정한 version 속성값이 9.2, 9.2.1, 9.2.2 이외의 값이면 9.2.0 버전의 엑스플랫폼을 실행합니다.

getengineversion 메소드

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

• 인자로 입력된 engine key 값으로 레지스트리에 등록된 DisplayVersion 정보를 반환합니다.

  ex) 9.2.2.153

• 인자로 입력된 engine key 값이 없거나 입력된 engine key 값과 매칭된 버전 정보를 찾지 못하는 경우, 설치된 모든 버전 정보를 반환합니다. 설치된 버전이 여러 개인 경우, 쉼표(,)로 각 버전을 구분합니다.

  ex) 9.2.0.153,9.2.2.150

makeshortcut 메소드

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

• 인자로 입력한 아이콘 경로가 원격지 서버일 경우에는 파일을 내려받은 후 지정된 componentpath에 저장하며 바로 가기 아이콘 경로도 componentpath로 지정합니다.

• 인자로 입력한 단축 아이콘 이름과 같은 아이콘이 존재하는 경우에는 아이콘을 삭제한 후 다시 생성합니다.

• 윈도우8 운영체제에서 다음과 같은 경우에 관리자 권한이 없으면 바로 가기 아이콘 설치가 제한될 수 있습니다. 이런 경우에는 관리자 권한으로 웹 브라우저를 실행하십시오.

  • bAllUser 매개변수를 true 값으로 설정한 경우: 공용 desktop 혹은 공용 startmenu

  • 바로 가기 설치 위치 혹은 아이콘 파일 내려받기 경로가 시스템 폴더인 경우

• 바로 가기의 실행 대상이 되는 엑스플랫폼 엔진의 실행 경로 및 버전을 지정하기 위해 enginesetupkey 속성과 version 속성을 사용합니다.

• enginesetupkey 속성값과 version 속성값을 어떻게 지정하느냐에 따라 다음과 같이 처리됩니다.

  • enginesetupkey 속성값과 version 속성값을 둘 다 지정하지 않은 경우에는 9.2.0 버전으로 동작합니다.

  • enginesetupkey 속성값만 지정하고 version 속성값을 지정하지 않은 경우에는 enginesetupkey와 일치하는 엔진 키 값의 버전으로 동작하며 그 외에는 모두 9.2.0 버전으로 동작합니다.

  • version 속성값만 지정하고 enginesetupkey 속성값을 지정하지 않은 경우에는 version 속성값에 따라 설치 경로가 결정됩니다. (C:\Program Files\TOBESOFT\XPLATFORM\9.2 또는 9.2.2)

  • 특정 버전을 명시하지 않은 경우에는 9.2.0 버전으로 동작합니다. 엑스플랫폼의 특정 버전을 동작시켜야 할 경우에는 반드시 version 속성값을 지정하십시오.

enginesetupkey 속성

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

• launch, makeshortcut 메소드 수행 시 엑스플랫폼의 설치 경로와 실행 버전을 지정하고자 할 경우에 version 속성과 함께 참조되는 값입니다.

• enginesetupkey 속성값을 지정하였을 상황에 해당하는 엑스플랫폼 설치 경로를 찾지 못하면 오류로 처리합니다.

• enginesetupkey 속성값과 version 속성값을 어떻게 지정하느냐에 따라 다음과 같이 처리됩니다.

  • enginesetupkey 속성값과 version 속성값을 둘 다 지정하지 않은 경우에는 9.2.0 버전으로 동작합니다.

  • enginesetupkey 속성값만 지정하고 version 속성값을 지정하지 않은 경우에는 enginesetupkey와 일치하는 엔진 키 값의 버전으로 동작하며 그 외에는 모두 9.2.0 버전으로 동작합니다.

  • version 속성값만 지정하고 enginesetupkey 속성값을 지정하지 않은 경우에는 version 속성값에 따라 설치경로가 결정됩니다. (C:\Program Files\TOBESOFT\XPLATFORM\9.2 또는 9.2.2 등)

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 속성

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

• version 속성값은 런처의 메소드 호출 전에 명시되어야 합니다.

• version 속성값은 정확하게 입력해야 합니다. 별도의 배포 버전을 사용할 경우에는 실제 엑스플랫폼의 버전 값을 입력합니다.

• version 속성값을 지정하지 않은 경우에는 enginesetupkey 속성에 각 버전에 맞는 엔진 키 값을 지정했을 경우에만 동작하며 그 외에는 모두 9.2.0 버전으로 동작합니다.

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

확장 모듈

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

ExtCommonApi

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

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

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

자체 확장 모듈

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

소스 코드 호환

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

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

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

• 바탕화면 단축 아이콘 생성 관련 속성

• Application > updateshortcut, updateurl

• 국가별 RTL 지원 속성

• Application > rtldirection

• Binary Components > rtldirection, rtlimagemirroring