넥사크로플랫폼에서 프로젝트를 실행하기 위해서는 프로젝트를 실행 가능한 형태의 파일로 변환하는 작업이 필요합니다. 그리고 변환된 프로젝트를 테스트하기 위해 원하는 환경에 따라 실행 모드를 선택하고 테스트를 진행합니다. 이번 장에서는 프로젝트 빌드와 실행에 대해 살펴봅니다.

프로젝트 제너레이트

제너레이트 (Generate)

넥사크로 스튜디오에서 편집한 파일은 실행하기 위해 자바스크립트 파일로 변환하는 과정이 필요합니다. 이 동작을 Generate라고 합니다.

Generate Application

Generate 동작을 Application 단위로 실행합니다.

리본 메뉴 [HOME > Generate > Application] 또는 메뉴 [Generate > Application]을 선택해 실행할 수 있습니다.

Generate Theme

Generate 동작을 테마 단위로 실행합니다.

리본 메뉴 [HOME > Generate > Theme] 또는 메뉴 [Generate > Theme]을 선택해 실행할 수 있습니다.

Generate Service

Generate 동작을 서비스 단위로 실행합니다.

리본 메뉴 [HOME > Generate > Service] 또는 메뉴 [Generate > Service]을 선택해 실행할 수 있습니다.

Generate File

Generate 동작을 활성화된 뷰 또는 Project Explorer에서 선택된 파일 단위로 실행합니다.

활성화된 뷰가 있는 경우에는 리본 메뉴 [HOME > Generate > File] 또는 메뉴 [Generate > File]을 선택해 실행할 수 있습니다. 활성화된 뷰가 없는 경우에는 해당 메뉴가 비활성화됩니다.

Project Explorer에서 원하는 파일을 선택하고 컨텍스트 메뉴에서 [Generate File] 항목을 선택하면 Generate 기능을 실행합니다.

Regenerate

Generate 기능은 생성할 파일이 출력경로에 이미 존재하고 변경되지 않았을 경우 해당 파일은 변환 작업 시 다시 생성하지 않습니다. Regenerate 기능은 중복 파일 유무와 상관없이 대상 파일 전체를 변환합니다. 메뉴 [Generate > Regenerate]를 선택해 수행합니다.

자동 Generate

넥사크로 스튜디오에서 프로젝트를 불러오고 편집하는 경우 Generate 된 프로젝트 파일이 필요합니다. 아래와 같은 동작을 수행할 때마다 자동으로 Generator가 동작하며 필요한 파일에 대한 Generate 기능을 실행합니다.

• 프로젝트 로드

• 파일 생성

• 파일 수정 후 저장

• Deploy 수행 전

• QuickView 수행 전

프로젝트 실행

넥사크로 스튜디오에서 편집한 결과물을 넥사크로플랫폼에서 실행할 수 있습니다. 프로젝트 실행은 앱을 실행하는 Launch 기능과 Form만 실행하는 QuickView 기능으로 나뉩니다.

실행 모드

리본 메뉴 [HOME - Launch] 또는 툴바에서 Browser Combo 항목을 선택하여 실행 모드를 설정할 수 있습니다.

NRE(Nexacro Runtime Environment)

32비트 또는 64비트 넥사크로 런타임 실행환경(NRE)으로 실행합니다. nexacro.exe 파일을 통해 실행되며 웹서버 없이 생성된 파일에 직접 접근하여 앱을 실행할 수 있습니다.

Emulator

디바이스나 스크린 설정에 따라 실행되는 모습을 미리 볼 수 있는 에뮬레이터 도구를 지원합니다. 편집 중인 화면을 디바이스, 스크린 설정에 따라 실시간으로 바꿔가며 실행 결과를 확인할 수 있습니다.

웹브라우저

웹브라우저에서 앱을 실행할 수 있습니다. 사용자 디바이스에 설치된 웹브라우저에서 앱을 실행합니다. 모바일 디바이스를 사용하는 경우에는 URL을 직접 입력해 실행할 수 있습니다.

Launch

넥사크로플랫폼 앱을 실행하는 기능입니다. ScreenDefinition을 먼저 설정하고 실행모드를 선택합니다.

리본 메뉴 [HOME - Launch - Launch] 또는 메뉴 [Generate > Launch]로 실행할 수 있습니다. 웹 브라우저로 실행할 경우 URL을 입력하는 창이 팝업되고 입력한 URL을 선택한 웹 브라우저에서 실행합니다. 로컬 웹 서버를 사용하는 경우에는 메뉴 [Tools > Options > Project > Launch] 항목에서 지정한 "Server Host Url"이 URL로 지정됩니다.

메뉴 [Tools > Options > Project > Launch] 항목에서 "Web Server"를 선택한 경우 URL 값이 입력되어 있지 않으며 [Run Configuration] 창 표시 여부가 체크되어 있지 않으면 아래와 같이 URL 값을 입력하는 창이 표시됩니다.

QuickView

활성화된 뷰가 Form 편집 뷰일 경우 QuickView를 실행할 수 있습니다. 또는, Project Explorer가 활성화된 상태에서 선택된 트리 아이템이 Form 파일일 경우에도 QuickView를 실행할 수 있습니다.

QuickView는 리본 메뉴 [HOME - Launch - QuickView] 또는 메뉴 [Generate > QuickView]로 실행할 수 있습니다.

부트스트랩 템플릿 관리하기

자동으로 생성되는 부트스트랩 HTML 파일을 사용자가 필요한 코드를 추가한 템플릿을 적용해 생성할 수 있습니다. 메뉴[Generate > Bootstrap Customize] 항목을 선택하고 템플릿 콘텐츠를 편집하면 자동으로 생성되는 부트스트랩 파일에 반영됩니다.

부트스트랩 템플릿에서는 아래 5개 파일을 관리할 수 있습니다.

Bootstrap Customize의 기본 기능은 아래와 같습니다.

스크립트 코드 추가한 템플릿 만들기

URL 파라미터를 사용해 특정한 언어 코드를 입력받는 기능을 구현하려 한다면 아래와 같이 템플릿에 코드를 추가할 수 있습니다.

nexacro._lang = urlParams.lang;

부트스트랩 템플릿 편집 시 주의 사항

키워드 수정 또는 삭제

키워드 항목을 수정하거나 삭제하는 것은 권장하지 않습니다. 키워드를 수정하거나 삭제하는 경우 부트스트랩 편집창에 아래와 같이 경고 메시지가 표시됩니다. 아래 그림에서는 #{FRAMEWORK_LIBRARY} 항목을 #{FRAMEWOR_LIBRARY}으로 수정했습니다.

경고 메시지가 표시되어도 저장 후 반영할 수 있습니다. [OK] 버튼 클릭 시 한 번 더 반영 여부를 확인합니다.

생성된 코드를 실행하면 프레임워크 라이브러리를 정상적으로 호출하지 못하고 오류로 처리됩니다.

기본 스크립트 수정

nexacro._initHTMLSysEvent이나 nexacro._loadADL와 같은 함수는 넥사크로 프레임워크 내부에 지정된 함수를 호출하는 부분이기 때문에 삭제하거나 위치를 변경할 경우 앱 실행에 영향을 미칠 수 있습니다. 앱 실행에 영향을 주지 않는 범위에서 수정할 수 있습니다.

참고 사항

부트스트랩 템플릿 설정 파일 경로

부트스트랩 템플릿을 설정한 경우에는 프로젝트 경로에 설정 파일이 생성됩니다. 부트스트랩 템플릿 파일을 공유하려면 설정 파일과 프로젝트 파일(XPRJ)에 해당 설정 파일을 지정한 태그가 추가되어야 합니다.

[project path]\bootstrap.xml

프로젝트 파일(XPRJ)에는 아래와 같이 태그가 추가됩니다.

<?xml version="1.0" encoding="utf-8"?>
<Project version="2.1">
...
  <BootstrapCustomize url="bootstrap.xml"/>
</Project>

키워드 목록