지원기능

17.1 이후 버전 사용 시 주의 사항

LauncherService 1.1.0.17 미만 버전 사용 시 globalvalue 속성값을 처리하지 못하는 오류가 있습니다. 배포 페이지에서 LauncherService 버전을 확인하고 1.1.0.17 이상 버전으로 업데이트할 수 있도록 가이드해야 합니다.

// 런처서비스 버전 정보 체크
function checkUpdateLauncher() {
	if (xhrObject.readyState == 4 || xhrObject.reqType == 2) {
		if (xhrObject.status == 200 || xhrObject.reqType == 2 && launcher_response(xhrObject.responseText)) {
 
			//1. getlauncherversion 런처서비스 버전 정보
			var resultJson = JSON.parse(xhrObject.responseText);
			strLocLuncherVer = resultJson.value["getlauncherversion"].productversion;
 
			//2. 설치 되어 있는 버전 보다 상위 값이면 TPL_LauncherDownload() 호출
			if (strLauncherVersion > strLocLuncherVer) {
				TPL_LauncherDownload("update");
			} else {
				//nexacro 실행..
			}
		}
	}
}
 
// 배포 페이지에서 메세지 셋팅 후 download_TPLSvc() 호출
function TPL_LauncherDownload(str) {
	var msg = "설치 되지 않았습니다.";
	if (str == "update") { msg = "업데이트 되었습니다."; }
	var contents = "TPLSvc가 " + msg + " TPLSvc를 다운로드 후 설치를 진행해 주시기 바랍니다.";
 
	var divCon = document.getElementById("errorDiv")
	divCon.innerHTML = "<H3>" + contents + "</H3>";
	document.location = download_TPLSvc("newlanucher");
}
 
var strLauncherFileName = "TPLSvc_Setup.exe";
 
// 런처서비스 다운로드 
function download_TPLSvc(type) {
	if (type == "newlanucher") {
		// 서버 경로의 TPLSvc_Setup.exe 다운로드
		var downURL = strServerPath + strDownloadPath + "/" + strLauncherFileName;
		return downURL;
	}
}

속성

메서드

이벤트

참고

디지털 서명을 유지한 상태로 설치 파일을 배포

SetupRuntime.exe 설치 파일을 실행하기 전에 SetupResource.zip 파일을 사용자 PC에 먼저 내려받아야 합니다.

setupresource 속성 설정

런처 서비스 구동을 위한 setproperty 함수에서 setupresource 속성값을 아래와 같이 true로 설정합니다.

objNexacro.action = 'setproperty';
if (action_sub == 'basic') {
	objNexacro.value = {
		"key": strKey,
		"bjson": strBjson,
		"splashimage": strSplashImage,
		"componentpath": strComponentPath,
		"loadingimage": strLoadingImage,
		"globalvalue": strGlobalValue,
		"onlyone": bOnlyone,
		"splashmessage": 'none',
		"setupresource": 'true',
		"enginesetupkey": strEnginesetupKey
	};
}

downloadresource 메서드 설정

start.json, SetupResource.zip 파일이 위치한 서버 경로를 인자값으로 설정합니다. downloadresource 메서드가 실행되면 설정된 경로에서 SetupResource.zip 파일을 "%USERAPP%SetupResource"경로에 내려받습니다.

else if (action == 'downloadresource') {
	objNexacro.value = {
		"downloadresource": {
			"param": ["http://127.0.0.1:8080/test/"]
		}
	};

downloadresource 메서드 실행 이후에 SetupRuntime.exe 파일을 내려받는 스크립트가 동작하도록 합니다.

사용예제

런처 실행 스크립트를 어떻게 구현하는지 간략한 예제를 설명합니다. 예제는 자바스크립트로 구현되었으며 사용하는 환경에 맞게 수정해 사용할 수 있습니다.

신규 id 요청

platform, action 요소 항목값을 채우고 신규 id를 요청합니다.

function start()
{
	objNexacro.platform = 'nexacro';
	objNexacro.action = 'create';
	sendData(true, true, createProcess);
}

function sendData(openpost, is_create, resultCallback) 
{
	delete xhrCreateObject;
	xhrCreateObject = null; 
	
	var sendObj = null;
	sendObj = new XMLHttpRequest();
	sendObj.reqType = 1;

	xhrCreateObject = sendObj;
	sendObj.onreadystatechange = resultCallback;
	var jsonData;
	jsonData = JSON.stringify(objNexacro);
	var timestamp = "/" + new Date().getTime();
	var send_url = openurl + ":" + openport + openurl_add + timestamp;
	console.log(send_url);

	sendObj.open("POST", send_url, "true");
	sendObj.send(jsonData);
	console.log(jsonData);	
	return sendObj;
}

function createProcess()
{
	if ( xhrCreateObject.readyState == 4 || xhrCreateObject.reqType == 2)  {
		console.log(xhrCreateObject.responseText);
	}          
}

요청되는 jsonDate 항목은 아래와 같습니다. 요소 항목만 채워서 전송됩니다.

{"platform":"nexacro","action":"create"}

런처 서비스에서 요청을 받고 id를 할당해 반환합니다. id 항목과 result 항목을 확인합니다. id값은 이후 요청 시 활용하게 됩니다.

{"action":"create","id":"1522821857","platform":"nexacro","result":"success"}

필수 속성 설정

예제에서 [property setting(basic)] 버튼 클릭 시 동작하는 기능입니다. 속성 중에서 key, bjson, enginesetupkey 항목값을 채웁니다.

function do_property(test_action, action_sub)
{
	objNexacro.action = 'setproperty';
	objNexacro.value = { "key": "LauncherService", "bjson": "http://127.0.0.1:8080/start.json", "enginesetupkey":enginesetupkey};
	sendData(true, false, resultProcess);
}

넥사크로플랫폼 앱 배포 시 Local 설정으로 배포한 경우에는 start.json 경로를 로컬 주소로 지정해야 합니다. 이런 경우에는 아래와 같이 지정합니다.

function do_property(test_action, action_sub)
{
	objNexacro.action = 'setproperty';
	objNexacro.value = { "key": "LauncherService", "bjson": "D:\\nexacro\\17\\start.json", "enginesetupkey":enginesetupkey};
	sendData(true, false, resultProcess);
}

요청되는 jsonDate 항목은 아래와 같습니다. 이전 단계에서 확인된 id값을 설정하고 key, bjson, enginesetupkey 항목값이 채워져 있습니다.

{"action":"setproperty","id":"1522822903","platform":"nexacro","result":null,"value":{"key":"LauncherService","bjson":"http://127.0.0.1:8080/start.json","enginesetupkey":"{94FAAFF5-0E54-4539-AA67-*******}"}

런처 서비스에서 필수 속성값을 저장하고 성공 여부("result":"success")를 반환합니다.

{"action":"setproperty","id":"1522823068","platform":"nexacro","result":"success","value":{"bjson":"http://127.0.0.1:8080/start.json","enginesetupkey":"{94FAAFF5-0E54-4539-AA67-*******}","key":"LauncherService"}}

메서드 실행

예제에서 [launch] 버튼 클릭 시 동작하는 기능입니다.

function do_method(test_action) {
	objNexacro.action = 'method';
	objNexacro.value = {"launch": null};
	sendData(true, false, resultProcess);
}

이전 단계에서 key, bjson, enginesetupkey 항목값을 전송했고 런처 서비스에서 해당하는 값을 저장하고 있습니다. id값을 키값으로 값을 저장하고 있기 때문에 이후 메서드를 실행하거나 다른 동작을 할때는 id값을 기준으로 동작하게 됩니다.

{"action":"method","id":"1522823068","platform":"nexacro","result":null,"value":{"launch":null}}

런처 서비스에서 메서드를 실행하고 성공 여부("result":"success")를 반환합니다. 정상적으로 메서드가 실행되었다면 운영체제에 설치된 앱이 실행됩니다.

{"action":"method","id":"1522823068","platform":"nexacro","result":"success","value":{"launch":null}}

전체 코드

아래 링크에서 사용 예제 코드를 내려받을 수 있습니다.

localtest_nexacro_sample.html

예제 코드 내에는 아래와 같은 문제 처리 방법이 포함되어 있습니다.

• 인터넷 익스플로러(IE) 8, 9 버전에서 Cross Domain 문제 회피 방법

  XMLHttpRequest.open 메서드 사용 시 액세스를 허용하지 않는다는 에러 메시지가 나올 경우 XMLHttpRequest 객체 대신 XDomainRequest 객체를 사용하면 에러가 발생하지 않습니다.

if (window.XMLHttpRequest) {
	sendObj = new XMLHttpRequest();
	sendObj.reqType = 1;
} else if (window.XDomainRequest) {
	sendObj = new XDomainRequest();
	sendObj.reqType = 2; 
}

• 런처 서비스에서 열려진 포트를 검색한 후 사용하는 방법

  모든 경우에 사용해야 하므로 action이 'create'인 경우에 지속적으로 통신시도를 해 결과값으로 id를 받았을 때 port 번호를 이후 통신에 사용하는 방법입니다.

function http_onerror()
{
	if (objNexacro.action == 'create') {
		if (findport == false) {
			if ( setport > 0) {
				setport = 0;
				openport = parseInt(getCookie("tplsvcopenport"), 10) | 0;
				if (openport > 0) {
					sendData(true, true, createProcess);
					return;
				}
			}
			openport = 7895;
		} else {
			openport++;
		}
		findport = true;
                
		if (openport <= 7935) //신규 런처는 7895 ~ 7935 사이 하나의 port를 open 함; 
			sendData(true, true, createProcess);
		else
			alert("런처 서비스가 설치되지 않았거나 동작이 멈춰있는지 확인 바랍니다.");          
	}     
}