사용자 환경에서 앱이 예상치 못하게 종료되거나 실행중 발생하는 오류나 현상을 분석하기 위해 로그 파일을 생성하고 문제를 확인할 수 있습니다.

로그 파일 생성 설정하기

로그 파일을 생성하는 기능은 기본 설정이 아니며 추가 설정이 필요합니다. 로그 파일 생성 설정은 넥사크로 스튜디오에서 설정할 수도 있고 config 파일을 설정하는 방법이 있습니다.

앱 실행 시에는 config 파일에 설정한 내용을 우선적으로 적용합니다. config 파일이 있는 경우에는 Environment 항목에서 설정한 값은 무시합니다.

Environment 항목에서 로그 파일 생성 설정하기

넥사크로 스튜디오에서 속성값을 설정하고 로그 기능을 설정할 수 있습니다. 관련 속성값은 넥사크로 스튜디오에서만 설정할 수 있으며 앱 실행중에는 변경할 수 없습니다.

tracemode 속성에서 로그 파일 생성 설정하기

넥사크로 스튜디오에서 Environment 항목을 선택하고 tracemode를 변경합니다. 기본값 "none"인 경우에는 로그 기능을 처리하지 않으며 속성값을 "new" 또는 "append"로 설정하면 로그 파일을 생성합니다.

로그 작성 수준과 주기 설정하기

넥사크로 스튜디오에서 Environment 항목을 선택하고 loglevel, traceduration 속성을 설정할 수 있습니다. loglevel 속성은 로그의 어떤 상황에서 로그를 기록할 것인지를 설정하고 traceduration 속성은 로그 파일 생성 주기를 설정합니다.

config 파일 설정하기

config 파일에서 로그 기능을 설정할 수 있습니다. Environment 속성은 수정하지 않고 config 파일을 사용자 실행 환경에 복사해 넣거나 빌드 시 포함해서 설정할 수 있습니다.

-NC 옵션 설정하기

윈도우 운영체제에서 nexacro.exe 파일을 실행할 때 "-NC" 옵션을 사용할 수 있습니다. 실행할 nexacro.exe 파일과 같은 위치에 있는 config 파일을 설정할 수 있습니다.

예를 들어 nexacro.exe 파일의 위치가 아래와 같은 경고 -NC 옵션값으로 "log_config.xml" 파일을 지정했다면 같은 위치에 "log_config.xml" 파일이 있어야 합니다.

C:\Program Files\nexacro\17.1\TEST_LOG\nexacro.exe
C:\Program Files\nexacro\17.1\TEST_LOG\log_config.xml

-NC 옵션을 사용하지 않는 경우에는 기본 경로에 있는 nexacro_config.xml 파일을 찾고 해당 파일이 있는 경우 참조합니다.

nexacro_config.xml 파일 설정하기

-NC 옵션 설정하기는 파일명을 지정할 수 있지만 별도 옵션을 지정해주어야 합니다. nexacro_config.xml 파일은 지정한 위치에 정해진 이름을 가진 파일을 가져다놓으면 자동으로 앱 실행 시 이를 인식하고 처리합니다.

윈도우 운영체제

윈도우 운영체제에서는 nexacro_config.xml 파일을 포함해 앱을 배포하는 기능을 포함하지 않습니다. 아래 경로에 nexacro_config.xml 파일을 생성하고 앱 실행 시 참조할 수 있습니다.

%USERAPP%\Config\[Key]\nexacro_config.xml

안드로이드, macOS 운영체제

안드로이드 스튜디오 또는 에서 프로젝트 빌드 시 nexacro_config.xml 파일을 설정할 수 있습니다. 아래 내용을 참고하세요.

앱 개발 및 실행 (안드로이드) > Config 설정
앱 개발 및 실행 (iOS/iPadOS) > Config 설정

nexacro_config.xml 파일 속성

설정 파일(nexacro_config.xml) 파일 또는 -NC 옵션으로 지정하는 파일은 아래와 같은 형식으로 작성합니다.

<?xml version="1.0" encoding="UTF-8"?>
<nexacro-config os="windows">
	<application
		file-logging="true"
		loglevel="debug"
		tracemode="new"
		traceduration="-1"/>
	<log
		filepath="%USERAPP%\Log\nre_log_test.log"
		filesize="408960"
		backupfilecount="5"/>
</nexacro-config>

nexacro_config.xml 파일에 지정하는 속성 중 로그 파일 생성과 관련된 속성만 아래에 설명합니다.

속성별 파일 생성 예시

backupfilecount

생성된 로그파일 크기가 filesize 속성값보다 커지면 백업파일을 추가로 생성합니다.

파일명 뒤에 번호를 붙여서 파일을 생성합니다. backupfilecount 속성으로 지정한 값에 도달하게 되면 처음 생성한 파일을 지우고 다시 로그를 기록합니다.

1시간마다 앱이 실행되고 앱 실행 시 300KB 로그를 기록한다면 로그 파일은 아래와 같이 생성됩니다.

<log filepath="%USERAPP%nrelog.log" filesize="200" backupfilecount="3"/>

traceduration

로그 파일이 생성되는 날짜 기준으로 traceduration 속성값보다 이전에 생성된 파일은 삭제합니다.

파일명 뒤에 날짜("_yyyymmdd")를 붙여서 파일을 생성합니다. 날짜 비교는 운영체제 시스템 시간을 기준으로 처리합니다.

하루에 한 번 앱이 실행되고 주말에는 실행하지 않는다면 로그 파일은 아래와 같이 생성되고 삭제됩니다. 주말(토요일, 일요일)에는 앱이 실행되지 않으므로 기존에 생성된 로그 파일이 삭제되지 않으며 월요일에 앱이 실행되면서 traceduration 속성값 이전 로그 파일을 삭제합니다.

<nexacro-config os="windows">
	<application file-logging="true" quiet="false" loglevel="debug" tracemode="new" traceduration="2"/>
	<log filepath="%USERAPP%nrelog.log" filesize="408960" backupfilecount="3"/>
</nexacro-config>

로그 파일 읽기

해당 운영체제 파일 탐색 프로그램을 사용해 로그 파일을 확인할 수 있습니다.

앱 내에서 로그 파일을 확인하는 기능을 구현하려면 로그 파일이 저장된 경로를 가져와서 VirtualFile 오브젝트를 사용해 파일 내용을 읽을 수 있습니다.

로그 파일 읽기 스크립트 예제

Button 클릭 시 해당 경로에 저장된 첫 번째 파일을 가져와 TextArea 컴포넌트에 표시하는 예제입니다.

this.Button01_onclick = function(obj:Button,  e:nexacro.ClickEventInfo)
{
	var strLogpath = nexacro.getLogFilePath();
    this.VirtualFile00.getFileList( strLogpath, ".log", VirtualFile.findFileOnly );
}

this.VirtualFile00_onsuccess = function(obj:VirtualFile, e:nexacro.VirtualFileEventInfo)
{
	switch (e.reason)
	{
		case 1:	// open
			this.VirtualFile00.read();
			break;					
		case 3:	// read
			this.TextArea00.set_value(e.textdata);
			break;
		case 8:	// getFileList
			var logfilename = logpath + e.fileattributelist[0].filename;
			this.VirtualFile00.open(logfilename,  VirtualFile.openText);
			break;
	}
}

윈도우 운영체제 실행 시 제약

윈도우 운영체제에서 로그 파일에 접근하려면 Environment filesecurelevel 속성값을 "all"로 지정해주어야 하며 최초 실행 시 샌드박스 창이 표시됩니다.

안드로이드 운영체제 실행 시 제약

안드로이드 운영체제에서 로그 파일에 접근하려면 파일접근권한을 설정해주어야 합니다.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
...
<provider			
    android:name="android.support.v4.content.FileProvider"			
    android:authorities="nexacro.launcher.fileprovider"			
    android:exported="false"			
    android:grantUriPermissions="true">			
    <meta-data			
        android:name="android.support.FILE_PROVIDER_PATHS"			
        android:resource="@xml/file_paths"/>			
</provider>

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-cache-path name="cache" path="."/>
    <external-files-path name="files" path="./"/>
</paths>