배포단계에서는 개발이 완료된 프로젝트는 사용자가 디바이스에 설치하거나 웹브라우저에서 접속해 사용할 수 있는 형태로 만들 수 있습니다. Packing 단계에서는 배포할 실행 환경을 선택하고 업데이트 형태를 지정하면 필요한 파일을 만듭니다. Build App 단계에서는 Packing 단계에서 생성된 파일을 압축해서 설치 파일을 생성할 수 있습니다.

Deploy 환경 설정하기

메뉴 [Deploy > Settings] 항목을 클릭하면 Deploy 관련 필요한 값을 설정할 수 있습니다. 메뉴 [Tools > Options] 항목 중 Deploy 환경 설정과 관련된 항목만 모아놓았으며 설정하는 값은 같습니다.

Packing 단계에서 아카이브 파일 만들기

배포할 프로젝트를 실행할 환경과 업데이트 형태를 선택합니다. 선택한 환경에 따라 아카이브 파일을 만들 때 포함될 항목을 지정할 수 있습니다.

Packing 위저드 실행하고 아카이브 파일 만들기

성공적으로 아카이브 파일이 만들어졌다면 해당 폴더를 파란색 링크로 표시합니다. 링크를 클릭하면 만들어진 폴더를 띄워줍니다. 왼쪽 하단의 [Build] 버튼을 클릭하면 설치 파일을 만드는 Build App 화면으로 이동합니다. 실행 환경을 Web Browser만 선택한 경우에는 [Build] 버튼이 활성화되지 않습니다.

index.html

Web Browser 실행 환경은 별도의 설치 파일을 만들지 않고 웹브라우저에서 접근할 수 있는 HTML 파일을 만듭니다. _web_ 폴더에 index.html 파일을 포함해 서버에 업로드해야 하는 파일이 생성된 것을 확인할 수 있습니다. _web_ 폴더에 있는 파일을 모두 서버에 업로드하면 웹브라우저에서는 아래와 같이 앱에 접근할 수 있습니다.

http://[도메인 주소]/index.html

실행 환경에 따른 Update Type 선택

실행 환경이 Windows, Android, iOS, macOS인 경우에는 Update Type 항목을 선택할 수 있습니다. 선택한 Update Type 항목에 따라 선택할 수 있는 설정 옵션이 달라지며 생성되는 아카이브 파일이 달라집니다.

Update Type

• Update (Local + Server)

  최초 설치 시 필요한 아카이브 파일을 내려받아 로컬 스토리지에 저장합니다. 콘텐츠 업데이트 시 버전 정보를 변경하면 네트워크에 연결해 필요한 파일을 내려받아 로컬 스토리지에 저장합니다.

• Server

  네트워크에 연결된 상태에서만 실행할 수 있습니다. 필요한 파일을 서버에서 내려받아 사용합니다.

• Local

  아카이브 파일을 포함한 상태로 배포 파일이 생성되며 설치 시 로컬 스토리지에 파일을 설치합니다. 네트워크 연결 없이 앱을 실행할 수 있습니다.

실행 환경, Update Type에 따른 설정 옵션

실행 환경, Update Type에 따라 배포할 대상을 설정할 수 있습니다. 설정 옵션 항목에서 배포할 파일을 선택하거나 추가할 수 있습니다.

Update Info

최신 콘텐츠를 서버에서 받아서 처리하는 업데이트 정책을 지정할 수 있습니다. 콘텐츠를 받아올 경로를 지정하고 일정 횟수 정해진 시간만큼 업데이트를 시도하다가 콘텐츠를 받지 못하면 실패로 처리합니다. 업데이트를 자동으로 처리할지 사용자 요청 시 처리할지도 지정할 수 있습니다.

실행 환경, Update Type 별 설정 옵션 여부

설정 옵션

Resource Setting 항목 오른쪽에 있는 [Update Info] 항목을 클릭하고 내용을 편집합니다.

Setup

Build App 위저드를 사용하지 않고 넥사크로플랫폼 기본 Setup을 배포할 수 있습니다. 부트스트랩 파일과 리소스 파일만 생성하며 부트스트랩 정보에 Setup 업데이트 정보가 추가됩니다.

실행 환경, Update Type 별 설정 옵션 여부

설정 옵션

배포할 운영체제 타입을 선택합니다. 선택한 항목에 대한 정보는 부트스트랩 파일(start.json)에 추가됩니다.

Module

넥사크로플랫폼 앱을 실행하는 데 필요한 프레임워크(nexacro17lib) 배포 여부를 설정할 수 있습니다. 실행 환경이 Windows라면 외부 모듈이나 UWP API 앱 실행을 위한 모듈을 추가할 수 있습니다.

실행 환경, Update Type 별 설정 옵션 여부

설정 옵션

배포할 모듈 파일을 추가하거나 변경, 삭제할 수 있습니다. 실행 환경에 따라 설정 옵션 중 일부만 제공될 수 있습니다.

설정 옵션 (Update Type이 Local인 경우)

프레임워크 파일(nexacro17lib.zip)이 기본 설정되어 있으며 삭제하거나 변경할 수 없습니다. 설정 옵션 항목은 Type, Name 두 가지 값만 표시합니다.

설정 옵션 (실행 환경이 Windows인 경우)

확장 모듈, UWP, 파일을 추가하는 기능을 사용할 수 있습니다. 실행 환경이 Android, iOS, macOS인 경우에는 프레임워크 파일 외 다른 모듈 파일을 배포할 수 없습니다.

설정 옵션 (실행 환경이 Web Browser 또는 Update Type이 Server인 경우)

프레임워크 파일을 압축된 파일 형태로 내려받지 않고 Web Browser에서 실행되는 파일 형태로 배포합니다.

Source

프로젝트 파일 중에서 배포할 대상을 선택합니다. 최초 배포 시에는 전체 프로젝트를 선택해야 하며 업데이트 시에는 필요한 대상만 선택하고 배포할 수 있습니다. 실행 환경과 Update Type에 따라 파일을 직접 배포하거나 압축된 아카이브 파일 형태로 배포합니다.

실행 환경, Update Type 별 설정 옵션 여부

설정 옵션

Project Files 항목에서 배포 대상 파일을 선택합니다. Archives 항목이 있는 경우에는 소스 파일을 담을 아카이브 파일을 선택한 후에 Project Files 항목에서 배포 대상을 선택할 수 있습니다.

설정 옵션 (실행 환경이 Web Browser 또는 Update Type이 Server인 경우)

아카이브 파일을 만들지 않고 Project Files에서 선택한 항목만 배포합니다. 설정 옵션에서 Archives 항목이 표시되지 않습니다.

설정 옵션 (Update Type이 Local인 경우)

설정 옵션 항목은 Rearchive, Name 두 가지 값만 표시합니다.

Resource

리소스 파일 중에서 배포할 대상을 선택합니다. 최초 배포 시에는 전체 리소스를 선택해야 하며 업데이트 시에는 필요한 대상만 선택하고 배포할 수 있습니다. 실행 환경과 Update Type에 따라 파일을 직접 배포하거나 압축된 아카이브 파일 형태로 배포합니다.

실행 환경, Update Type 별 설정 옵션 여부

설정 옵션

Resource Files 항목에서 배포 대상을 선택합니다. Archives 항목이 있는 경우에는 Resource.zip 하나의 파일만 만들 수 있습니다.

설정 옵션 (실행 환경이 Web Browser 또는 Update Type이 Server인 경우)

아카이브 파일을 만들지 않고 Resource Files에서 선택한 항목만 배포합니다. 설정 옵션에서 Archives 항목이 표시되지 않습니다.

설정 옵션 (Update Type이 Local인 경우)

설정 옵션 항목은 Name만 표시합니다.

Build App 단계에서 설치 파일 만들기

Packing 단계에서 생성한 아카이브 파일 중에서 설치 시 필요한 파일을 포함해 설치 파일을 만들 수 있습니다. 배포할 운영체제에 따라 옵션을 지정할 수 있습니다.

Build App 위저드 실행하고 설치 파일 만들기

Packing 단계에서 [Build] 버튼을 클릭한 경우에는 속성 설정화면으로 넘어가고 Build App 메뉴로 접근한 경우에는 Build Target 선택 후 설정 화면으로 이동합니다.

기본 Engine Setup Key를 그대로 사용하거나 입력칸 오른쪽에 있는 열쇠 모양의 버튼을 클릭하면 Engine Setup Key를 새로 생성할 수 있습니다. 사용자 PC에 여러 개의 앱이 설치되어야 하는 경우에는 Engine Setup Key를 새로 생성하고 따로 관리하는 것을 권장합니다.

아이콘, 이미지 파일

운영체제에 따라 지정된 형식에 맞는 파일을 지정해주어야 합니다. 사용할 수 있는 파일에 대한 정보는 아래 링크를 참고하세요.

Icon이나 Splash Image 등 이미지 파일을 포함하고 있는 경우에 눈 모양 아이콘 클릭 시 이미지 미리보기 기능을 제공합니다. zip 파일로 여러 이미지 파일을 묶은 경우 오른쪽 아래 [>] 버튼을 클릭해 다음 이미지를 확인할 수 있습니다.

설치 파일 생성이 완료되면 생성된 파일을 확인할 수 있습니다. 운영체제 또는 파일에 따라 QR 코드가 지원되는 경우에는 산출물 선택 시 QR 코드 이미지가 표시되며 그렇지 않으면 산출물 URL만 제공합니다. 빌드 실패 시에는 빨간색으로 표시되며 표시합니다.

AppBuilder 실행 시 추가 옵션 처리하기

AppBuilder에서 앱 빌드 작업을 실행하려면 앱빌더 프로젝트를 생성하고 프로젝트 옵션을 지정해주어야 합니다. 프로젝트를 생성하고 옵션을 지정하는 작업은 AppBuilder 콘솔에서 처리할 수 있습니다. 그 중에서 앱빌더 프로젝트를 생성하거나 프레임워크 라이브러리를 변경하고 사용자 라이브러리를 등록하고 권한을 지정하는 작업은 Build App 위저드에서 처리할 수 있습니다.

TargetProject (앱빌더 프로젝트) 생성하기

Setting > Build Environment > Target Project

앱빌더를 사용하기 위해서는 앱빌더 프로젝트를 생성해주어야 합니다. 이미 생성된 프로젝트가 있다면 해당 프로젝트를 선택해서 사용할 수 있습니다. 프로젝트가 없는 경우에는 [+] 버튼을 클릭해 프로젝트를 생성합니다.

Build Library를 신규로 등록하거나 변경하기

Setting > Build Environment > Build Library

넥사크로 플랫폼 프레임워크 라이브러리와 운영체제별 라이브러리를 관리합니다. 기존에 등록된 항목을 선택하거나 변경할 수 있으며 신규로 라이브러리 파일을 등록할 수 있습니다.

서버에 등록된 라이브러리 대신 local library 항목을 지정한 경우에는 PC에 설치된 라이브러리 파일을 사용합니다.

local libray 항목은 제품 설치 버전으로 기본 설정됩니다. 기본으로 설정된 라이브러리 파일 목록은 SetupRuntime.json 파일에서 확인할 수 있습니다.

기본 설정된 라이브러리 파일은 사용자가 변경할 수 있습니다. 변경된 내용은 제품 업데이트 전에는 유지되며 제품 업데이트 시 SetupRuntime.json 파일이 변경되면 해당 버전에 맞게 초기화됩니다.

• 안드로이드 라이브러리는 Android, AndroidX 중에 선택할 수 있습니다.

• 프레임워크 라이브러리와 다른 버전의 파일을 선택할 수 있습니다. 파일 버전이 다른 경우에는 빨간색으로 항목을 표시합니다.

Singning 신규로 등록하거나 변경하기

Setting > Android, iOS, macOS > Advanced > Signing

Signing 파일을 등록하거나 생성(Android의 경우)하고 등록된 내용을 확인할 수 있습니다.

Android

iOS/macOS

User Library를 신규로 등록하거나 변경하기

Setting > Android, iOS > Advanced > User Library

운영체제별 사용자 라이브러리를 관리합니다. 기존에 등록된 항목을 선택하거나 변경할 수 있으며 신규로 사용자 라이브러리 파일을 등록할 수 있습니다.

프로젝트 빌드 시 적용할 사용자 라이브러리를 선택해 적용할 수 있습니다.

Permission 지정하기

Setting > Android > Advanced > Permission

안드로이드 운영체제에서 필요한 권한을 지정할 수 있습니다.

AppBuilder 빌드 실패 시 로그 정보 확인하기

AppBuilder에서 빌드 처리 중 실패한 경우 로그 파일을 확인할 수 있습니다. 빌드 실패 시 설치 파일 링크 대신 로그 파일을 확인할 수 있는 링크를 제공합니다.

로그 파일에서는 에러코드와 빌드 실패 시 생성된 로그 정보를 확인할 수 있습니다.

이전 설정 그대로 빠르게 Build 하기

프로젝트의 Build 이력이 있는 경우에는 Quick Build 기능을 사용할 수 있습니다. Build 이력이 있는 경우에는 메뉴 [Deploy > Quick Build] 항목이 활성화됩니다.

Quick Build Wizard에서는 Build를 진행한 운영체제별 목록을 확인하고 앱을 내려받거나 수정된 Resource 파일의 Version 정보를 수정하고 Build를 진행할 수 있습니다.

[Build] 버튼 클릭 시 Update Type에 따라 아래와 같이 동작합니다.

UWP API 앱 만들고 실행하기

윈도우 10 이상 운영체제에서 유니버설 윈도우 플랫폼(UWP, Universal Windows Platform) API를 사용하는 앱을 생성하고 배포할 수 있습니다. DeviceAPI 중에서 Camera, Network, Geolocation 오브젝트 중 일부 기능을 지원합니다.

Packing > Module

Module 설정 시 "UWP (Windows10 Device Agent)" 항목을 추가합니다.

nexacro17_UWP.appxbundle 파일 배포

nexacro17_UWP.appxbundle 파일은 설치 파일에 포함되지 않으며 Packing 단계에서 생성되지 않습니다. 해당 파일은 BootStrap URL 위치에 직접 복사해주어야 합니다. 사용자가 설치된 앱 실행 시 자동으로 nexacroUWP가 설치됩니다.

UWP API 앱 실행

Network나 Geolocation 오브젝트를 사용하는 경우에는 기존 앱과 다르지 않습니다. 다만 Camera 오브젝트에서 takePicture 메소드처럼 디바이스의 장비를 직접 실행하는 경우에는 아래와 같이 백그라운드 앱이 실행됩니다.

간단하게 윈도우 10 운영체제에 설치된 카메라를 실행하고 캡쳐한 이미지를 ImageViewer 컴포넌트에 보여주는 예제입니다.

this.Button00_onclick = function(obj:nexacro.Button,e:nexacro.ClickEventInfo)
{
	this.Camera00.takePicture();
};

this.Camera00_oncapture = function(obj:nexacro.Camera,e:nexacro.CameraEventInfo)
{
	trace('camera capture ok: '+e.url);
	this.ImageViewer00.set_image("file://"+e.url);
};

this.Camera00_onerror = function(obj:nexacro.Camera,e:nexacro.CameraErrorEventInfo)
{
	trace('camera error: '+e.errormsg);
};